> ## Documentation Index
> Fetch the complete documentation index at: https://mixroute.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Claude Code 客户端集成指南

## 一、安装 Node.js（已安装可跳过）

确保 Node.js 版本 ≥ 18.0

**Windows**

下载安装包：[https://nodejs.org/dist/v22.18.0/node-v22.18.0-x64.msi](https://nodejs.org/dist/v22.18.0/node-v22.18.0-x64.msi)

**macOS**

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

**Ubuntu / Debian**

```bash theme={null}
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs
node --version
```

### 卸载其他中转客户端（可选）

检查安装位置：

```bash theme={null}
npm ls @anthropic-ai/claude-code
npm ls -g @anthropic-ai/claude-code
```

执行卸载：

```bash theme={null}
npm uninstall @anthropic-ai/claude-code
npm uninstall -g @anthropic-ai/claude-code
```

## 二、安装 Claude Code

```bash theme={null}
npm install -g @anthropic-ai/claude-code
```

检查是否安装成功：

```bash theme={null}
claude --version
```

## 三、获取密钥

**智能路由节点接入**

> [!TIP]
>
> Smart Routing 是一项智能模型路由能力，能够根据输入任务的复杂程度，自动将请求分配至最合适的模型。
>
> [约束与指南见此处](/docs/zh-Hans/api-reference/smart-routing)

```text theme={null}
base_url = "https://api.mixroute.ai"
api_key = "smart_routing-sk-xxxxx"
model = "auto"
```

> [!WARNING]
>
> **注意**
>
> ClaudeCode无法接入非 `\v1\messages` 通讯的模型，使用智能路由接入时，所有路由层都需使用Claude系列模型。
>
> 例如使用claude-haiku-4.5、claude-sonnet-5、claude-opus-5分别对应简单、复杂、超复杂三个路由层级。

**传统节点接入**

```text theme={null}
base_url = "https://api.mixroute.ai"
api_key = "sk-xxxxx"
```

## 四、配置环境变量

### 基础配置示例

> [!TIP]
>
> 智能路由接入请 `ANTHROPIC_MODEL="auto"`

**Mac / Linux**

```bash theme={null}
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
```

**Windows CMD**

```cmd theme={null}
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
```

**Windows PowerShell**

```powershell theme={null}
$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
```

### 双模型配置说明

Claude Code 默认使用双线程模型架构：

* **主线程模型**：使用 `ANTHROPIC_MODEL` 环境变量配置
  * 用于主要的代码生成、对话和复杂任务处理
* **副线程模型**：使用 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 环境变量配置
  * 用途：轻量级 / 快速任务模型
  * 使用场景：
    * 背景任务（文件监控、linter 检查等）
    * 快速响应（简单问题、补全建议）
    * 低优先级的辅助任务

### 基础配置（双模型，推荐）

**Mac / Linux**

```bash theme={null}
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
```

**Windows CMD**

```cmd theme={null}
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
```

**Windows PowerShell**

```powershell theme={null}
$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
```

### 单模型配置（可选）

如果只需要使用一个模型，有两种配置方法：

**方法一：两个环境变量配置为同一个模型**

将 `ANTHROPIC_MODEL` 和 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 都设置为相同的模型：

**Mac / Linux**

```bash theme={null}
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
```

**Windows CMD**

```cmd theme={null}
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
```

**Windows PowerShell**

```powershell theme={null}
$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
```

**方法二：启动后使用命令切换主线程模型**

保持环境变量按「基础配置（双模型）」设置，启动 Claude Code 后，在交互界面中输入：

```text theme={null}
/model haiku
```

主线程会切换为使用 `ANTHROPIC_DEFAULT_HAIKU_MODEL`（即 `claude-haiku-4-5`）对应的模型。

## 错误指南

### 因Beta头部字段造成400错误

```text theme={null}
# 错误信息a
API Error: 400 Unexpected Value(s) `advisor-tool-2026-03-01` for the `anthropic-beta` header.
# 错误信息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)
```

在设置中添加`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS : 1` ，禁止在请求体头部添加实验性功能相关内容。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.