Claude Code

1. Install Claude Code

Local Installation

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

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

Install via npm

Requires Node.js 18 or later

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

2. Configure the Harogo API

To connect to Harogo’s model service through the Anthropic-compatible API, set the following environment variables.

Set ANTHROPIC_BASE_URL to https://api.harogo.ai/
Set ANTHROPIC_AUTH_TOKEN to the API key you got from the Harogo platform
Set ANTHROPIC_MODEL to a Claude model supported by Harogo, for example claude-sonnet-5.

macOS
Windows

Run the following command in your terminal to check your default shell.

echo $SHELL

Set the environment variables based on your shell type:

# Replace <HAROGO_API_KEY> with the real key from your Harogo platform
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

# Replace <HAROGO_API_KEY> with the real key from your Harogo platform
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

Run the following command in your terminal to apply the environment variables.

source ~/.zshrc

source ~/.bash_profile

Open a new terminal and run the following commands to confirm the environment variables took effect.

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

On Windows, you can set Harogo’s base URL and API key as environment variables using either CMD or PowerShell.

CMD
PowerShell

Run the following command in CMD to set the environment variables.

REM Replace <HAROGO_API_KEY> with the real key from your Harogo platform
setx ANTHROPIC_AUTH_TOKEN "<HAROGO_API_KEY>"
setx ANTHROPIC_BASE_URL "https://api.harogo.ai"
setx ANTHROPIC_MODEL "claude-sonnet-5"

Open a new CMD window and run the following commands to confirm the environment variables took effect.

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

Run the following command in PowerShell to set the environment variables.

# Replace <HAROGO_API_KEY> with the real key from your Harogo platform
[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)

Open a new PowerShell window and run the following commands to confirm the environment variables took effect.

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

If you’re going to manage Claude Code through CC Switch, we recommend not also setting global ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL, or ANTHROPIC_MODEL values. System- or user-level environment variables can override the provider config CC Switch writes, so the UI shows the correct provider selected while Claude Code is still actually running on an old key or model.

3. Verify the Configuration

After setting up environment variables or CC Switch, send one minimal request first to confirm the key, model, and Anthropic-compatible endpoint are all working, before starting a longer session.

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. Start Using Claude Code

Once configured, go to your working directory and run the claude command in your terminal to get started.

$ cd /path/your-project
> claude

If you see Not logged in · Please run /login on startup, or you’re dropped into the Anthropic login flow, it usually means Claude Code didn’t pick up a working Harogo configuration, or first-time onboarding hasn’t been completed. First confirm the minimal request from the previous step returns 2, and check whether ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL, or ANTHROPIC_MODEL are being overridden by old global environment variables. Once you’ve confirmed the key works, if you’re still sent to the login flow, you can skip first-time onboarding with the steps below:

Terminal showing the login-or-continue prompt on Claude Code's first launch

Locate the .claude.json file in your home directory:
- macOS / Linux: ~/.claude.json
- Windows: C:\Users\%USERNAME%\.claude.json
Set the hasCompletedOnboarding field to true

{
  "hasCompletedOnboarding": true
}

Save the file, then run claude again in your terminal.

(Optional) More Ways to Configure the Model

Claude Code supports the following ways to configure the model, listed from highest to lowest priority — a higher-priority setting overrides a lower-priority one.

During a conversation: run the /model <model-name> command to switch models. Good for a one-off switch.

/model claude-sonnet-5

When starting Claude Code: run claude --model <model-name> to specify a model. Good for a single session.

claude --model claude-sonnet-5

Set environment variables: configure different tiers of models by task complexity, and Claude Code will automatically pick the right one for the task. Applies globally.

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

Where:

ANTHROPIC_DEFAULT_OPUS_MODEL: for complex reasoning, architecture design, and other high-difficulty tasks.
ANTHROPIC_DEFAULT_SONNET_MODEL: for writing code, implementing features, and other everyday tasks.
ANTHROPIC_DEFAULT_HAIKU_MODEL: for syntax checks, file search, and other simple tasks.

Set permanently in settings.json: write the model configuration into Claude Code’s user config file (e.g. ~/.claude/settings.json, or C:\Users\%USERNAME%\.claude\settings.json on Windows) or into a project-level config, for a permanent user-level or project-level setting.

Configuring via CC Switch

Launch CC Switch, select Claude Code on the left, then click “Add Provider.”

Add Provider entry point on the CC Switch home screen

From the preset list, choose “Custom Configuration” as the provider.

Selecting AiHubMix in the CC Switch provider preset list

Fill in the provider name, API key, and endpoint (https://api.harogo.ai), etc. Once everything is filled in, click “Add.”

Entering the API key on the CC Switch AiHubMix configuration form

Back on the home screen, select “harogo” from the provider list and click “Use.”

Selecting AiHubMix and clicking Launch on the CC Switch home screen

Tip: once Claude Code is open in your terminal, type /status to check the model ID, or /models to pick another configured model.

If CC Switch shows “System environment variable conflict detected,” deal with ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL, and ANTHROPIC_MODEL first. These global variables override the current provider config — a placeholder value like ANTHROPIC_AUTH_TOKEN=AIHUBMIX_API_KEY will cause authentication to fail outright. Once you’re sure you no longer need the global variables, remove the conflicting entries in CC Switch, or manually delete the system/user environment variables and restart your terminal.

Getting Started

Quick Started

1. Install Claude Code

Local Installation

Install via npm

2. Configure the Harogo API

3. Verify the Configuration

4. Start Using Claude Code

(Optional) More Ways to Configure the Model

Configuring via CC Switch

​1. Install Claude Code

​Local Installation

​Install via npm

​2. Configure the Harogo API

​3. Verify the Configuration

​4. Start Using Claude Code

​(Optional) More Ways to Configure the Model

​Configuring via CC Switch

1. Install Claude Code

Local Installation

Install via npm

2. Configure the Harogo API

3. Verify the Configuration

4. Start Using Claude Code

(Optional) More Ways to Configure the Model

Configuring via CC Switch