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

# Claude Code

> Claude Code 客户端集成指南

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

确保 Node.js 版本 ≥ 18.0

<Tabs>
  <Tab title="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)
  </Tab>

  <Tab title="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
    ```
  </Tab>

  <Tab title="Ubuntu / Debian">
    ```bash theme={null}
    curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
    sudo apt-get install -y nodejs
    node --version
    ```
  </Tab>
</Tabs>

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

检查安装位置：

```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
```

## 三、获取密钥

<Tabs>
  <Tab title="智能路由节点接入">
    <Tip>
      Smart Routing 是一项智能模型路由能力，能够根据输入任务的复杂程度，自动将请求分配至最合适的模型。

      [约束与指南见此处](/zh-hans/smart-routing)
    </Tip>

    ```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分别对应简单、复杂、超复杂三个路由层级。
    </Warning>
  </Tab>

  <Tab title="传统节点接入">
    ```text theme={null}
    base_url = "https://api.mixroute.ai"
    api_key = "sk-xxxxx"
    ```
  </Tab>
</Tabs>

## 四、配置环境变量

### 基础配置示例

<Tip>
  智能路由接入请 `ANTHROPIC_MODEL="auto"`
</Tip>

<Tabs>
  <Tab title="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
    ```
  </Tab>

  <Tab title="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
    ```
  </Tab>

  <Tab title="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
    ```
  </Tab>
</Tabs>

### 双模型配置说明

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

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

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

<Tabs>
  <Tab title="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
    ```
  </Tab>

  <Tab title="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
    ```
  </Tab>

  <Tab title="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
    ```
  </Tab>
</Tabs>

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

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

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

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

<Tabs>
  <Tab title="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
    ```
  </Tab>

  <Tab title="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
    ```
  </Tab>

  <Tab title="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
    ```
  </Tab>
</Tabs>

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

保持环境变量按「基础配置（双模型）」设置，启动 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.