VS Code가 뭔가요?

VS Code(Visual Studio Code)는 내 컴퓨터의 파일을 열고 작업하는 프로그램입니다. 여기에 AI와 여러 도구를 연결하면, 연구 자료를 보면서 AI에 일을 부탁하고 결과까지 한곳에서 확인할 수 있습니다.

운동장을 하나 마련한다고 생각해 보세요

VS Code는 운동장입니다. 이 운동장에 Claude라는 친구를 불러 함께 활동할 수 있습니다. 농구공을 주면 농구를 하고, 축구공을 주면 축구를 하듯, 어떤 자료와 도구를 준비하고 무슨 일을 부탁하느냐에 따라 하는 일이 달라집니다.

연구에서는 이렇게 활용합니다

연구계획서를 주고 “이 연구의 설계를 검토해 주세요.”
데이터와 분석 도구를 준비하고 “대상자 특성을 표로 정리해 주세요.”
계획서와 분석 결과를 주고 “논문 작성 계획을 제안해 주세요.”

연구자는 할 일을 정하고 결과를 검토합니다. AI는 그 요청에 맞춰 작업합니다.

이제 운동장을 준비해 봅시다

VS Code를 설치하고, AI와 도구를 연결한 뒤, 연구 자료를 담을 폴더를 준비합니다. 그 폴더가 우리 연구실의 작업공간입니다. Basic을 하지 않았어도 처음부터 따라올 수 있습니다.

설치 → 연구실 → 프로젝트 → 실제 연구

VS Code와 도구를 설치하고 연구팀 폴더를 엽니다. 대시보드와 프로젝트를 준비한 뒤 분석·집필을 진행합니다. 마지막에는 터미널과 여러 프로젝트 운영을 배웁니다.

계정도 미리 확인하세요

이 안내는 Claude를 기준으로 진행합니다. Claude 계정을 준비하고, 로그인 후 Claude Code 이용 조건과 한도를 확인하세요. Claude 계정 안내 ↗

Basic을 이미 마쳤다면

기존 research-team 폴더와 연구 파일을 그대로 사용합니다. 설치한 도구는 확인만 하고 넘어가세요. 연구팀을 다시 내려받아 기존 폴더 위에 덮어쓰지 않습니다.

이미 설치되어 있다면 기존 앱을 실행하세요

영상에서는 설치 파일을 열고 Visual Studio Code를 Applications(응용 프로그램)로 끌어 놓습니다. 같은 앱이 있다는 안내가 나오면 중단을 선택합니다. 처음 설치하는 분은 복사를 마친 뒤 응용 프로그램에서 Visual Studio Code를 실행하세요. 영상은 복사 안내까지 보여주며, 실행된 VS Code 화면은 03단계에서 볼 수 있습니다.

R 자체는 다음 단계에서 따로 설치합니다

R Extension Pack만 설치하면 R 계산을 실행할 수는 없습니다. Office Viewer에서 열리지 않는 문서는 Word·Excel 등 해당 문서 앱에서 확인해도 됩니다.

영상에 없는 두 항목도 설치하세요

기존 영상에는 Claude Code, Codex, Python, 개별 R 확장 기능, Office Viewer가 나옵니다. Codex 설치 부분은 건너뛰세요. R Extension Pack과 Live Server는 위 설치 목록에서 추가로 설치하세요. 개별 R 확장과 R Extension Pack은 같은 항목이 아닙니다. Python 확장 기능을 설치했더라도 04단계에서 Python 본체 실행을 확인합니다.

이 단계에서는 대화창만 엽니다

왼쪽 Claude 아이콘을 눌러 대화창을 열고 로그인합니다. 기존 영상에는 Codex를 여는 장면도 포함되어 있지만, 이 안내에서는 Claude 부분만 따라 하세요. Codex 설치와 로그인은 필요하지 않습니다. 연구팀 폴더는 05단계에서 준비합니다.

2. R 설치하기

R 공식 다운로드 ↗
Windows: Download R for Windows → base에서 설치 파일을 받습니다.
Mac: Download R for macOS에서 내 Mac 종류(Apple silicon / Intel)에 맞는 설치 파일을 받습니다. 설치 후 R을 열어 1 + 1의 결과가 2인지 확인하세요.

3. VS Code의 Claude에서 실제 실행 확인하기

설치를 마쳤다면 VS Code를 다시 열고 Claude 대화창에 아래 요청을 붙여 넣으세요. 별도로 check.R 파일을 만들 필요는 없습니다. 영상에서는 이미 research-team 폴더를 열어 둔 상태지만, 이 단계에서는 Python과 R의 실행만 확인합니다. 연구팀 폴더는 다음 단계에서 준비합니다.

결과는 컴퓨터마다 다릅니다

영상의 버전이나 설치 위치와 같을 필요는 없습니다. Python은 2 + 3 = 5, R은 1 + 1 = 2처럼 실제 계산이 되는지 확인하세요. 분석에 필요한 추가 도구는 연구 작업에 맞춰 준비합니다. 영상 속 프로젝트 생성 제안은 지금 실행하지 않고 다음 단계로 이동합니다.

연구팀 설치 파일에 담긴 것

