Claude Code

Quick Start

This guide will help you get started with Claude Code provided by AIHubMix in just a few minutes.

1. Install Claude Code

Local Installation

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

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

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

winget install Anthropic.ClaudeCode

brew install --cask claude-code

The first three are the official native installers and update automatically in the background. WinGet and Homebrew installations do not update automatically, so run winget upgrade Anthropic.ClaudeCode or brew upgrade claude-code periodically.

Install via npm

You need Node.js version 22 or higher.

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

2. Configure AIHubMix API

To access AIHubMix’s model services via the compatible Anthropic API, you need to configure the following environment variables.

Set ANTHROPIC_BASE_URL to https://aihubmix.com
Set ANTHROPIC_AUTH_TOKEN to the API Key obtained from the AIHubMix platform
Set ANTHROPIC_MODEL to a supported Claude model from the model list, such as claude-sonnet-5-5.

AIHUBMIX_API_KEY is only a placeholder. Replace it with your real key, usually starting with sk-. If you copy it as-is, Claude Code will treat it as the actual key and return 401 invalid key: AIHUBMIX_API_KEY.

macOS
Windows

Run the following command in the terminal to check your default Shell type.

echo $SHELL

Set the environment variables according to your Shell type using the following commands:

# Replace <AIHUBMIX_API_KEY> with your real key from AIHubMix
echo 'export ANTHROPIC_BASE_URL="https://aihubmix.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="<AIHUBMIX_API_KEY>"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-5-5"' >> ~/.zshrc

# Replace <AIHUBMIX_API_KEY> with your real key from AIHubMix
echo 'export ANTHROPIC_BASE_URL="https://aihubmix.com"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="<AIHUBMIX_API_KEY>"' >> ~/.bash_profile
echo 'export ANTHROPIC_MODEL="claude-sonnet-5-5"' >> ~/.bash_profile

Run the following command in the terminal to make the environment variables effective.

source ~/.zshrc

source ~/.bash_profile

Open a new terminal and run the following commands to check if the environment variables are effective.

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

In Windows, you can set the AIHubMix Base URL and API Key as environment variables using CMD or PowerShell.

CMD
PowerShell

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

REM Replace <AIHUBMIX_API_KEY> with your real key from AIHubMix
setx ANTHROPIC_AUTH_TOKEN "<AIHUBMIX_API_KEY>"
setx ANTHROPIC_BASE_URL "https://aihubmix.com"
setx ANTHROPIC_MODEL "claude-sonnet-5-5"

Open a new CMD window and run the following commands to check if the environment variables are effective.

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 <AIHUBMIX_API_KEY> with your real key from AIHubMix
[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-5-5", [EnvironmentVariableTarget]::User)

Open a new PowerShell window and run the following commands to check if the environment variables are effective.

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

If you plan to manage Claude Code through CC Switch, avoid setting global ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL, or ANTHROPIC_MODEL separately. System or user environment variables may override the Provider configuration written by CC Switch, so Claude Code may still use an old key or model even when the correct Provider is selected in the UI.

3. Verify the Configuration

After configuring environment variables or CC Switch, run a minimal request first to confirm that the key, model, and Anthropic-compatible endpoint are available before starting a long session.

curl https://aihubmix.com/v1/messages \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 16,
    "messages": [{"role": "user", "content": "1+1, output only the answer"}]
  }'

$body = @{
  model = "claude-sonnet-5-5"
  max_tokens = 16
  messages = @(@{ role = "user"; content = "1+1, output only the answer" })
} | ConvertTo-Json -Depth 5

