AiHubMix Documentation Hub

Due to Claude Code’s multi-agent nature, quota consumption can be quite significant. It’s recommended to set limited quotas for your Key to prevent billing surprises.
Make sure your local VPN is disabled during use, otherwise you might experience lag with GPT-5.

Quick Configuration Guide

1️⃣ Global npm Package Installation

Run in terminal:

npm install -g @aihubmix/claude-code@latest

2️⃣ Set System Environment Variables (Recommended)

Replace sk-*** with your API key generated on AiHubMix. Configuration items other than models will be processed with system environment variables taking priority.

export AIHUBMIX_API_KEY="sk-***"
export HOST="127.0.0.1"  # Optional
export PORT="3456"        # Optional
export LOG="true"         # Optional
export API_TIMEOUT_MS="30000"  # Optional

For Mac users, you can navigate to your username directory and press ⌘ + ⇧ + . to show the hidden .zshrc file, then open it with the system’s “TextEdit” app and add the above content.
After adding the configuration, run source ~/.zshrc in terminal and press enter to make the configuration effective.

3️⃣ Generate Configuration File

Replace sk-*** below with your AiHubMix API key, then run this one-liner in terminal:

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": "gpt-5",
    "background": "claude-3-5-haiku-20241022",
    "think": "gpt-5",
    "longContext": "gpt-5",
    "longContextThreshold": 60000,
    "webSearch": "gemini-2.0-flash-search"
  }
}
EOF

4️⃣ Usage

acc start

acc stop

acc code

acc restart

acc status

acc help

acc version

More Resources

Last updated: 2026-06-01

Getting Started

Gateway Features

Model Capabilities

Protocol Reference

Platform Management

Privacy & Terms

Claude Code with any LLM

Quick Configuration Guide

1️⃣ Global npm Package Installation

2️⃣ Set System Environment Variables (Recommended)

3️⃣ Generate Configuration File

4️⃣ Usage

More Resources

​Quick Configuration Guide

​1️⃣ Global npm Package Installation

​2️⃣ Set System Environment Variables (Recommended)

​3️⃣ Generate Configuration File

​4️⃣ Usage

​More Resources

Quick Configuration Guide

1️⃣ Global npm Package Installation

2️⃣ Set System Environment Variables (Recommended)

3️⃣ Generate Configuration File

4️⃣ Usage

More Resources