Claude Code

​

1. Claude Code 설치

​

로컬 설치

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

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

​

npm으로 설치

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

​

2. Harogo API 설정

1. ANTHROPIC_BASE_URL을 https://api.harogo.ai/로 설정합니다
2. ANTHROPIC_AUTH_TOKEN을 Harogo 플랫폼에서 발급받은 API 키로 설정합니다
3. ANTHROPIC_MODEL을 Harogo에서 지원하는 Claude 모델(예: claude-sonnet-5)로 설정합니다.

echo $SHELL

# <HAROGO_API_KEY>를 Harogo 플랫폼에서 발급받은 실제 키로 바꾸세요
echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="<HAROGO_API_KEY>"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.zshrc

# <HAROGO_API_KEY>를 Harogo 플랫폼에서 발급받은 실제 키로 바꾸세요
echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="<HAROGO_API_KEY>"' >> ~/.bash_profile
echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.bash_profile

source ~/.zshrc

source ~/.bash_profile

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

REM <HAROGO_API_KEY>를 Harogo 플랫폼에서 발급받은 실제 키로 바꾸세요
setx ANTHROPIC_AUTH_TOKEN "<HAROGO_API_KEY>"
setx ANTHROPIC_BASE_URL "https://api.harogo.ai"
setx ANTHROPIC_MODEL "claude-sonnet-5"

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

# <HAROGO_API_KEY>를 Harogo 플랫폼에서 발급받은 실제 키로 바꾸세요
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "<HAROGO_API_KEY>", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.harogo.ai", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-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://api.harogo.ai/v1/messages \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 16,
    "messages": [{"role": "user", "content": "1+1, output only the answer"}]
  }'

curl.exe https://api.harogo.ai/v1/messages `
  -H "content-type: application/json" `
  -H "anthropic-version: 2023-06-01" `
  -H "x-api-key: $env:ANTHROPIC_AUTH_TOKEN" `
  -d "{\"model\":\"claude-sonnet-5\",\"max_tokens\":16,\"messages\":[{\"role\":\"user\",\"content\":\"1+1, output only the answer\"}]}"

​

4. Claude Code 사용 시작

$ 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-name> 명령을 실행해 모델을 전환합니다. 일시적으로 전환할 때 적합합니다.

/model claude-sonnet-5

2. Claude Code 시작 시: claude --model <model-name>을 실행해 모델을 지정합니다. 단일 세션에 적합합니다.

claude --model claude-sonnet-5

3. 환경 변수 설정: 작업 복잡도에 따라 서로 다른 등급의 모델을 설정해 두면 Claude Code가 작업에 맞는 모델을 자동으로 선택합니다. 전역으로 적용됩니다.

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

• ANTHROPIC_DEFAULT_OPUS_MODEL: 복잡한 추론, 아키텍처 설계 등 고난도 작업용.
• ANTHROPIC_DEFAULT_SONNET_MODEL: 코드 작성, 기능 구현 등 일상적인 작업용.
• ANTHROPIC_DEFAULT_HAIKU_MODEL: 문법 검사, 파일 검색 등 간단한 작업용.

4. settings.json에 영구 설정: Claude Code의 사용자 설정 파일(예: ~/.claude/settings.json, Windows에서는 C:\Users\%USERNAME%\.claude\settings.json) 또는 프로젝트 수준 설정에 모델 설정을 기록하면 사용자 수준 또는 프로젝트 수준에서 영구적으로 설정할 수 있습니다.

​

CC Switch로 설정하기

1. CC Switch를 실행하고 왼쪽에서 Claude Code를 선택한 다음 “제공업체 추가”(Add Provider)를 클릭합니다.

2. 프리셋 목록에서 제공업체로 “사용자 지정 설정”(Custom Configuration)을 선택합니다.

3. 제공업체 이름, API 키, 엔드포인트(https://api.harogo.ai) 등을 입력합니다. 모두 입력했다면 “추가”(Add)를 클릭합니다.

4. 홈 화면으로 돌아가 제공업체 목록에서 “harogo”를 선택하고 “사용”(Use)을 클릭합니다.

팁: 터미널에서 Claude Code를 연 뒤 /status를 입력하면 모델 ID를 확인할 수 있고, /models를 입력하면 설정해 둔 다른 모델을 선택할 수 있습니다.