$response = Invoke-RestMethod -Uri "https://aihubmix.com/v1/messages" -Method Post `
  -ContentType "application/json" `
  -Headers @{ "anthropic-version" = "2023-06-01"; "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN" } `
  -Body $body
$response.content[0].text

If the request returns 200 and the content is 2, your AIHubMix key and Claude model are available. Then run:

claude -p "1+1, output only the answer" --model claude-sonnet-5-5

If it returns 2, Claude Code is configured successfully end to end.

4. Get Started

Once the configuration is complete, navigate to your working directory and run the claude command in the terminal to start using Claude Code.

$ cd /path/your-project
> claude

If startup shows Not logged in · Please run /login, or opens Anthropic login options, Claude Code has not read your AIHubMix key.

Claude Code terminal screen showing first-run login or setup options

Check the following in order:

Confirm that the minimal request in the previous step returns 2.
Confirm that ANTHROPIC_AUTH_TOKEN is set where Claude Code can read it at startup: a terminal environment variable, or the env block in ~/.claude/settings.json. After adding it to a profile such as ~/.zshrc, open a new terminal before running claude. If it is set only in the project’s .claude/settings.json or .claude/settings.local.json, it takes effect only after first-run onboarding and the trust-folder prompt are complete, so the first launch still shows the login screen.
Check whether ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL, or ANTHROPIC_MODEL is being overridden by old global environment variables.

After making these changes, run claude again in the terminal.

(Optional) Additional Model Configuration Methods

Claude Code supports the following model configuration methods, ranked in order of priority from highest to lowest, where higher-priority configurations will override lower-priority ones.

During a conversation: Execute the /model <model_name> command to switch models. The selected model is saved as the default for new sessions. To switch for the current session only, type /model to open the model list and press s on the target model. If ANTHROPIC_MODEL is set, new sessions still use the model specified by that variable.

/model claude-sonnet-5-5

When starting Claude Code: Execute claude --model <model_name> to specify the model. This is suitable for single-session use.

claude --model claude-sonnet-5-5

Set the ANTHROPIC_MODEL environment variable: This applies globally.

export ANTHROPIC_MODEL="claude-sonnet-5-5"

Permanently set in the settings.json configuration file: Write the model field in the Claude Code user settings file, such as ~/.claude/settings.json on macOS/Linux or C:\Users\%USERNAME%\.claude\settings.json on Windows, or in a project-level configuration. This sets the model permanently at the user level or project level. When ANTHROPIC_MODEL is set, the model field does not take effect.

ANTHROPIC_DEFAULT_FABLE_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, and ANTHROPIC_DEFAULT_HAIKU_MODEL specify the model IDs for the fable, opus, sonnet, and haiku aliases. They are not part of the priority order above. The main conversation always uses the currently selected model.

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

Where:

ANTHROPIC_DEFAULT_FABLE_MODEL: The model for the fable alias.
ANTHROPIC_DEFAULT_OPUS_MODEL: The model for the opus alias. opusplan also uses this model in Plan mode.
ANTHROPIC_DEFAULT_SONNET_MODEL: The model for the sonnet alias. opusplan uses this model outside Plan mode.
ANTHROPIC_DEFAULT_HAIKU_MODEL: The model for the haiku alias. Claude Code background tasks also use this model.

When the same variable is set both in the terminal environment and in the env section of settings.json, the value in settings.json takes precedence. If the model you set in the terminal does not take effect, check whether ANTHROPIC_MODEL is set in the env section of settings.json.

You can also put all of your AIHubMix settings in the env section of ~/.claude/settings.json, for example:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "<AIHUBMIX_API_KEY>",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
  }
}

Replace <AIHUBMIX_API_KEY> with your real key. After saving, restart Claude Code and enter /model to check the models available for the current session.

How to Configure via CC Switch?

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

CC Switch homepage showing the Add Provider button

Select “AiHubMix” from the preset list. Make sure you are configuring the Provider for Claude Code.

CC Switch provider list with AiHubMix selected

Enter your real key in the “API Key” field.

CC Switch AiHubMix configuration form with API Key field

Scroll down to “Model Mapping”. In the Sonnet, Opus, and Haiku rows, enter claude-sonnet-5-5, claude-opus-5-5, and claude-haiku-5-5 respectively in both “Display name” and “Requested model”, and leave the other rows empty. Set “Default fallback model” to claude-sonnet-5-5. Click “Add” to save the settings. You can then switch between these models in Claude Code with /model.
Return to the homepage and click the ▷ button (Switch) on the right side of the “AiHubMix” card. When the card shows “In use”, Claude Code is using this provider.

CC Switch homepage with AiHubMix shown as in use

If CC Switch shows a system environment variable conflict, handle ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL, and ANTHROPIC_MODEL first. These global variables can override the current Provider configuration. Placeholder values such as ANTHROPIC_AUTH_TOKEN=AIHUBMIX_API_KEY will directly cause authentication failures. After confirming you no longer need the global variables, delete the conflicting items in CC Switch or remove the system/user environment variables manually, then restart the terminal.

How to Configure through the VS Code Plugin?

Run VS Code and install the plugin.

VS Code Extensions view installing the Claude Code plugin

Press Ctrl + Shift + P (or Cmd + Shift + P), type Settings to open the settings.

VS Code command palette opening Settings

Search for Claude Code, find Claude Code: Environment Variable → Edit in settings.json.

VS Code settings search for Claude Code environment variables

Fill in the AIHubMix settings in claudeCode.environmentVariables, and set claudeCode.disableLoginPrompt to true to skip the extension’s login prompt.

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://aihubmix.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-***" },
    { "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5-5" }
  ],
  "claudeCode.disableLoginPrompt": true
}

VS Code settings.json example for Claude Code environment variables

FAQ

Q: What should I do if I get a `401` authentication error?

401 means the request did not pass authentication, but the exact cause depends on the full error message:

no key provided: the request did not include a key. Open Claude Code, enter /status, and confirm that the Anthropic base URL line shows https://aihubmix.com and that the Auth token or API key line shows a variable name such as ANTHROPIC_AUTH_TOKEN.
invalid key: AIHUBMIX_API_KEY: this usually means the placeholder from the example was copied as-is. Copy your real key again from the AIHubMix console and update ANTHROPIC_AUTH_TOKEN.
this key is not enabled: the request reached AIHubMix, but the current key is not enabled or does not have permission. Check whether the key is enabled, expired, has quota, and can call the selected Claude model in the AIHubMix console.

On Windows, also check whether old values remain in user or system environment variables:

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

If you use CC Switch to manage configuration, delete these global ANTHROPIC_* variables so the current Provider in CC Switch can take over. Note: /v1/models may return a model list even without a valid key, so do not use it to determine whether the key is usable. Use the minimal message request in “Verify the Configuration” above. If it returns 200 and the content is 2, the key and model are usable. Then restart Claude Code or restart it through CC Switch.

Q: What should I do if I get `400 Incorrect model ID` or `Bad request (400)`?

This usually means the request reached the provider side, but the model ID is incorrect, the model name does not match the interface, or the current key does not have permission to call that model. Copy the full model ID again from the AIHubMix model list, and make sure there are no manual spelling, capitalization, or model-family mistakes. If you configure through CC Switch, return to the corresponding Provider, update the model ID, save it, and restart Claude Code. If the error persists, first use a Claude model confirmed available in the model list to complete the health check, then switch to the target model.

Q: After successfully installing on macOS, I still get an error: `zsh: command not found: claude`

This is because the Claude CLI is installed, but its executable directory is not added to the system PATH.

Confirm the Claude installation path. The official install script installs claude to the following location:

macOS / Linux: ~/.local/bin/claude
Windows: %USERPROFILE%\.local\bin\claude.exe

Run the following command in the terminal:

ls -l ~/.local/bin/claude

If you see the claude file, it means the installation was successful, but the PATH is not configured.

Add the installation directory to the PATH:

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

Verify if it takes effect. Execute:

which claude
claude -v

If you can see the claude path and version number, the installation was successful.

Q: Claude Code Unable to Connect to Anthropic Services

After upgrading to the latest version of Claude Code, if you encounter issues connecting to Anthropic services or authentication failures, first check that the authentication variable is configured correctly. Claude Code supports two authentication variables: ANTHROPIC_AUTH_TOKEN sends the key in the Authorization: Bearer request header, and ANTHROPIC_API_KEY sends the key in the x-api-key request header. AIHubMix accepts both, and this document uses ANTHROPIC_AUTH_TOKEN throughout. For specific instructions, please refer to this document for reconfiguration.

More Resources

Happy coding!

Last updated: 2026-10-20

Coding Agents

IDE Integrations

Agent / Workflow

SDKs & Frameworks

Quick Start

1. Install Claude Code

Local Installation

Install via npm

2. Configure AIHubMix API

3. Verify the Configuration

4. Get Started

(Optional) Additional Model Configuration Methods

How to Configure via CC Switch?

How to Configure through the VS Code Plugin?

FAQ

Q: What should I do if I get a `401` authentication error?

Q: What should I do if I get `400 Incorrect model ID` or `Bad request (400)`?

Q: After successfully installing on macOS, I still get an error: `zsh: command not found: claude`

Q: Claude Code Unable to Connect to Anthropic Services

More Resources

Happy coding!

​Quick Start

​1. Install Claude Code

​Local Installation

​Install via npm

​2. Configure AIHubMix API

​3. Verify the Configuration

​4. Get Started

​(Optional) Additional Model Configuration Methods

​How to Configure via CC Switch?

​How to Configure through the VS Code Plugin?

​FAQ

​Q: What should I do if I get a 401 authentication error?

​Q: What should I do if I get 400 Incorrect model ID or Bad request (400)?

​Q: After successfully installing on macOS, I still get an error: zsh: command not found: claude

​Q: Claude Code Unable to Connect to Anthropic Services

​More Resources

​Happy coding!

Quick Start

1. Install Claude Code

Local Installation

Install via npm

2. Configure AIHubMix API

3. Verify the Configuration

4. Get Started

(Optional) Additional Model Configuration Methods

How to Configure via CC Switch?

How to Configure through the VS Code Plugin?

FAQ

Q: What should I do if I get a `401` authentication error?

Q: What should I do if I get `400 Incorrect model ID` or `Bad request (400)`?

Q: After successfully installing on macOS, I still get an error: `zsh: command not found: claude`

Q: Claude Code Unable to Connect to Anthropic Services

More Resources

Happy coding!