AI가 읽을 공통 지침, 연구원 역할과 연구 스킬, 대시보드 도구, sample 계획서·데이터가 들어 있습니다. 이 파일들을 함께 둔 research-team 폴더가 연구실의 작업공간이 됩니다.

연구팀 폴더를 연 뒤 확인하는 과정입니다

영상에서는 research-team 폴더를 열고 계획서를 확인한 뒤 Claude와 Codex를 함께 띄웁니다. 이 안내에서는 Claude만 사용하며, Codex를 여는 부분은 건너뛰세요. 이어 Claude에 “이 작업폴더에 대해 검토하세요”라고 요청합니다. 검토 결과는 영상 속 폴더에 대한 예시이며, 실제 결과는 내려받은 설치 파일과 컴퓨터 환경에 따라 달라질 수 있습니다.

어느 폴더에서 대화하느냐에 따라 맡는 일이 달라집니다

research-team 폴더에서 연 대화 = 총괄팀장
연구실을 준비하고, 프로젝트별 기록을 읽어 전체 현황을 정리합니다.

projects/project01 폴더에서 연 대화 = 해당 연구팀의 팀장
그 연구의 계획서·자료·결과를 바탕으로 작업을 진행합니다. 다른 연구는 다른 프로젝트 폴더에서 대화합니다.

대화끼리 기억이 자동으로 공유되지는 않습니다. 각 팀이 진행 기록을 남기고, 총괄은 그 기록을 읽어 상태를 파악합니다.

다음 날에도 같은 연구를 이어가려면

작업을 마칠 때 “오늘 한 일과 결정, 다음 할 일을 기록해줘”라고 요청하세요. 다음에는 같은 프로젝트 폴더를 열고 “지난 기록을 읽고 이어가자”라고 말하면 됩니다.

여러 연구를 한다고 반드시 Advanced로 바꿀 필요는 없습니다. Basic과 Advanced는 사용하는 방법의 차이입니다.

START_HERE.md는 사용자가 새로 쓰지 않습니다

연구실 공통 준비는 한 번 합니다. 프로젝트에는 공통 연구팀을 참조하는 지침과 시작 안내·진행 기록을 마련합니다. AI가 생성·연결 결과를 확인하고 준비 완료를 보고한 뒤 다음 단계로 갑니다.

본인 프로젝트도 같은 방식으로 준비합니다

research-team 창에서 projects 아래 본인 연구 이름의 폴더와 공통 팀 연결을 준비하도록 요청합니다. 가지고 있는 자료를 그 폴더에 넣고 연결 확인을 마친 뒤, 새 VS Code 창에서 그 프로젝트 폴더를 엽니다. 프로젝트마다 원하는 작업부터 시작할 수 있습니다.

왜 CLI를 추가로 설치하나요?

CLI는 Claude를 명령으로 실행하는 도구입니다. 대화창에 직접 요청하는 것뿐 아니라, 다른 프로그램이 Claude를 불러 작업을 맡기고 결과를 받는 데 사용할 수 있습니다.

백그라운드 작업과 자동화로 확장하기

예를 들어 문헌 담당에게 요약을 맡기고, 그 결과를 검토 담당에게 전달한 뒤 보고서로 모으는 흐름을 구성할 수 있습니다. CLI는 이런 작업을 연결하는 실행 통로가 됩니다.

정해진 시각에 현황 정리나 대시보드 갱신을 요청하는 작업에도 활용할 수 있습니다. 예약 실행과 결과 전달 방식은 별도로 설정해야 하며, 컴퓨터와 필요한 실행 환경이 켜져 있어야 합니다.

앞의 1–10단계에도 별도 CLI가 필요한가요?

이 안내의 1–10단계는 VS Code의 Claude 확장 기능으로 진행합니다. 확장 기능에는 자체 실행 도구가 포함되어 있고 하위 에이전트도 사용할 수 있습니다. 터미널에서 claude 명령을 직접 실행하거나 외부 자동화와 연결하려면 CLI를 별도로 설치합니다.

설치만 하면 에이전트들이 자동으로 소통하나요?

CLI 설치만으로 서로 다른 대화창의 기억이 공유되거나 연구팀이 자동으로 일을 주고받지는 않습니다. 누가 어떤 일을 맡고, 어느 결과를 다음 담당에게 전달할지 정해야 합니다. 우리 연구실에서는 프로젝트 지침과 진행 기록을 읽어 작업을 이어갑니다.

이 단계에서는 CLI 설치와 실행을 확인합니다. 정기 실행이나 에이전트 간 자동 전달까지 설정하는 단계는 아닙니다.

공식 설명: VS Code 확장 기능과 CLI · 명령으로 Claude 실행하기

Claude Code CLI 설치

공식 설치 안내 ↗
Windows PowerShell: irm https://claude.ai/install.ps1 | iex
Mac: curl -fsSL https://claude.ai/install.sh | bash
공식 설치 프로그램을 내려받아 실행하는 명령입니다. 해당 운영체제의 터미널에 입력합니다.

창마다 맡는 연구를 구분하세요

서로 다른 프로젝트는 별도 창에서 진행합니다. 같은 프로젝트를 여러 창에서 검토할 때는 작성 담당과 검토 담당을 나누고, 같은 파일을 동시에 수정하지 않게 요청하세요. 총괄은 프로젝트에 남긴 기록을 읽어 현황을 정리합니다.