Skip to main content
Power Claude Code with Aihubmix and leave behind the headaches of unstable connections and hard-to-get quotas. Aihubmix’s relay service is built on official channels—fully compliant and secure—so there’s no need to worry about account risks or hidden restrictions.
Due to Claude Code’s multi-agent nature, credit consumption can be quite high. It’s recommended to set a limit for your key to avoid unexpected charges.

​
Quick Setup Guide:

​
1️⃣ Install the npm Package Globally

Run the following command in your terminal: 
npm install -g @anthropic-ai/claude-code
Example image: install

​
2️⃣ Configure Environment Variables

Go to Aihubmix Keys page to generate your API key, then add this key and the forwarding URL to your system environment variables. For example, add the following lines to your ~/.zshrc file: 
export ANTHROPIC_API_KEY="sk-***"
export ANTHROPIC_BASE_URL="https://aihubmix.com"
For Mac users, you can reveal the hidden .zshrc file in your home directory by pressing ⌘ + ⇧ + .. Open it with the system’s “TextEdit” app and add the above lines.
Skip manual environment variable configuration – use the graphical tool for quick setup: Configuration via CC-Switch.

​
3️⃣ Apply the Configuration

After adding the configuration, run source ~/.zshrc in your terminal and press Enter to apply the changes.

​
4️⃣ Launch in Terminal

Navigate to your project directory, for example cd ~/Desktop/my-project
Then type claude to start and begin using Claude Code.

​
Initialization Configuration

​
Authorization

If you see an authorization page, click to jump to the Claude website for confirmation. After successful authorization, return to the terminal to continue. auth If you’d like to skip the verification step and route requests through Aihubmix directly, just open the .claude.json file in your user directory and add this line: 
  "hasCompletedOnboarding": true,

​
Launch

After launching, Claude Code will display the current configuration details, including your API Key and API Base URL.
Confirm the prompts by selecting Yes and pressing Enter to complete the setup. initialization For example: Claude detects a custom KEY in the system environment variables — select Yes. 
Detected a custom API key in your environment

ANTHROPIC_API_KEY: sk-***
Do you want to use this API key?

> 1. Yes
2. No(recommended)

Enter to confirm .Esc to cancel

​
Switch Model

Use the Claude Code command: 
/model [model id]
The default model is Sonnet 4, but you can switch to a more powerful one like Opus 4:
opus
/model opus
Or, switch to another Claude model: 
/model claude-sonnet-4-5

​
Zhipu AI Support

/model <model id>
model id list:
  • cc-glm-4.6
  • cc-glm-4.5-air
  • cc-kimi-k2-instruct
  • cc-deepseek-v3.1
  • cc-deepseek-v3
  • cc-kimi-k2-instruct-0905
  • cc-kimi-dev-72b
  • cc-minimax-m2
  • cc-ernie-4.5-300b-a47b

​
Use Any LLM on the AiHubMix Platform

​
1️⃣ Install @aihubmix/claude-code globally

npm install -g @aihubmix/claude-code

export AIHUBMIX_API_KEY="your-aihubmix-api-key"
export HOST="127.0.0.1"  # Optional
export PORT="3456"       # Optional
export LOG="true"        # Optional
export API_TIMEOUT_MS="30000"  # Optional

​
3️⃣ Generate a configuration file

Note: Replace sk-*** with the key you generated on AiHubMix. Configuration options beyond the model itself will be overridden by system environment variables if present. 
mkdir -p ~/.aihubmix-claude-code && cat > ~/.aihubmix-claude-code/config.json <<EOF
{
  "API_KEY": "sk-***",
  "HOST": "127.0.0.1",
  "PORT": 3456,
  "LOG": true,
  "API_TIMEOUT_MS": 30000,
  "Router": {
    "default": "claude-sonnet-4-20250514",
    "background": "claude-3-5-haiku-20241022",
    "think": "claude-sonnet-4-20250514",
    "longContext": "gpt-4.1",
    "longContextThreshold": 60000,
    "webSearch": "gemini-2.0-flash-search"
  }
}
EOF

​
Configuration via CC-Switch

  1. Run CC-Switch and click “Add Provider.” install
  2. From the preset list, select “AiHubMix.” install
  3. Enter your API key in the “API Key” field. install
  4. Once the configuration is complete, click “Add” to save the settings. install
  5. Return to the home page, select “AiHubMix” from the vendor list, and click “Start” to begin using it. install

​
4️⃣ Usage

acc start
-Github -npm package Enjoy coding with Claude!