GET READY / 설치 안내
내 컴퓨터에
AI 작업실 만들기
VS Code는 파일을 펼쳐 놓는 작업실입니다.
Claude Code는 그 작업실에서 설명을 듣고 파일을 만드는 동료입니다.
VS Code 설치하기
공식 다운로드 페이지에서 내 운영체제에 맞는 설치 파일을 받습니다. 이름이 비슷한 Visual Studio Code(VS Code)를 선택하세요.
- VS Code 공식 다운로드 ↗를 엽니다.
- Windows라면 일반적으로 User Installer로 설치합니다. Mac은 칩에 맞는 버전을 선택합니다.
- 설치가 끝나면 VS Code를 실행합니다.
Claude Code 설치·로그인하기
공식 안내에서 내 운영체제에 맞는 설치 방법을 따라갑니다. Windows의 Git Bash 등 추가 준비물이 안내되면 먼저 설치하세요.
Claude Code 공식 설치 안내- 공식 안내의 설치를 완료합니다.
- 열려 있던 터미널을 닫고 다시 엽니다. 터미널은 컴퓨터에 글로 명령을 전달하는 창입니다.
- 아래 명령으로 설치 여부를 확인합니다.
claude --version버전 숫자가 보이면 설치된 것입니다. claude를 실행하고 화면에 나오는 계정 로그인 절차를 따릅니다.
Claude 구독과 개발용 API 크레딧은 이용 방식이 다를 수 있습니다. 화면에 표시되는 계정·결제 방식을 확인하세요. 이 수업 웹사이트의 실습 참가에는 개인 API 키가 필요하지 않습니다.
작업 폴더 하나 열기
- 찾기 쉬운 곳에
my-first-agent라는 새 폴더를 만듭니다. - VS Code에서 파일 → 폴더 열기로 그 폴더를 엽니다.
- 터미널 → 새 터미널을 엽니다.
- 터미널에
claude를 입력합니다. 폴더를 신뢰할지 묻는다면 방금 만든 내 폴더가 맞는지 확인합니다.
VS Code 확장 기능으로 쓰고 싶다면 공식 VS Code 연동 안내를 따라 설치할 수도 있습니다.
아주 작은 일부터 부탁하기
이 폴더에 hello.txt 파일을 만들어 줘. 내용은 ‘AI와 첫 작업을 시작했습니다.’로 해 줘. 만든 뒤 파일 이름과 내용을 알려 줘.
변경할 내용을 확인하고 실행을 허용합니다. 왼쪽 파일 목록에서 hello.txt를 열어 직접 확인하세요.
이제 2주차에서 더 잘 부탁하는 법을 배웁니다.
2주차로 이어가기 →막혔을 때 확인하기
“claude를 찾을 수 없다”고 나와요
VS Code와 터미널을 완전히 닫고 다시 열어 보세요. 계속 같다면 공식 설치 안내의 운영체제와 설치 완료 여부를 확인합니다.
로그인이나 결제 화면이 나와요
Claude Code의 이용 가능한 계정인지 공식 안내를 확인하세요. 웹 실습만 할 경우에는 이 사이트에서 별명으로 참가하면 됩니다.
웹 실습에서 질문이나 제출이 안 돼요
실습은 늘 열려 있습니다. 잠시 기다렸다가 다시 확인하고, 오류 문구가 계속되면 강사에게 알려 주세요. 참가 키가 사라졌다면 같은 별명으로 다시 참가할 수 있습니다.
설치 화면이 영상과 달라요
앱이 업데이트되면서 메뉴가 달라질 수 있습니다. 개념은 영상을 참고하고, 설치 단계는 위의 공식 안내를 기준으로 진행하세요.