Claude Code

Install Node.js (Skip if installed)

Ensure Node.js version ≥ 18.0

Windows
macOS
Ubuntu / Debian

Download: https://nodejs.org/dist/v22.18.0/node-v22.18.0-x64.msi

sudo xcode-select --install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install node
node --version

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs
node --version

Uninstall Other Relay Clients (Optional)

Check installation location:

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

To uninstall:

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

Install Claude Code

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

Verify the installation:

claude --version

Get Credentials

Smart Routing Node
Traditional Node

Smart Routing is an intelligent model routing capability that automatically assigns requests to the most suitable model based on task complexity.See constraints and guidelines

base_url = "https://api.mixroute.ai"
api_key = "smart_routing-sk-xxxxx"
model = "auto"

NoteClaude Code cannot connect to models that do not use the \v1\messages protocol. When using Smart Routing, all routing tiers must use Claude-family models.For example, use claude-haiku-4.5, claude-sonnet-5, and claude-opus-5 for the simple, complex, and ultra-complex routing tiers respectively.

base_url = "https://api.mixroute.ai"
api_key = "sk-xxxxx"

Configure Environment Variables

Basic Configuration Example

For Smart Routing, set ANTHROPIC_MODEL="auto"

Mac / Linux
Windows CMD
Windows PowerShell

export ANTHROPIC_BASE_URL="https://api.mixroute.ai"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxx"
export ANTHROPIC_MODEL="kimi-k2.6"
cd your-project-folder
claude

set ANTHROPIC_BASE_URL=https://api.mixroute.ai
set ANTHROPIC_AUTH_TOKEN=sk-xxxxx
set ANTHROPIC_MODEL=kimi-k2.6
cd your-project-folder
claude

$env:ANTHROPIC_BASE_URL="https://api.mixroute.ai"
$env:ANTHROPIC_AUTH_TOKEN="sk-xxxxx"
$env:ANTHROPIC_MODEL="kimi-k2.6"
cd your-project-folder
claude

Dual Model Configuration

Claude Code uses a dual-thread model architecture by default:

Main Model: Configured via the ANTHROPIC_MODEL environment variable
- Used for primary code generation, conversation, and complex tasks
Sub Model: Configured via the ANTHROPIC_DEFAULT_HAIKU_MODEL environment variable
- Purpose: lightweight / fast task model
- Use cases:
  - Background tasks (file watching, linter checks, etc.)
  - Quick responses (simple questions, completion suggestions)
  - Low-priority auxiliary tasks

Dual Model Configuration (Recommended)

Mac / Linux
Windows CMD
Windows PowerShell

export ANTHROPIC_BASE_URL="https://api.mixroute.ai"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxx"
export ANTHROPIC_MODEL="kimi-k2.6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
cd your-project-folder
claude

set ANTHROPIC_BASE_URL=https://api.mixroute.ai
set ANTHROPIC_AUTH_TOKEN=sk-xxxxx
set ANTHROPIC_MODEL=kimi-k2.6
set ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
cd your-project-folder
claude

$env:ANTHROPIC_BASE_URL="https://api.mixroute.ai"
$env:ANTHROPIC_AUTH_TOKEN="sk-xxxxx"
$env:ANTHROPIC_MODEL="kimi-k2.6"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
cd your-project-folder
claude

Single Model Configuration (Optional)

If you only need one model, there are two configuration methods: Method 1: Set both environment variables to the same model Set both ANTHROPIC_MODEL and ANTHROPIC_DEFAULT_HAIKU_MODEL to the same model:

Mac / Linux
Windows CMD
Windows PowerShell

export ANTHROPIC_BASE_URL="https://api.mixroute.ai"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxx"
export ANTHROPIC_MODEL="kimi-k2.6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k2.6"
cd your-project-folder
claude

set ANTHROPIC_BASE_URL=https://api.mixroute.ai
set ANTHROPIC_AUTH_TOKEN=sk-xxxxx
set ANTHROPIC_MODEL=kimi-k2.6
set ANTHROPIC_DEFAULT_HAIKU_MODEL=kimi-k2.6
cd your-project-folder
claude

$env:ANTHROPIC_BASE_URL="https://api.mixroute.ai"
$env:ANTHROPIC_AUTH_TOKEN="sk-xxxxx"
$env:ANTHROPIC_MODEL="kimi-k2.6"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k2.6"
cd your-project-folder
claude

Method 2: Switch the main model using commands after startup Keep the environment variables set as the “Dual Model Configuration” above. After starting Claude Code, enter the following in the interactive interface:

/model haiku

The main thread will switch to use the model configured in ANTHROPIC_DEFAULT_HAIKU_MODEL (i.e., claude-haiku-4-5).

Troubleshooting

# Error message a 
API Error: 400 Unexpected Value(s) `advisor-tool-2026-03-01` for the `anthropic-beta` header.
# Error message b
API Error: 400 InvokeModelWithResponseStream: \
operation error bedrock Runtime: InvokeModelWithResponseStream, \
http response error StatusCode: 400 , RequestID: xxx-xxx-xxx-xxx, \
ValidationException: invalid beta flag (request id xxxxxxxx)

Add CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS : 1 to the settings to disable the inclusion of experimental features in the request header.

Conversational AI

Programming

Engineering

Translation

Install Node.js (Skip if installed)

Uninstall Other Relay Clients (Optional)

Install Claude Code

Get Credentials

Configure Environment Variables

Basic Configuration Example

Dual Model Configuration

Dual Model Configuration (Recommended)

Single Model Configuration (Optional)

Troubleshooting

​Install Node.js (Skip if installed)

​Uninstall Other Relay Clients (Optional)

​Install Claude Code

​Get Credentials

​Configure Environment Variables

​Basic Configuration Example

​Dual Model Configuration

​Dual Model Configuration (Recommended)

​Single Model Configuration (Optional)

​Troubleshooting

​Response to 400 Errors Related to Beta Fields

Install Node.js (Skip if installed)

Uninstall Other Relay Clients (Optional)

Install Claude Code

Get Credentials

Configure Environment Variables

Basic Configuration Example

Dual Model Configuration

Dual Model Configuration (Recommended)

Single Model Configuration (Optional)

Troubleshooting

Response to 400 Errors Related to Beta Fields