Claude Code 설치, API 설정 및 Windows 오류 해결

I Code Easy API Key로 Claude Code를 사용하려면 CLI를 설치한 뒤 ANTHROPIC_AUTH_TOKEN과 ANTHROPIC_BASE_URL을 설정하세요. 터미널을 새로 열고 프로젝트 폴더에서 claude를 실행합니다. Claude Desktop은 앱 안에서 Gateway를 별도로 설정하며, 방법은 아래에 안내합니다.

시작 전: 계정, 키, 모델

1. 회원가입 후 로그인하고 API Keys에서 이 사이트의 키를 복사하세요. 로그인 비밀번호를 입력하지 마세요.
2. 엔드포인트 선택에서 사용할 모델 계열의 엔드포인트를 선택하고 저장하세요. 자세한 절차는 시작하기에 있습니다.
3. 가격·잔액·사용량과 모델 기능에서 모델 ID, 이용 조건, 프로토콜 지원을 확인하세요. 클라이언트를 설치해도 API 잔액이나 모델 이용 권한이 생기지는 않습니다.

키는 본인의 클라이언트 설정에만 보관하세요. Git에 커밋하거나 공개 스크린샷에 포함하지 마세요. 노출되었다면 API Keys 페이지에서 키를 교체하세요.

1단계: Claude Code 설치

네이티브 설치와 npm 중 하나를 선택하세요. npm에 필요한 Node.js와 터미널 준비는 환경 설정을 참고하세요.

MacOS / Linux / WSL

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

Windows PowerShell

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

Windows CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

네이티브 설치 프로그램은 백그라운드에서 Claude Code를 자동 업데이트합니다.

npm 설치(환경 설정 완료 후)

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

2단계: API 설정

아래 환경 변수는 Claude Code CLI 전용입니다. Desktop은 이 ANTHROPIC_BASE_URL이나 CLI의 settings.json을 읽지 않으므로 아래의 별도 설정을 사용하세요.

Linux / MacOS

다음 명령은 현재 shell에 적용됩니다. 계속 사용하려면 해당 shell의 ~/.bashrc 또는 ~/.zshrc에 추가하세요. 키 자리표시자는 본인의 API Key로 바꾸세요:

export ANTHROPIC_AUTH_TOKEN="your API Key"
export ANTHROPIC_BASE_URL="https://api.icodeeasy.cc"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

CLAUDE_CODE_ATTRIBUTION_HEADER=0으로 설정하지 마세요. 일부 Claude Code 전용 채널은 클라이언트의 원래 attribution 메타데이터를 검증합니다.

현재 네트워크에서 api.icodeeasy.cc가 느리면 ANTHROPIC_BASE_URL을 https://jp.icodeeasy.cc 또는 https://sg.icodeeasy.cc로 변경하세요.

파일을 저장한 뒤 source ~/.bashrc 또는 source ~/.zshrc를 실행합니다.

Windows

PowerShell에서 실행합니다:

# Set API key
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your API Key", "User")

# Set API base URL
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.icodeeasy.cc", "User")

# Disable non-essential traffic
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", "User")

현재 네트워크에서 api.icodeeasy.cc가 느리면 ANTHROPIC_BASE_URL을 https://jp.icodeeasy.cc 또는 https://sg.icodeeasy.cc로 변경하세요.

환경 변수를 설정한 뒤 새 PowerShell 창을 여세요.

새 창에서 사용자 수준 환경 변수를 확인합니다:

-not [string]::IsNullOrWhiteSpace([Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "User"))
[Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", "User")
[Environment]::GetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "User")

SetEnvironmentVariable은 영구 사용자 수준 환경 변수를 기록합니다. 현재 PowerShell 세션은 업데이트하지 않으므로 claude를 시작하기 전에 새 PowerShell 창을 여세요.

CLI 프로세스가 읽을 설정 확인

macOS / Linux / WSL에서는 키를 출력하지 않고 존재 여부만 확인합니다:

[ -n "$ANTHROPIC_AUTH_TOKEN" ] && echo "Token configured" || echo "Token missing"
printf '%s\n' "$ANTHROPIC_BASE_URL"

