Claude Code 설치와 첫 대화: VS Code 확장으로 시작하기

Claude Code 설치는 VS Code 안에서 확장(추가 기능) 하나를 설치하는 것으로 끝납니다. 확장 안에 Claude Code 본체가 들어 있어서, 패널로 쓸 때는 터미널 명령을 따로 입력하지 않아도 됩니다.

준비물은 두 가지입니다. 준비 2편에서 설치한 VS Code, 그리고 Claude 유료 요금제(Pro, Max, Team, Enterprise) 계정입니다. 무료 요금제에는 Claude Code가 들어 있지 않습니다.

Claude Code 설치 3단계

1. VS Code에서 Ctrl+Shift+X(맥은 Cmd+Shift+X)를 눌러 확장 화면을 엽니다.
2. 검색창에 Claude Code를 입력하고, 게시자가 Anthropic이고 파란 인증 표시가 있는 “Claude Code for VS Code”를 고릅니다.
3. Install(설치)을 누릅니다.

로그인하고 첫 대화 나누기

1. 편집기 오른쪽 위나 왼쪽 막대에 생긴 불꽃 모양(Spark) 아이콘을 눌러 Claude Code 패널을 엽니다.
2. 로그인 화면에서 Sign in을 누르면 브라우저가 열립니다. 평소 Claude에서 쓰는 계정으로 승인합니다.
3. 패널 아래 입력창에 한국어로 요청합니다.

첫 대화는 이렇게 읽기만 하는 요청이 좋습니다. Claude Code가 폴더를 제대로 보고 있는지 확인할 수 있습니다.

Claude Code 설치 뒤 먼저 할 일: 권한 모드

Anthropic 문서에 따르면 Claude Code 2.1.283 버전부터 VS Code에서는 Auto 모드로 시작합니다. Auto 모드에서는 별도의 검토 기능이 사람 대신 판단해서, 대부분의 파일 수정과 명령을 묻지 않고 진행합니다.

처음에는 입력창 아래의 모드 표시를 눌러 Manual로 바꾸는 것을 권합니다. Manual에서는 파일을 고치거나 명령을 실행하기 전에 먼저 묻습니다.

모드	하는 일	이럴 때
Manual	파일 수정·명령 전에 매번 확인	처음 쓸 때, 원자료가 있는 폴더
Plan	할 일을 먼저 설명하고 승인 대기	큰 작업을 맡기기 전
Auto	대부분 묻지 않고 진행	익숙해진 뒤, 되돌릴 수 있는 작업

ChatGPT를 쓴다면: Codex 설치

Codex도 순서가 거의 같습니다.

1. 확장 화면에서 게시자가 OpenAI인 “Codex – OpenAI’s coding agent”를 설치합니다.
2. Codex 패널을 열고 Sign in with ChatGPT로 로그인합니다.
3. 입력창 아래 권한 메뉴에서 Ask for approval로 시작합니다. 작업 폴더 밖이나 인터넷을 쓰기 전에 먼저 묻는 모드입니다.

Windows에서도 따로 준비 없이 쓸 수 있습니다. 권한 메뉴 이름은 확장 버전에 따라 조금 다를 수 있습니다.

정리