- 다시 한번 window 에서 claude-code를 어떻게 사용하면 되는지 wsl을 설치 하지 않는 관점에서 작성 해보겠다.
1. 필수 준비 사항
- Git, Node ( 기존에는 Node와 WSL이 준비사항 이었다면, 상기 업데이트 내용에 따라 Git, Node가 이제는 필수 준비 사항이다. ) - 설치 방법은 너무 많은 포스팅이 있기도 하고, cladue 설치 방법이니 claude에게 물어 봐도 된다. 예전 글이지만 혹시 링크도 남겨 두긴 하도록 한다.
[2026 업데이트 — 필수 준비사항 변경] 네이티브 인스톨러를 사용할 경우 Node.js 설치가 더 이상 필요 없다. Git(Windows의 경우 Git for Windows)만 있으면 된다. npm으로 설치하는 레거시 방식만 Node.js >= 18이 필요하다.
OS 요구사항: macOS 13.0+, Ubuntu 20.04+ / Debian 10+, Windows 10 (1809+) / Windows 11
RAM: 최소 4GB, 권장 8GB
계정: Pro, Max, Teams, Enterprise, 또는 API 콘솔 계정 필요 (Free 플랜은 Claude Code 미포함)
[2026 업데이트 — 설치 방법 대폭 변경] 2025년 10월부터 Anthropic은 네이티브 인스톨러를 공식 권장 설치 방법으로 제공하고 있다. Node.js 설치가 불필요하며 자동 업데이트가 지원된다. 기존 npm 방식은 "레거시(legacy)"로 분류되었으나 여전히 작동한다.
# Claude Code 실행
claude
# 또는 특정 프로젝트 폴더에서
claude --project-path /path/to/your/project
- 테마를 선택하고 나면 세션이 시작되는데 몇가지 설정 및 인증을 요구 한다.
1) Claude Code 시작, 구동 방법
- 1. API key를 발급하여 사용한 토큰 만큼에 비례하여 사용하는 방식
- 2. pro플랜이나, max플랜 사용시 플랜별로 제공되는 코드 작업량, 메시지 제한, 컨텍스트 윈도우 등에 차이가 있다 >>>> 1번 방식을 사용해서 감당이 되지 않을 것이니 2번 방식을 대부분 선택할 것이다. 정말 혹여나 1번 방식으로 잠깐 체험해보고자 한다면 다음글 본문에 있으니 참고 가능은 하다 ㅠ
주간 별 사용량 제한 도입 2025년 8월 말부터 Pro, Max 사용자 모두에게 주간 기준 사용량(rate limits)이 추가됩니다. 이는 과도한 Claude Code 사용, 특히 “24/7” 자동화 기반의 heavy user(“inference whales”) 대응을 위한 조치입니다
⚠ [2026 업데이트] 아래 "예상 사용 시간"은 2025년 커뮤니티 추정치이며, Anthropic 공식 수치가 아니다. 2026년 현재 사용량 구조는 5시간 세션 윈도우 + 주간 한도 + 모델별 동적 제한으로 변경되었고, 2026년 3월 26일부터 피크 시간대 추가 제한도 도입되었다. 따라서 아래 시간 수치는 참고용으로만 볼 것.
브라우저 확장형 AI 에이전트 "Claude for Chrome" Max 사용자를 대상으로 초기 시험판 제공 중이며, 웹 브라우저 내에서 Claude를 직접 활용할 수 있는 기능이다.위키백과+1.
2. vs-code와 연동하기
[2026 업데이트 — VS Code 연동 방식 완전 변경] 2025년 9월 v2.0.0부터 Anthropic 공식 VS Code 확장이 출시되었다. 더 이상 WSL 확장을 통한 우회가 필요 없으며, Windows에서도 네이티브로 동작한다.
현재 권장 방법:
VS Code Extensions (Ctrl+Shift+X)에서 "Claude Code" 검색
퍼블리셔가 Anthropic(공식)인 것을 확인 후 설치
터미널에서 claude 입력 시 확장이 자동 연동
주요 기능 (공식 확장):
인라인 Diff 뷰어 — 변경 사항을 VS Code 내에서 직접 확인/승인
@멘션으로 파일+라인 범위 지정
Plan 모드 — Claude의 작업 계획을 미리 검토 후 승인
대화 히스토리 및 멀티 탭 지원
선택 영역 자동 컨텍스트 전달
JetBrains IDE도 지원: IntelliJ, PyCharm, WebStorm 등에서 "Claude Code [Beta]" 플러그인 사용 가능 (2026.03 기준 베타).
⚠ 아래의 WSL 기반 연동 방식은 레거시 방법이다. 현재는 공식 확장 사용을 강력히 권장한다.
1) (레거시) VS-CODE 실행 > Extension에서 WSL 검색 및 설치
- WSL코드 내에서 wsl을 사용할 수 있게 해준다.
- 좌측 하단 신규 생성된 버튼 클릭
- Connect to WSL 클릭 하면 재기동 되며 - 터미널 실행시 WSL 환경으로 접속 된다.
(잠시 로딩 중) 참고로 20.04로 보이지만 실제는 22.04 버전이다. (예전 포스팅 했을때 20.04 에서 22.04로 업그레이드 하여 20.04버전처럼 보이는 현상)
- 터미널 실행시 wsl 환경
2) 프로젝트 설정
- 프로젝트 폴더를 연다. ( 이때 wsl 환경이어서 /mnt/ 하위 경로일 것이다. )
- claude 입력 및 권한을 부여해 준다. (다음과 같이 창 하단에 claude가 실행될텐데, 나와 같은 경우 커서와 윈드서프와 같은 ui에 익숙해져 있으니 터미널 위치를 변경해 주려 한다. )
- Terminal 우클릭 > Panel Position > Right
- extention > claude 입력 > 공식 Anthropic에서 제공하는 plugin을 설치해보자.
- 버전이슈로 업데이트 후 진행하였다.
※ 주요 특징 (Features) - 자동 설치 (Auto-installation) VS Code의 터미널에서 Claude Code를 실행하면, 확장 기능이 자동으로 설치됩니다.
- 선택 영역 컨텍스트 전달 (Selection context) VS Code 편집기에서 선택한 텍스트가 자동으로 Claude의 프롬프트 컨텍스트에 포함됩니다.
- Diff 보기 (Diff viewing) 코드 변경 사항을 터미널이 아닌 VS Code의 diff 뷰어에서 직접 확인할 수 있습니다.
- 키보드 단축키 지원 (Keyboard shortcuts) Alt+Cmd+K와 같은 단축키로 선택한 코드를 Claude에 즉시 전송할 수 있습니다.
- 탭 인식 (Tab awareness) Claude는 VS Code에서 열려 있는 파일들을 인식할 수 있어, 어떤 파일의 코드인지 파악할 수 있습니다.
- 설정 옵션 (Configuration) /config에서 diff 툴을 auto로 설정하면 IDE 통합 기능이 활성화됩니다.
🔹 요구 사항 (Requirements) VS Code 1.98.0 이상 필요. > 이때문에 나의 경우 오래된 버전으로 오류 발생.
※ 재기동 하지 않고 테스트 하는 경우 다음과 같이 수행 불가 하니 재기동 해주도록 하자.
3) 플러그인 추가 설정 ( 옵셔널 )
⚠ [2026 업데이트] 아래에서 소개하는 "Claude Code Chat"은 서드파티(비공식) 플러그인이다. 2025년 9월 Anthropic 공식 VS Code 확장이 출시된 이후로는 공식 확장 사용을 권장한다. 서드파티 플러그인은 공식 확장 대비 기능이 제한적이며, 유지보수 상태도 불확실하다. 설치 시 퍼블리셔가 "Anthropic"인지 반드시 확인하자.
- 한가지 plugin 더 설치 해보려고 한다. 최대한 cursor와 익숙해진 상태에서 불만족 스러울 수 있으니 임시로 사용해보자.
- 플러그인 명 : Claude Code Chat
사용 이유 : 그나마 최근 나온 플러그인중 최신 이며 점수가 괜찮아서 사용해보려 한다.
- 상기 이미지대로 설치 후 보이는 프롬프트(ctrl + shift + c 입려시 노출)가 좀더 gui 친화적인것 처럼 보인다.
ex) 최근에 결제한 토큰을 다 사용해서 사용 불가로 나온다.
ex) 프로플랜 적용 후 사용 가능 ( 다만 사용 토큰 및 $가 올라가는 모습에 겁먹을 수 있다.)
- 상기 이미지와 같이 보여주는 것 때문에 걱정하는 지인분들이 있어 이와 관련된 내용을 ai를 통해 정리해서 올려 둔다.
- 결론 : 예상 비용이니 프로 플랜 / 맥스 플랜 사용자 분들께선 참고라고 생각하면 된다.
( 나중에 구독형이 아니었을 때와 비교하여 얼마 아낄 수 있었는지 계산해 봐도 될 것 같다.)
Claude Code Chat VSCode 플러그인 사용 시 결제 및 사용량 안내
1. VSCode 플러그인에서 표시되는 사용량/달러의 의미 플러그인 하단에 표시되는 "달러($)"와 "토큰" 정보는 실제로 사용한 Claude Code의 API 사용량을 실시간으로 보여주는 기능입니다.
이 수치는 사용자가 Claude Code 기능을 통해 소모한 토큰(=API 사용량)과, 해당 사용량을 Anthropic의 API 요금 기준으로 환산한예상 비용을 나타냅니다.
즉, 실제 결제될 금액이 아니라 현재까지의 사용량을 시각적으로 보여주는 참고용 정보입니다.
2. 클로드 코드 프로 플랜 사용 시 과금 구조 Claude Pro 플랜(월 $20) 또는 Max 플랜을 구독 중이라면, 별도의 API 크레딧을 충전하지 않는 한 추가 과금 없이 정해진 사용량 한도 내에서 사용할 수 있습니다.
Pro 플랜, Max 플랜에 대한 가격 정책은 공식문서 확인이 정확한다.
"API 크레딧(별도 결제)이 연동된 경우"에는, 한도 초과 시 자동으로 API 요금이 청구될 수 있으니 주의해야 합니다. API 크레딧을 사용하지 않고, Pro/Max 플랜 계정만으로 로그인했다면 추가 결제 없이 플랜 한도 내에서만 사용됩니다.
3. 실제 결제 여부 및 주의사항 프로 플랜만 사용하는 경우: VSCode 플러그인에서 보이는 달러 금액은 "실제 결제될 금액"이 아니라, 플랜 내에서 사용한 양을 환산한 참고치입니다. 별도의 API 크레딧을 충전하지 않았다면 추가 결제는 발생하지 않습니다.
API 크레딧을 연동한 경우: 한도 초과 시 API 요금이 실제로 결제될 수 있습니다. 이 경우, VSCode 플러그인에 표시되는 금액이 실제 결제 금액과 일치할 수 있습니다.
자동 충전(오토 리로드) 설정 여부: API 콘솔에서 자동 충전이 켜져 있으면 한도 초과 시 자동 결제가 발생할 수 있으니, 콘솔 설정을 꼭 확인하세요.
4. 결론 및 안전한 사용법 프로 플랜 한도 내에서만 사용한다면 VSCode 플러그인에 표시되는 금액은 참고용일 뿐, 실제 결제 금액이 아닙니다. API 크레딧을 추가로 결제하지 않는 한, 별도의 요금이 청구되지 않습니다. API 크레딧/오토 리로드를 사용 중이라면, 실제 결제에 유의하세요.
참고: 안전하게 사용하려면 로그인 시 Pro/Max 플랜 계정만 사용하고, API/콘솔 키는 입력하지 마세요. 자동 충전(오토 리로드) 설정 여부를 콘솔에서 꼭 확인하세요. 플러그인에서 표시되는 사용량/금액은 참고용임을 인지하세요.
- 위의 이미지 같은 경우 api 방식으로 테스트 했을 당시 토큰 소진이 다된상태이고, 나의 경우도 pro 플랜을 사용하고 있으니 일정 부분 사용 가능하다. 이런경우 다시 구독형 플랜으로 로그인 해주자. /login 입력
- 1) subscription . 구독 플랜을 선택 해준다.
- 앗..... pro플랜 계정이 아닌, 블로그 작성용 테스트 계정으로 되어있어서, pro plan구독 계정으로 변경 후 다시 시도
- 승인 하여 연결 처리
- 복사하여 다시 prompt에 입력하여 준다.
- 하기 이미지처럼 복사 붙여 넣은 후 엔터
***************** 번외 ******************
- Claude Code Chat 플러그인을 써본내용도 참고 하실분들을 위해..
- 몇번의 대화를 오가며 사용한 토큰 사용량
- 최근 n8n으로 자동화 테스트 하고 있는 pr 리뷰에 대한 요청을 아주 간단하게만 해봤다.
- 든든한 내 assistant께서 아주 간단히 리뷰해 주셨다.
- Thinking이 원래 영어로 출력될때는 그러려니 했는데 막상 한글로 출력해서 봤더니, 은근히 귀여운것 같다.
- 개인적으로 체감하는 제일 큰 단점 : 사용량을 충분히 제공해주지 않는 다는 점이다.
생산성도 너무 좋아지고, 여러 장점이 많은데 나의 경우 오전에 한번 막히고, 오후에 한번더 막히면.... 이렇게 퇴근 시간이 되어 버린다.
( 이를 보완하기위해 gemini cli도 한번 시간이 괜찮으면 리뷰 남겨 보도록 해야겠다. )
[2026 업데이트] 사용량 문제는 여전히 많은 사용자의 공통 불만이다. Anthropic은 이후 다음과 같은 대응을 했다.
Max 플랜 ($100/$200)으로 대폭 늘어난 한도 제공
Extra Usage (PAYG) — 한도 소진 후 추가 요금으로 계속 사용 가능한 옵션 도입
Haiku 4.5 자동 라우팅 — 간단한 작업은 저비용 모델로 자동 전환해 예산 절약
피크 시간대 제한 (2026.03) — 반대로, 피크 시간에는 제한이 강화되기도 함
결론적으로 "사용량 부족" 문제는 완전히 해결되지 않았으며, 사용 패턴에 따라 체감이 다를 수 있다.
- 07월 19일 확인시 mcp 적용도 매우 쉽게 가능 해졌다. (하단 popular mcp 를 선택 후 추가하면, 관련 mcp 가 동작하는 모습 )
🆕 2026년 3월 기준 — 알아두면 좋은 주요 변화
이 글을 처음 쓴 2025년 7월 이후로 Claude Code는 단순 CLI 도구에서 멀티 인터페이스 에이전틱 개발 플랫폼으로 진화했다. 아래는 기존 글에서 다루지 못한 핵심 변화를 정리한 것이다.
1) 인터페이스 확장 — 더 이상 터미널만이 아니다
인터페이스
출시 시기
특징
CLI (터미널)
2025.02 (베타)
원조. claude 명령어로 실행. 가장 유연하고 자동화에 적합.
VS Code 확장
2025.09 (v2.0.0)
Anthropic 공식. 인라인 diff, plan 모드, @멘션. 가장 많이 사용됨 (200만+ 설치).
JetBrains 플러그인
2025 하반기 (베타)
IntelliJ, PyCharm, WebStorm 등. 2026.03 기준 베타 상태.
웹 앱
2025.10.20
claude.ai Code 탭. 브라우저만으로 사용 가능. 설치 불필요.
데스크탑 앱
Mac 2025.11 / Win 2026.02
GUI 기반. 폴더 선택, 모델 전환, 내장 브라우저 프리뷰. claude.ai/download에서 다운로드.
모바일 (iOS)
2025 하반기
Claude 앱 내 Code 탭. Dispatch로 원격 작업 지시 가능 (2026.03).
2) 모델 세대 변화
이 글 작성 당시(2025.07)에는 Claude 3.5 Sonnet / Opus 4 세대였다. 현재는 Claude 4.6 세대로 넘어왔다.
모델
출시일
컨텍스트
Claude Code에서의 역할
Opus 4.6
2026.02.05
1M 토큰
기본 모델 (Max/Team/Enterprise). 복잡한 아키텍처, 대규모 코드베이스 분석.
Sonnet 4.6
2026.02.17
1M 토큰
일반 코딩 작업. Pro 플랜 기본. 빠르고 효율적.
Haiku 4.5
2025.10
200K 토큰
간단한 작업 자동 라우팅. 파일 읽기, 빠른 편집 등에 사용되어 사용량 절약.
- 1M 토큰 컨텍스트는 2026년 3월 13일에 추가 비용 없이 GA(일반 공개)되었다. 이전 200K 대비 5배 넓은 맥락을 볼 수 있다.
3) 주요 신기능 요약
2025년 7월 시점에는 "터미널에서 코드 작업을 도와주는 AI"였다면, 지금은 완전한 에이전틱 개발 플랫폼이다.
기능
도입 시기
설명
Hooks
2025.09 (v2.0.0)
도구 실행 전/후에 자동 실행되는 스크립트. 린트, 테스트, 알림 자동화 등. settings.json에서 설정.
Skills
2025.10 (v2.0.x)
재사용 가능한 워크플로우를 마크다운(SKILL.md)으로 정의. 슬래시 명령으로 호출. 플러그인 마켓플레이스도 존재.
GitHub Actions
2025.09 (v2.0.0)
PR 코멘트에 @claude 멘션 시 자동 코드 리뷰/수정. anthropics/claude-code-action@v1
Auto Memory
2026.03 (v2.1.59)
대화에서 학습한 내용을 자동 저장. 다음 세션에서 프로젝트 맥락을 기억. /memory로 관리.
Agent Teams
2026 초 (v2.1.x)
여러 Claude Code 인스턴스가 팀으로 협업. 리드가 작업 분배, 팀원이 독립 작업 후 결과 통합.
Cowork / Dispatch
2026.03
데스크탑에서 백그라운드 작업. Dispatch로 모바일에서 원격 작업 지시. QR코드 연결.
Channels
2026.03 (v2.1.80)
Telegram/Discord에서 Claude Code에 메시지. 외부 이벤트를 세션에 주입.
Auto Mode
2026.03 (프리뷰)
AI 분류기가 도구 호출 안전성을 판단. 안전한 작업은 자동 승인, 위험한 작업은 차단. Shift+Tab으로 전환.
/loop (크론)
2026.03 (v2.1.71)
명령을 주기적으로 반복 실행. 예: /loop 5m 배포 상태 확인
4) MCP(Model Context Protocol) — 단순 소개에서 생태계로
이 글 작성 당시 MCP는 간단히 언급만 했었는데, 이제는 200개 이상의 MCP 서버가 존재하는 생태계로 성장했다. GitHub, Slack, Jira, 데이터베이스 등 외부 서비스를 Claude Code에 연결하는 표준 프로토콜이다.
2025.11 — 비동기 작업, OAuth 2.1, HTTP 전송 지원 추가
2025.12 — Linux Foundation 산하 Agentic AI Foundation에 기부
OpenAI, Google DeepMind도 채택 → 사실상 업계 표준
⚠️ 이 글의 모든 정보에 대한 주의사항
Claude Code를 포함한 AI 코딩 도구 분야는 매주 단위로 변화가 일어나고 있다. 이 글에서 다룬 정보도 며칠 뒤면 달라질 수 있다.
요금제 — 가격은 유지되더라도 사용량 한도, 모델 접근 등 세부 조건은 수시로 변한다.
기능 — 거의 매일 새 버전이 나온다. 이 글의 기능 목록은 빠르게 불완전해질 수 있다.
모델 — 새 모델 세대가 수개월 단위로 출시된다.
경쟁 환경 — Cursor, Windsurf, GitHub Copilot, Gemini CLI 등도 빠르게 발전 중이다.
[2026.03.30 업데이트 후기] 이 글을 처음 쓴 지 약 9개월이 지났는데, Claude Code가 이렇게까지 빠르게 변할 줄은 예상하지 못했다. 버전만 해도 v1.0.43에서 v2.1.87로, 약 180회 이상 업데이트가 이뤄졌다. 설치 방법부터 요금 구조, 사용 가능한 인터페이스까지 거의 모든 것이 달라졌다. 이 글의 업데이트 박스들이 그 변화의 증거이다. AI 도구 관련 블로그 글은 "작성 시점"을 항상 염두에 두고 읽자. 이 업데이트 내용도 조만간 구버전이 될 것이다.
- AI는 개발자에겐 이제 '도구'가 아닌 '파트너'라고 생각해도 될 것 같다.
- Claude Code는 단순히 코드를 자동화 툴이 라기보단, 개발자의 역량과 사고 흐름에 따라 동행하는 협력자라고도 느껴졌다. "개발자와 함께 문제를 풀어나가는 파트너"라고 표현해도 과하지 않다고 생각한다. - 앞으로의 개발은 "혼자서 잘하는 개발자"보다 "AI를 잘 다루는?? 아니 AI와 잘 협력할 줄 아는 개발자"가 더 빠르게 성장할 수 있을거라고 느껴 졌다.
기회가 된다면 다른 분들도 한 줄의 명령어로 Claude Code를 통해 새로운 개발 경험을 해보고, 후기를 남겨주시면 좋을 것 같다.