Windows에서는 새 PowerShell 창에서 프로세스 환경 변수를 확인하세요:

-not [string]::IsNullOrWhiteSpace($env:ANTHROPIC_AUTH_TOKEN)
$env:ANTHROPIC_BASE_URL

첫 번째 결과는 True, 주소는 선택한 도메인이어야 합니다. 사용자 변수에는 키가 있지만 여기서 False가 나오면 실행 환경이 아직 갱신되지 않은 것입니다. IDE 터미널은 편집기 시작 시점의 값을 상속할 수 있으므로 필요하면 편집기까지 완전히 종료하고 다시 여세요.

WSL은 Linux 환경입니다. Windows PowerShell에서 변수를 저장했더라도 WSL shell에서는 Linux 절차로 따로 설정하세요. Base URL에는 도메인만 입력하고 /v1/messages 요청 경로를 붙이지 마세요.

3단계: Claude Code 시작

먼저 터미널에서 설치된 버전을 확인하세요:

claude --version

cd your-project-folder
claude

실행 후 /status를 입력하여 현재 모델, 계정, 인증 정보 출처와 Gateway URL을 확인하세요. 설정 확인용이며 실제 요청 성공을 검증하는 절차를 대신하지는 않습니다.

짧은 질문 하나를 보내 응답을 확인한 뒤 요청 로그에서 모델, 상태, 사용량을 확인하세요. 설치 완료, CLI 실행 또는 키 존재 여부만으로 API 요청 성공을 확인할 수는 없습니다.

Claude Code 문제 해결

대체 주소는 https://jp.icodeeasy.cc, https://sg.icodeeasy.cc이며 같은 사이트 키를 사용합니다. 도메인 변경은 연결 복구 절차로, 계정이나 모델을 바꾸는 설정이 아닙니다. 자세한 내용은 연결 및 복구를 참고하세요.

문의할 때는 클라이언트 버전, OS, 베이징 시간, 민감 정보를 지운 오류 본문과 요청 식별자를 보내세요. API Key나 전체 환경 변수 덤프를 보내지 마세요.

Claude Code에서 Kimi 또는 GLM 사용

클라이언트, API 주소, 모델 이름은 각각 별도 설정입니다. Base URL만 설정하면 Kimi나 GLM이 자동 선택되지 않습니다. Kimi 설정 또는 GLM 설정에 따라 모델을 설정하고 실행 후 선택을 확인하세요. 현재 조건은 각 가이드와 모델 기능 목록을 참고하세요.

Claude Desktop 설정

Claude Desktop은 Developer Mode를 통해 서드파티 릴레이에 연결할 수 있습니다.

Desktop은 별도의 third-party inference 설정을 사용하며 위 CLI 환경 변수를 상속하지 않습니다. 메뉴 제공 여부는 설치 버전에 따라 다릅니다. 모델 이용에는 사이트 목록과 엔드포인트 조건도 적용되며, 모델 이름 입력만으로 호환성이 검증되는 것은 아닙니다.

Developer Mode 활성화

메뉴 바에서 Help -> Troubleshooting -> Enable Developer mode를 클릭한 뒤 Claude Desktop을 다시 시작합니다.

릴레이 설정

다시 시작한 뒤 메뉴 바에서 Developer -> Configure third-party inference를 클릭하고 다음을 입력합니다:

현재 네트워크에서 api.icodeeasy.cc가 느리면 Base URL을 https://jp.icodeeasy.cc 또는 https://sg.icodeeasy.cc로 변경하세요.

모델 설정

claude-opus-5-5, claude-sonnet-5-5처럼 사용할 모델 이름을 입력하고 저장한 뒤 Claude Desktop을 다시 시작합니다. Claude 모델은 Claude 계열 엔드포인트를 사용할 수 있습니다.

Kimi와 GLM의 모델 설정은 Kimi 설정과 GLM 설정을 참고하세요. Claude Fable 5를 고정해서 사용하려면 Claude Fable 5 가이드를 참고하세요.

공식 참고 자료

• 설치 및 업데이트
• 환경 변수
• 모델 설정
• 서드파티 Gateway 및 Desktop