Claude Code for VS Code
anthropic.claude-code
설치 후 왼쪽 Claude 아이콘을 클릭합니다. 찾기 어려우면 명령 팔레트에서 Claude Code를 검색해 Open in New Tab을 선택합니다.
확장 채팅에 필요한 CLI가 포함되어 있어 터미널 설치 명령 없이 시작할 수 있습니다. 공식 안내
ChatGPT·Gemini·Claude를 브라우저 채팅으로만 써 온 분을 기준으로 썼습니다. 프로그램 설치가 낯설어도 마우스 클릭과 복사·붙여넣기로 끝까지 따라올 수 있습니다. Windows 10/11 · macOS 13 이상 모두 지원합니다.
VS Code에서 쓰고 싶다면 → VS Code 설치 + Claude Code · Codex · Antigravity · GitHub Copilot 확장 안내
설치가 잘 되었는지 확인하는 실습은 이 페이지에 없습니다. 워크숍 현장에서 강사와 함께 진행합니다. 여기서는 설치와 로그인까지만 마치면 됩니다.
웹에서 대화하던 AI를 내 작업 공간에서도 쓸 수 있습니다. 선택한 도구에 맞는 계정과 이용 권한을 준비합니다.
| 비교 항목 | 웹 AI (ChatGPT · Gemini · Claude 채팅) | 에이전틱 도구 (내 컴퓨터에 설치) |
|---|---|---|
| 결과물 | 채팅 화면의 글 · 파일로 쓰려면 복사해 옮김 | 내 폴더에 실제 파일로 저장 · 다음 날 바로 업무에 사용 |
| 여러 문서 다루기 | 첨부 개수·용량 제한 · 문서 간 교차 참조가 약함 | 폴더 전체를 보고 여러 파일을 한 번에 일관되게 처리 |
| 내 PC의 프로그램 활용 | 불가 (결과를 내가 옮겨 붙임) | Git·엑셀·문서 프로그램을 AI가 직접 호출 · 여러 단계를 한 번에 진행 |
| 준비 부담 | 없음 · 브라우저만 있으면 시작 | 설치 30~45분 · 회사 노트북은 보안 정책 확인 필요 |
| 보안 주의 | 붙여 넣은 내용만 전송 | 지정한 폴더의 파일 내용이 전송 · 폴더에 넣는 자료를 가려야 함 |
| 익히기 | 이미 익숙 | 대화 방식은 같음 · 다른 것은 "폴더를 열어 준다"와 "파일 변경을 승인한다" 두 동작 |
| 요금 | Claude·Codex·Antigravity는 각 서비스의 구독·이용 권한으로 사용할 수 있습니다. GitHub Copilot은 GitHub 계정과 Copilot 플랜을 사용합니다. API 인증은 별도 과금 경로이며, 무료 등급·구독별 사용 한도는 계정 화면에서 확인합니다. | |
이미 유료로 쓰는 웹 AI가 있으면 그 회사의 앱을 고릅니다. 추가 결제가 없고, 로그인도 그 계정 그대로입니다.
클로드 Pro → Claude 앱 · ChatGPT Plus → ChatGPT 앱(Codex) · Google AI Pro → Antigravity. 무엇을 골라도 워크숍 실습에는 충분하며, 강사가 도구 간 차이를 시연합니다.
하나라도 막히면 워크숍 1주 전 사내 IT에 예외 요청하세요. 당일 막히면 시간 손실이 큽니다.
본인 OS 열만 따라가세요. 한 번 설치하면 이후엔 도구가 알아서 사용하므로 명령어를 외울 필요가 없습니다.
| 단계 | WindowsWindows 10 / 11 | macOSmacOS 13 이상 |
|---|---|---|
| ① 설치 파일 받기 | git-scm.com/download/win 접속 → 자동 다운로드 → 받은 Git-x.xx.x-64-bit.exe 더블클릭"PC 보호" 경고가 뜨면 추가 정보 → 실행. |
Spotlight(Cmd + Space) → "터미널" 검색 → 실행 → 아래 한 줄을 붙여 넣고 Enterxcode-select --install |
| ② 설치 진행 | 설치 마법사의 모든 화면을 기본값 그대로 "Next" → 마지막 "Install" → 약 1~2분 | 팝업이 뜨면 "설치" 클릭 → 약 3~5분. 이미 설치되어 있다는 안내가 나오면 그대로 완료입니다. |
| ③ 마무리 | 반드시 Windows 재부팅 1회. 재부팅을 안 하면 다음 단계의 도구가 Git을 인식하지 못합니다. | 재부팅 불필요. 터미널 창은 닫아도 됩니다. |
세 가지 경로 중 한 탭을 고릅니다. 기본·China 탭은 앱 하나를, VS Code 탭은 VS Code와 사용할 AI 확장을 설치합니다. 처음에는 확장도 하나만 골라도 됩니다. 앱 탭의 도구는 2026년 9월 기준 사용 규모 순입니다.
출처: OpenAI 공지 · JetBrains Developer Ecosystem Survey 2026 · npm 다운로드 통계 · GitHub API. 숫자는 확인일 기준이며 바뀔 수 있습니다.
| 설치 항목 | AClaude 앱 | BChatGPT 앱 (Codex) | CAntigravity |
|---|---|---|---|
| 다운로드 페이지 | claude.com/download | openai.com/chatgpt/download이미 ChatGPT 데스크탑 앱이 있으면 최신 버전으로 업데이트만 하면 Codex가 들어 있습니다. | antigravity.google/download |
| Windows 설치 | "Windows" 버튼 → 받은 .exe 더블클릭 → 자동 설치일반 PC는 x64 · Snapdragon/Surface 계열만 ARM64 선택 |
"Windows" 버튼 → 받은 설치 파일 더블클릭 → 자동 설치Microsoft Store 경로가 보이면 그것으로 설치해도 됩니다. | "Windows" 버튼 → 받은 .exe 더블클릭 → 자동 설치 |
| macOS 설치 | 받은 .dmg 더블클릭 → 앱 아이콘을 Applications 폴더로 드래그Universal 빌드 하나로 Apple Silicon·Intel 모두 |
받은 .dmg 더블클릭 → 앱 아이콘을 Applications 폴더로 드래그Mac App Store 경로가 보이면 그것으로 설치해도 됩니다. |
받은 .dmg 더블클릭 → 앱 아이콘을 Applications 폴더로 드래그Apple Silicon(M1~M4)과 Intel 빌드가 다르면 본인 칩에 맞게 선택 |
| 첫 실행 시 | Windows: "PC 보호" 창 → 추가 정보 → 실행 · macOS: "확인되지 않은 개발자" 경고 → 시스템 설정 → 개인정보 보호 및 보안 → '확인 없이 열기' (한 번만) | ||
| 에이전틱 화면 찾기 | 앱 위쪽의 Chat · Cowork · Code 탭 중 Code 클릭 → 입력창 위에서 프로젝트 폴더 선택Cowork는 코드 없이 문서 작업만 하는 탭. 워크숍은 Code 탭을 씁니다. | 앱 안의 Chat · Work · Codex 중 Codex 클릭 → 폴더 열기로 작업 폴더 지정 | 앱 자체가 에이전트 작업대 → 시작 화면 "Open Workspace"로 작업 폴더 지정 |
| 회사 방화벽이 막을 때 | claude.com · claude.ai · anthropic.com 화이트리스트 요청 | chatgpt.com · openai.com 화이트리스트 요청 | antigravity.google · google.com 화이트리스트 요청 |
에이전틱 도구에 따로 가입하지 않습니다. 웹 채팅에 쓰던 계정으로 로그인하면 요금제도 그대로 적용됩니다.
| 인증 항목 | AClaude 앱 | BChatGPT 앱 (Codex) | CAntigravity |
|---|---|---|---|
| 로그인 계정 | Anthropic 계정 — 웹 클로드(claude.ai)에 쓰던 Google 로그인 또는 이메일 | ChatGPT 계정 — 웹 ChatGPT에 쓰던 이메일·Google·Apple·Microsoft 로그인 | Google 계정 (Gmail · Workspace) — Google 계정 필수 |
| 로그인 방법 | 앱 첫 화면 "로그인" → 브라우저가 열림 → 웹에서 로그인 → 앱으로 자동 복귀 | 앱 첫 화면 "로그인" → 브라우저가 열림 → 웹에서 로그인 → 앱으로 자동 복귀 | 앱 첫 화면에서 Google 계정 선택 → 작업 폴더 접근 동의 |
| 포함 요금제 | 웹 클로드와 같은 클로드 Pro(월 $20 수준)에 포함 · 별도 결제 없음Code·Cowork 탭은 무료 계정에서 열리지 않습니다. 이미 Pro면 추가 비용 없음. | 웹 ChatGPT와 같은 ChatGPT Plus(월 $20 수준)에 포함 · 별도 결제 없음무료·Go 계정도 Codex가 열리지만 한도가 낮아 2시간 실습 중 막힐 수 있습니다. | 제미나이 유료 요금제 Google AI Pro(월 $20 수준)에 포함 · 별도 결제 없음무료 개인 등급은 한도가 낮아 실습 중 막힘이 현장에서 확인되었습니다. |
| 로그인 됐는지 확인 | Code 탭이 열리고 입력창 위에 폴더 선택·모델 선택이 보이면 정상 | Codex 화면이 열리고 폴더 열기 버튼이 보이면 정상 | 시작 화면에 본인 Google 계정 이름이 보이면 정상 |
| 회사 SSO가 막을 때 | 워크숍 한정으로 개인 계정(개인 Gmail 등)으로 가입·로그인 → 본격 업무 적용은 IT와 SSO 연동 협의 | ||
요금제·한도는 변경될 수 있습니다. 가입·결제 전 각 서비스의 요금 화면에서 확인하세요. 워크숍 후 쓰지 않으면 다음 결제일 전에 구독을 취소할 수 있습니다.
.cn 도메인)과 계정·결제가 통용되지 않을 수 있습니다. 계정이 열리는 경로 하나만 고르세요.kimi web으로 브라우저 화면도 열 수 있습니다. Kimi 회원 로그인.| 설치 항목 | ATrae | BQwen Code | CKimi Code | DGLM + OpenCode |
|---|---|---|---|---|
| 다운로드 페이지 | trae.ai/download"TraeCode" 선택. 중국판은 trae.cn(Doubao 모델·별도 계정) |
Qwen Code Desktop 공식 릴리스Assets 목록에서 OS에 맞는 파일 선택 | 설치 파일 없음 — 터미널 명령으로 설치먼저 Node.js 22.19 이상 설치 | opencode.ai/downloadOpenCode Desktop 선택 |
| Windows 설치 | "Windows" 버튼(x64 · Windows 10/11) → 받은 설치 파일 더블클릭 | Windows용 파일 다운로드 → 더블클릭 설치 | 새 PowerShell 창을 열고 아래 한 줄 붙여 넣기npm install -g @moonshot-ai/kimi-code1단계 Git for Windows가 함께 있어야 합니다. |
"Windows" Desktop 설치 파일 → 더블클릭 설치 |
| macOS 설치 | "macOS" 버튼(Apple Silicon · macOS 12+) → .dmg → Applications로 드래그Intel 맥은 지원 여부를 다운로드 페이지에서 확인 |
Mac용 파일(Apple Silicon/Intel 확인) → .dmg → Applications로 드래그 |
터미널을 열고 아래 한 줄 붙여 넣기npm install -g @moonshot-ai/kimi-code |
Apple Silicon/Intel용 Desktop → .dmg → Applications로 드래그 |
| 첫 실행 시 | Windows: "PC 보호" 창 → 추가 정보 → 실행 · macOS: "확인되지 않은 개발자" 경고 → 시스템 설정 → 개인정보 보호 및 보안 → '확인 없이 열기' | |||
| 에이전틱 화면 찾기 | 앱 실행 → 폴더 열기 → 오른쪽 AI 패널(IDE 모드) 또는 SOLO 모드(자동 진행) | 앱 실행 → 인증 → 작업 폴더 선택 | 작업 폴더에서 터미널 열기 → kimi 입력 · 화면형 UI는 kimi web |
앱 실행 → 작업 폴더 열기 → 모델 제공사에서 Z.AI 선택 |
중국계 도구는 웹 채팅 구독 · Coding Plan · API 종량 과금이 서로 다른 경우가 많습니다. 내 계정에서 실제로 열리는 경로 하나만 고르고, 결제는 계정 상태를 확인한 뒤에 하세요.
| 인증 항목 | ATrae | BQwen Code | CKimi Code | DGLM + OpenCode |
|---|---|---|---|---|
| 로그인 계정 | Trae 계정 — 앱 첫 화면에서 가입·로그인(브라우저로 이동) | Alibaba Cloud 국제 계정 + ModelStudio API 키 | Kimi 회원 계정(OAuth) 또는 Kimi Platform API 키 | Z.AI 계정 → API 키 관리에서 키 발급 |
| 로그인 방법 | 앱 "Sign in" → 브라우저 로그인 → 앱 복귀. 별도 키 입력 없음 | 앱 실행 → 인증 화면에서 Alibaba ModelStudio 선택 → 콘솔에서 복사한 API 키 붙여 넣기공식 인증 문서 기준. 과거 무료 OAuth는 종료. | 터미널에서 kimi 실행 → /login → Kimi Code (OAuth) 선택 → 표시된 링크를 브라우저로 열어 로그인·기기 코드 확인공식 시작 가이드 | OpenCode 앱에서 제공사 Z.AI(일반 API) 또는 Z.AI Coding Plan 선택 → 키 붙여 넣기Z.AI 공식 OpenCode 안내 |
| 요금 경로 | Free로 시작 가능(월 한도 있음) · Lite $3 · Pro $10/월(2026-06 요금표) · 앱 안 요금 화면에서 확인 | ModelStudio Coding Plan · Token Plan · 표준 API 중 실제 보유한 것 선택 · 서버 리전이 홍콩이어도 개인 계정 가입·결제가 보장되지는 않음 | Kimi Code 회원 이용권과 플랫폼 API 과금은 별개 · 한도는 계정 화면에서 확인 | 일반 API 키와 Coding Plan 키가 다름 · 국제 Z.AI와 본토 서비스 구독은 통용되지 않음 |
| 로그인 됐는지 확인 | 앱 우상단에 계정 이름이 보이고 AI 패널에 모델이 표시되면 정상 | 인증 화면이 닫히고 모델 이름이 보이면 정상 | /model 입력 시 모델 목록이 보이면 정상 | /models에서 GLM 모델이 보이면 정상 |
| 주의 | API 키는 도구의 인증 입력창에만 넣고 채팅·과제·화면 캡처에 붙이지 않습니다. 가입·지역 오류가 나면 다른 옵션으로 바꾸고, 계정이 열리는지 확인하기 전에는 결제하지 마세요. | |||
VS Code 공식 다운로드 ↗ 이미 설치했다면 최신 버전으로 업데이트한 뒤 ②로 이동하세요.
| 단계 | WindowsWindows | macOSMac |
|---|---|---|
| 다운로드 | Download for Windows → 일반 PC는 x64 User Installer, ARM PC는 Arm64 선택 | Download for macOS → Apple Silicon·Intel에 맞는 버전 또는 Universal 선택 |
| 설치·실행 | 받은 .exe 실행 → 안내에 따라 설치 → Visual Studio Code 실행User Installer는 보통 관리자 권한 없이 설치됩니다. | 받은 .dmg 열기 → Visual Studio Code.app을 Applications로 드래그 → 실행 |
| 확장 화면 열기 | 왼쪽 네모 4개 아이콘(Extensions) 클릭 또는 Ctrl + Shift + X | 왼쪽 네모 4개 아이콘(Extensions) 클릭 또는 Cmd + Shift + X |
공식 설치 안내: Windows · macOS. VS Code 설치와 각 AI 서비스 로그인은 별도 단계입니다.
아래 공식 링크에서 Install → Visual Studio Code 열기 → Install을 누르거나, 확장 화면에서 이름을 검색하세요. 게시자와 확장 ID를 함께 확인하면 동명 확장과 구분할 수 있습니다.
anthropic.claude-code
설치 후 왼쪽 Claude 아이콘을 클릭합니다. 찾기 어려우면 명령 팔레트에서 Claude Code를 검색해 Open in New Tab을 선택합니다.
확장 채팅에 필요한 CLI가 포함되어 있어 터미널 설치 명령 없이 시작할 수 있습니다. 공식 안내
openai.chatgpt
설치 후 왼쪽 Codex 아이콘을 클릭합니다. 아이콘이 없으면 명령 팔레트에서 Codex: Open Codex Sidebar를 실행합니다.
확장 ID에 chatgpt가 들어가도 공식 Codex 확장이 맞습니다. 공식 안내
Google.google-antigravity
설치 후 왼쪽 Antigravity 아이콘을 클릭합니다. 첫 실행 때 필요한 구성요소(agy)가 자동 설치되므로 완료될 때까지 기다립니다.
데스크탑 앱과 별도로 제공되는 Google 공식 VS Code 확장입니다. 공식 안내
GitHub.copilot · GitHub.copilot-chat
확장을 설치하거나 VS Code 아래쪽 Copilot 아이콘 → Use AI Features로 설정을 시작합니다. 채팅용 GitHub Copilot Chat도 함께 설치·활성화되어 있는지 확인합니다.
이 가이드의 Copilot은 GitHub Copilot입니다. 공식 안내
명령 팔레트 열기: Windows Ctrl + Shift + P · macOS Cmd + Shift + P. 확장 설치 후 화면에 나타나지 않으면 Developer: Reload Window를 실행합니다.
설치한 확장의 패널을 열고 아래 절차를 따릅니다. 확장마다 사용하는 계정과 구독이 다릅니다.
Pro·Max·Team·Enterprise 등 Claude Code 이용 권한이 필요합니다. 구독 로그인에는 API 키가 필요하지 않습니다.
Claude Console/API 경로는 별도 사용량 과금입니다. 계정·인증 안내
ChatGPT 로그인은 해당 계정의 Codex 이용 권한·한도를 적용합니다.
Use API Key는 OpenAI Platform API 키로 인증하며 ChatGPT 구독과 별도 과금입니다. 공식 인증 안내
무료 등급을 포함해 계정의 Antigravity 플랜·한도가 적용됩니다.
회사가 제공하면 Sign in with Gemini Enterprise로 인증하고 안내된 Cloud 프로젝트·리전을 선택합니다. 공식 인증 안내
Copilot Free 또는 보유한 Copilot 플랜을 사용합니다. 회사 제공 계정은 관리자의 이용 권한 부여가 필요할 수 있습니다.
ChatGPT·Claude 구독은 Copilot 구독으로 전환되지 않습니다. 공식 설정 안내
.md 파일을 열고 Ctrl/Cmd + Shift + V로 미리볼 수 있어 4단계 MarkText 설치는 생략해도 됩니다. 파일을 만드는 실습은 현장에서 진행합니다.설치·인증 정보 확인: 2026-09-17 · 위 각 공급사의 공식 문서 기준. 버튼 이름과 이용 한도는 버전·계정에 따라 달라질 수 있습니다.
에이전틱 도구가 만드는 결과 파일은 대부분 .md(마크다운)입니다. 메모장으로 열면 **굵게**·# 기호가 그대로 보여, 워드처럼 보기 좋게 열어 주는 무료 뷰어를 설치합니다.
.md 더블클릭으로 열립니다.| 단계 | WindowsWindows 10 / 11 | macOSmacOS 13 이상 |
|---|---|---|
| ① 설치 파일 받기 | ⬇ Windows용 내려받기 (일반 64비트)대부분의 윈도우 PC. Snapdragon/Surface 계열이면 ARM64용. | ⬇ macOS용 내려받기 (Apple Silicon · M1~M4)2020년 이전 인텔 맥이면 Intel용. 칩 확인: 좌상단 메뉴 → "이 Mac에 관하여". |
| ② 설치 | 받은 .exe 더블클릭 → "PC 보호" 경고는 추가 정보 → 실행 → 기본값 그대로 "Next" → "Install" |
받은 .dmg 더블클릭 → MarkText 아이콘을 Applications 폴더로 드래그 → 첫 실행 시 경고가 뜨면 시스템 설정 → 개인정보 보호 및 보안 → '확인 없이 열기' |
| ③ 한국어 설정 | 실행 → File → Preferences → General → Language → "한국어" → 앱 재시작 | 실행 → MarkText → Preferences(Cmd + ,) → General → Language → "한국어" → 앱 재시작 |
대안 — VS Code가 이미 있으면 .md 파일을 열고 Ctrl/Cmd + Shift + V로 미리보기를 띄워도 같습니다. 위 링크가 열리지 않으면 MarkText 릴리스 페이지에서 받으세요.
시스템 설정 → 개인정보 보호 및 보안 아래쪽 "<앱이름>이(가) 차단되었습니다" → "확인 없이 열기". 한 번만 허용하면 이후 더블클릭으로 열립니다.xcode-select --install을 다시 실행하고 앱을 완전 종료(Cmd + Q) 후 재실행.~/Applications(홈 폴더 안)에 드래그하면 관리자 권한 없이 설치됩니다. 거부되면 IT에 워크숍 1주 전 사전 설치 요청.