AI툴 · 가이드

VS Code 설치·Claude Code 연동·GPT 사용법

VS Code 설치를 막 마쳤다면, 다음 순서인 Claude Code 연동과 GPT 사용법에서 막히는 경우가 많습니다. 확장 프로그램을 설치했는데 터미널에 claude를 쳐보면 명령을 찾을 수 없다는 메시지가 뜨거나, GPT 계열 모델은 어디서 켜는지, 뭘 더 설치해야 하는지 헷갈리기도 합니다. 이 글에서는 VS Code 설치부터 Claude Code 연동, GPT 사용법까지 순서대로 정리합니다.

VS Code 설치 방법 (Windows·Mac)

VS Code는 Windows와 Mac 모두 code.visualstudio.com에서 내려받습니다. 설치 파일 용량은 200MB가 안 되고, 설치 후 디스크 사용량도 500MB를 넘지 않아 부담이 적습니다.

Windows에서 설치하기

code.visualstudio.com에 접속해 “Download for Windows” 버튼을 클릭합니다. 내려받은 VSCodeUserSetup 파일을 실행하면 라이선스 동의 화면이 뜨고, 이후 Next를 몇 번 누르면 Install 단계로 넘어갑니다. Install을 누르고 잠시 기다리면 Finish 버튼과 함께 설치가 끝납니다.

Mac에서 설치하기

Mac은 “Download for Mac Universal” 버튼을 눌러 dmg 파일을 받습니다. dmg 파일을 열면 VS Code.app 아이콘이 보이는데, 이걸 Applications 폴더로 드래그하면 설치가 끝납니다. 이후로는 Applications 폴더나 Spotlight 검색에서 실행하면 됩니다. 설치 파일 이름에 붙는 버전 번호는 계속 바뀌므로, 특정 숫자보다는 화면에 보이는 버튼과 흐름 위주로 따라가는 편이 낫습니다.

Claude Code 연동 방법: 확장과 CLI 차이

VS Code에 Claude Code를 붙이는 방법을 공식 문서는 두 갈래로 나눕니다. 하나는 VS Code 확장 프로그램이고, 다른 하나는 터미널에서 실행하는 CLI입니다. 이 둘을 같은 것으로 착각하면 나중에 헷갈리는 지점이 생깁니다.

확장 프로그램 설치 (공식 문서가 권장하는 방법)

공식 문서는 확장 프로그램 설치를 “recommended way”로 명시합니다. 필요한 건 VS Code 1.94.0 이상 버전과 Anthropic 계정입니다. Pro나 Max, Team, Enterprise 같은 유료 구독 계정이거나 Claude Console 계정이면 되고, API 키는 따로 필요하지 않습니다.

설치는 간단합니다. VS Code에서 Ctrl+Shift+X를 눌러 Extensions 뷰를 열고 “Claude Code”를 검색해 Install을 누르면 됩니다. vscode:extension/anthropic.claude-code라는 공식 딥링크로 바로 설치하는 방법도 있습니다. 설치가 끝나면 에디터 우측 상단에 Spark 아이콘이 생깁니다.

이 아이콘을 클릭하면 첫 실행 시 브라우저를 통한 로그인 화면이 뜹니다. 로그인이 끝나면 바로 프롬프트를 입력해 대화를 시작할 수 있습니다. 아이콘이 안 보인다면 명령 팔레트에서 “Developer: Reload Window”를 실행하면 대부분 해결됩니다.

터미널에서 claude 명령 쓰기 (CLI, 별도 설치 필요)

여기서 다들 한 번씩 막힙니다. 확장 프로그램을 설치했다고 해서 통합 터미널에 claude 명령이 자동으로 등록되는 건 아닙니다. 확장은 챗 패널에서 쓸 CLI 사본을 자체적으로 내장하고 있을 뿐, 이걸 시스템 PATH에 추가해주지는 않습니다. 실무에서 자주 보고되는 증상이 바로 이 부분인데, 확장만 설치한 뒤 통합 터미널을 열어 claude를 쳐보면 명령을 찾을 수 없다는 메시지를 보게 되는 경우입니다.

터미널에서 claude를 직접 쓰려면 별도의 standalone CLI를 설치해야 합니다. Windows PowerShell에서는 irm https://claude.ai/install.ps1 | iex 명령으로 설치하고, CMD 창에서는 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd 명령을 씁니다. 이 두 명령은 서로 호환되지 않아서, PowerShell용 명령을 CMD 창에 넣거나 반대로 넣으면 에러가 납니다. 창 왼쪽에 “PS C:\” 표시가 있는지로 PowerShell인지 아닌지를 구분할 수 있습니다.

시스템 요구사항은 Windows 10 1809 이상 또는 Windows Server 2019 이상, Mac은 macOS 13.0 이상이고 RAM은 4GB 이상이 필요합니다. npm으로 설치하는 경우(2.1.198 버전 기준) Node.js 22 이상을 요구하는데, 이보다 낮은 버전에서는 EBADENGINE 경고가 뜨긴 하지만 설치되는 게 Node에 의존하지 않는 네이티브 바이너리라 대체로 설치와 실행 자체는 문제없이 진행됩니다.

이렇게 설치한 CLI를 VS Code의 통합 터미널(Ctrl+`)에서 실행하면 diff 보기나 진단 공유 같은 IDE 기능과 자동으로 연동됩니다. 외부 터미널에서 실행할 때는 Claude Code 안에서 /ide 명령을 입력해 VS Code에 수동으로 연결해야 합니다.

확장과 CLI, 언제 뭘 쓰는지 표로 정리하면 다음과 같습니다.

VS Code GPT 사용법: Copilot Chat 모델 전환

Claude Code 연동이 끝났으면 다음은 GPT 계열 모델 차례입니다. 공식 문서 기준으로 가장 확실한 경로는 GitHub Copilot Chat의 모델 선택 드롭다운입니다.

VS Code는 GPT 계열을 포함한 여러 언어 모델을 별도 확장 설치 없이 제공하는 것으로 보이며(추정: 공식 문서에 명시적 확인 문구는 없으나 UI 흐름상 그렇게 확인됩니다), 채팅 입력창 하단의 모델 선택기를 클릭하면 바로 전환할 수 있습니다. 다만 이 모델을 쓰려면 GitHub Copilot 구독(계정)이 전제됩니다. 이 부분이 공식 문서에는 은근하게만 적혀 있어서, 계정 없이 시도했다가 헛수고하는 경우가 생길 수 있습니다.

GitHub 공식 체인지로그(2025-09-15 기준)에는 Copilot Chat의 “auto” 모델 옵션이 GPT-5, GPT-5 mini, GPT-4.1, Sonnet 4, Sonnet 3.5 같은 모델로 자동 라우팅한다고 나와 있습니다. 이 목록은 이후로도 계속 바뀔 수 있어서, 지금 화면에 보이는 목록과 다를 수 있다는 점을 감안해야 합니다.

API 키를 직접 연결하는 방법 (BYOK, 심화)

Copilot 구독 없이 OpenAI API 키를 직접 붙이는 방법도 공식 문서에 나와 있습니다. Bring Your Own Key, 줄여서 BYOK라고 부르는 방식인데, “Language Models” 편집기에서 “Add Models”를 눌러 추가하면 됩니다. 다만 이 방식은 API 사용량만큼 별도 요금이 발생하고 설정도 한 단계 더 필요해서, 처음에는 Copilot 구독으로 시작해보고 나중에 필요할 때 옮기는 편이 낫습니다.