Claude Code with any LLM

Power Claude Code with any large model on the Aihubmix platform, completely eliminating connection instability and quota purchase difficulties.

1. 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.
2. Make sure your local VPN is disabled during use, otherwise you might experience lag with GPT-5.5.

Anthropic’s official documentation states that Claude Code does not support routing non-Claude models through a gateway, so this setup is a usage that the official documentation does not support. If you only need Claude models on AIHubMix, see the Claude Code integration guide. For the Anthropic-compatible interface on AIHubMix, see Anthropic-Compatible API.

​

Quick Configuration Guide

​

1️⃣ Install Claude Code

acc code requires the claude command, so install Claude Code first. On macOS / Linux, run in terminal:

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

On Windows, run in PowerShell:

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

To install Claude Code with npm instead, Node.js 22 or later is required.

​

2️⃣ Global npm Package Installation

Run in terminal:

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

​

3️⃣ 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 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.

On Windows, run the following command in PowerShell to set the user-level environment variable, then reopen your terminal:

[Environment]::SetEnvironmentVariable("AIHUBMIX_API_KEY", "sk-***", "User")

​

4️⃣ 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.5",
    "background": "claude-haiku-5-5",
    "think": "gpt-5.5",
    "longContext": "gpt-5.5",
    "longContextThreshold": 60000,
    "webSearch": "gemini-3-flash-preview-search"
  }
}
EOF

Optional settings:

Setting	Description
AIHUBMIX_BASE_URL (environment variable) or BASE_URL (config.json)	Optional. The AIHubMix API domain. Default: https://aihubmix.com. Enter the domain only, without /v1.

​

5️⃣ Usage

Start Service

acc start

​

More Resources

• Claude Code Forwarding
• Github
• npm Package
• Official Best Practices
• Official Configuration Guide
• Claude Code: A Highly Agentic Coding Assistant

---

Last updated: 2026-10-17