Claude Code

​

빠른 시작

​

1. Claude Code 설치

​

로컬 설치

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

​

npm으로 설치

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

​

2. AIHubMix API 구성

1. ANTHROPIC_BASE_URL을 https://aihubmix.com으로 설정합니다
2. ANTHROPIC_AUTH_TOKEN을 AIHubMix 플랫폼에서 받은 API Key로 설정합니다
3. ANTHROPIC_MODEL을 모델 목록에서 지원되는 Claude 모델로 설정합니다. 예: claude-sonnet-4-5

echo $SHELL

# <AIHUBMIX_API_KEY>를 AIHubMix에서 받은 실제 Key로 바꾸세요
echo 'export ANTHROPIC_BASE_URL="https://aihubmix.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="<AIHUBMIX_API_KEY>"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-4-5"' >> ~/.zshrc

source ~/.zshrc

echo $ANTHROPIC_BASE_URL
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"
echo $ANTHROPIC_MODEL

REM <AIHUBMIX_API_KEY>를 AIHubMix에서 받은 실제 Key로 바꾸세요
setx ANTHROPIC_AUTH_TOKEN "<AIHUBMIX_API_KEY>"
setx ANTHROPIC_BASE_URL "https://aihubmix.com"
setx ANTHROPIC_MODEL "claude-sonnet-4-5"

if defined ANTHROPIC_AUTH_TOKEN echo ANTHROPIC_AUTH_TOKEN is set
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_MODEL%

# <AIHUBMIX_API_KEY>를 AIHubMix에서 받은 실제 Key로 바꾸세요
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "<AIHUBMIX_API_KEY>", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://aihubmix.com", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-4-5", [EnvironmentVariableTarget]::User)

if ($env:ANTHROPIC_AUTH_TOKEN) { "ANTHROPIC_AUTH_TOKEN is set" }
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_MODEL

​

3. 구성 검증

curl https://aihubmix.com/v1/messages \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 16,
    "messages": [{"role": "user", "content": "1+1, 답만 출력"}]
  }'

claude -p "1+1, 답만 출력" --model claude-sonnet-4-5

​

4. 사용 시작

$ cd /path/your-project
> claude

1. 사용자 홈 디렉터리의 .claude.json 파일을 찾습니다.
   • macOS / Linux: ~/.claude.json
   • Windows: C:\Users\%USERNAME%\.claude.json
2. hasCompletedOnboarding 값을 true로 설정합니다.

{
  "hasCompletedOnboarding": true
}

3. 파일을 저장한 뒤 터미널에서 claude를 다시 실행합니다.

​

(선택) 추가 모델 구성 방법

1. 대화 중: /model <모델명> 명령으로 임시 전환합니다.

/model claude-sonnet-4-5

2. Claude Code 시작 시: claude --model <모델명>으로 단일 세션의 모델을 지정합니다.

claude --model claude-sonnet-4-5

3. 환경 변수: 작업 복잡도에 따라 모델 계층을 설정합니다.

export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"

• ANTHROPIC_DEFAULT_OPUS_MODEL: 복잡한 추론과 아키텍처 설계.
• ANTHROPIC_DEFAULT_SONNET_MODEL: 코딩과 기능 구현.
• ANTHROPIC_DEFAULT_HAIKU_MODEL: 간단한 검사, 파일 검색, 가벼운 작업.

4. settings.json: Claude Code 사용자 설정 파일(macOS/Linux는 ~/.claude/settings.json, Windows는 C:\Users\%USERNAME%\.claude\settings.json) 또는 프로젝트 설정에 작성합니다.

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "<AIHUBMIX_API_KEY>",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gemini-3.5-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME": "gemini-3.5-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gemini-3.5-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "gemini-3.5-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gemini-3.5-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "gemini-3.5-flash",
    "ANTHROPIC_MODEL": "gpt-5.5"
  },
  "model": "gpt-5.5"
}

​

CC Switch에서는 어떻게 구성하나요?

1. CC Switch를 실행하고 왼쪽에서 Claude Code를 선택한 뒤 “Add Vendor”를 클릭합니다.

2. preset 목록에서 “AiHubMix”를 선택합니다. Claude Code 쪽 Provider를 구성 중인지 확인하세요.

3. “API Key” 입력란에 실제 Key를 입력합니다.

4. 설정 후 먼저 claude-sonnet-4-5를 모델 ID로 사용하고 “Add”를 클릭해 저장합니다. health check가 통과하면 Claude Code에서 /models 또는 /model로 다른 Claude 모델로 전환할 수 있습니다.

5. 홈으로 돌아가 Provider 목록에서 “AiHubMix”를 선택하고 “Start”를 클릭합니다.

​

VS Code 플러그인에서는 어떻게 구성하나요?

1. VS Code를 실행하고 플러그인을 설치합니다.

2. Ctrl + Shift + P 또는 Cmd + Shift + P를 누르고 Settings를 입력합니다.

3. Claude Code를 검색하고 Claude Code: Environment Variable -> Edit in settings.json을 엽니다.

4. claudeCode.environmentVariables에 AIHubMix 정보를 입력합니다.

​

Wechat-Agent-SDK

설치 링크: https://github.com/AIhubmix/wechat-agent-sdk

​

FAQ

​

Q: 401 인증 오류가 표시되면 어떻게 해야 하나요?

• No token provided: Key가 전송되지 않았습니다. Claude Code에서 /config를 열고 Use custom API key의 Token 설정을 확인하세요.
• invalid key: AIHUBMIX_API_KEY: 예시 자리 표시자를 그대로 복사했을 가능성이 큽니다. AIHubMix 콘솔에서 실제 Key를 다시 복사하고 ANTHROPIC_AUTH_TOKEN을 업데이트하세요.
• this key is not enabled: 요청은 AIHubMix에 도달했지만 현재 Key가 활성화되지 않았거나 권한이 없습니다. AIHubMix 콘솔에서 Key 활성화 상태, 만료 여부, 잔액, 선택한 Claude 모델 호출 권한을 확인하세요.

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

​

Q: 400 Incorrect model ID 또는 Bad request (400)가 표시되면 어떻게 해야 하나요?

​

Q: macOS에서 설치 후에도 zsh: command not found: claude가 표시되면 어떻게 하나요?

1. 설치 경로를 확인합니다. 공식 스크립트는 보통 다음 중 하나에 설치됩니다.

• ~/.claude/bin
• ~/.local/bin

ls -l ~/.claude/bin
or
ls -l ~/.local/bin | grep claude

2. 설치 위치를 PATH에 추가합니다.

​

경우 A: ~/.claude/bin에 설치된 경우

echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

​

경우 B: ~/.local/bin에 설치된 경우

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

3. 확인합니다.

which claude
claude -v

​

Q: Claude Code가 Anthropic 서비스에 연결할 수 없으면 어떻게 하나요?

​

추가 리소스

• Github
• npm 패키지
• 공식 베스트 프랙티스
• 공식 설정 가이드