연결

Windows에서 Claude Code 사용하기

Windows에서 Claude Code를 쓰는 방법은 두 가지입니다. PowerShell에서 바로 실행하거나, WSL에 설치해 Linux처럼 쓰는 방법입니다. 이 페이지는 네이티브 Windows에서의 설치, 설정, 문제 해결을 다루며, WSL은 마지막 섹션에 있습니다.

설치

권장: 네이티브 설치

PowerShell을 열고(관리자 권한 불필요) 다음을 실행합니다.

irm https://claude.ai/install.ps1 | iex

설치가 끝나면 그 창을 닫고 새 PowerShell을 연 다음 claude --version을 실행하세요. 버전 번호가 나오면 성공입니다. 설치 프로그램은 claude가 있는 폴더를 사용자 PATH에 추가하는데, 새로 연 터미널에서만 반영됩니다.

또는: npm 설치

Node.js 22 이상이 설치되어 있다면 다음 명령으로도 설치할 수 있습니다.

npm install -g @anthropic-ai/claude-code

다운로드가 느리면 중국 본토의 npm 미러가 도움이 됩니다. 설치 방법은 하나만 쓰세요. 둘 다 설치하면 어느 claude가 실행될지 예측할 수 없습니다.

Git for Windows (선택)

네이티브 Windows에서 Git for Windows는 선택 사항입니다. 없으면 Claude Code는 PowerShell로 명령을 실행하고, 있으면 Git Bash를 사용합니다. Bash 도구와 Monitor 도구는 Git Bash가 필요합니다(공식 설치 가이드 참고). 이미 Git을 쓰고 있다면 설치해 두세요.

Git은 설치되어 있는데 Claude Code가 Git Bash를 찾지 못하면, settings.json의 env 블록에 있는 CLAUDE_CODE_GIT_BASH_PATH가 bash.exe를 가리키게 하세요. 예: "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe" (JSON에서는 백슬래시를 두 번 씁니다).

설정

방법 1: 설정 파일 (권장)

파일 탐색기 주소창에 %USERPROFILE%\.claude를 입력하고(폴더가 없으면 .claude 폴더를 만드세요), 메모장이나 VS Code로 settings.json을 만들거나 편집합니다.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://corecode.live",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

UTF-8로 저장하세요. 파일에 이미 내용이 있다면 env 블록만 합치고, 쉼표와 따옴표의 짝이 맞는지 확인하세요. PowerShell, Git Bash, VS Code 확장이 모두 이 파일을 읽으므로 한 번만 편집하면 전부 적용됩니다.

방법 2: 환경 변수

현재 창에서만 시험해 보려면 다음과 같이 합니다.

$env:ANTHROPIC_BASE_URL = "https://corecode.live"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-key"
claude

영구 적용하려면 setx로 사용자 환경 변수를 기록한 다음 새 터미널을 여세요(setx는 이미 열린 창에는 영향을 주지 않습니다).

setx ANTHROPIC_BASE_URL https://corecode.live
setx ANTHROPIC_AUTH_TOKEN sk-your-key

ANTHROPIC_API_KEY를 함께 설정하지 마세요. Auth conflict가 발생합니다. 오류를 참고하세요.

동작 확인

claude -p "reply ok"

"ok"가 돌아오면 연결된 것입니다. Claude Code에서 /status를 입력했을 때 Base URL이 https://corecode.live여야 합니다.

자주 겪는 문제

증상	해결 방법
`The term 'claude' is not recognized` 또는 "not recognized as an internal or external command"	새 터미널을 열고 다시 시도하세요. 그래도 안 되면 Claude Code 설치 폴더가 사용자 `PATH`에 있는지 확인하세요. npm으로 설치했다면 `npm config get prefix`가 보여 주는 폴더가 `PATH`에 있어야 합니다.
`running scripts is disabled on this system`	PowerShell 실행 정책이 npm이 만든 `claude.ps1`을 막고 있습니다. `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`를 실행하고 새 터미널을 열거나, 네이티브 설치를 사용하세요.
처음 실행할 때 `Unable to connect to Anthropic services`가 나옴	`%USERPROFILE%\.claude.json`의 최상위에 `"hasCompletedOnboarding": true`를 추가하세요. 오류를 참고하세요.
설정을 바꿨는데도 공식 서비스를 쓰고 있거나 `/login`을 요구함	`settings.json`이 `%USERPROFILE%\.claude\`에 있는지, 메모장이 파일 이름 끝에 `.txt`를 붙이지 않았는지 확인한 다음 새 터미널을 여세요.
중국어 텍스트가 깨짐	Windows Terminal에서 Claude Code를 실행하고, 설정 파일은 UTF-8로 저장하세요.

VS Code와 JetBrains

VS Code용 Claude Code 확장은 명령줄과 %USERPROFILE%\.claude\settings.json을 공유합니다. 방법 1을 마친 뒤 VS Code를 완전히 종료했다가 다시 여세요. 확장에 claude.ai 계정으로 로그인했다면 먼저 로그아웃하세요. JetBrains 플러그인은 IDE 터미널에서 명령줄 버전을 실행하므로 설정 방법이 같습니다.

WSL에서 사용하기

이미 WSL에서 개발하고 있다면 그 안에 Claude Code를 설치하고 Linux처럼 설정하세요.

curl -fsSL https://claude.ai/install.sh | bash

설정은 WSL 자체의 ~/.claude/settings.json에 두며, Windows의 %USERPROFILE%\.claude와는 별개입니다. 프로젝트는 WSL 파일 시스템(예: ~/project)에 두세요. /mnt/c보다 훨씬 빠릅니다.

더 많은 설정과 일상적인 명령은 Claude Code에서 볼 수 있습니다.