Claude Code / Claude Desktop 설정

Anthropic 공식 CLI 도구와 데스크톱 클라이언트는 모두 릴레이 서비스를 통해 연결할 수 있습니다.

MacOS 사용자는 더 나은 터미널 경험을 위해 iTerm2 사용을 권장합니다.

1단계: Claude Code 설치

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 설정

Linux / MacOS

다음 내용을 ~/.bashrc 또는 ~/.zshrc에 추가합니다. 기본 추천 모델은 kimi-k2.7입니다:

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

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

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

Windows

PowerShell에서 실행합니다:

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

# Set relay 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")

# Disable attribution header
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_ATTRIBUTION_HEADER", "0", "User")

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

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

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

[Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "User")
[Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", "User")
[Environment]::GetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "User")
[Environment]::GetEnvironmentVariable("CLAUDE_CODE_ATTRIBUTION_HEADER", "User")

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

3단계: Claude Code 시작

cd your-project-folder
claude

Claude Desktop 설정

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

Developer Mode 활성화

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

릴레이 설정

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

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

모델 설정

claude-sonnet-4-6, kimi-k2.7, glm-5.2처럼 사용할 모델 이름을 입력하고 저장한 뒤 Claude Desktop을 다시 시작합니다.