> ## 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 用戶端整合指南

<link rel="alternate" hrefLang="en" href="https://mixroute.ai/docs/integrations/claude-code" />

<link rel="alternate" hrefLang="zh-Hans" href="https://mixroute.ai/docs/zh-hans/integrations/claude-code" />

<link rel="alternate" hrefLang="zh-Hant" href="https://mixroute.ai/docs/zh-hant/integrations/claude-code" />

<link rel="alternate" hrefLang="ja" href="https://mixroute.ai/docs/ja/integrations/claude-code" />

<link rel="alternate" hrefLang="x-default" href="https://mixroute.ai/docs/integrations/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 是一項智能模型路由能力，能夠根據輸入任務的複雜程度，自動將請求分配至最合適的模型。

      [約束與指南見此處](/docs/zh-hant/api-reference/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)
```

在config設定文件中添加`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS : 1` ，禁止在請求頭部添加實驗性功能相關的字段。


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