Claude Code

一、安裝 Node.js（已安裝可跳過）

確保 Node.js 版本 ≥ 18.0

Windows
macOS
Ubuntu / Debian

下載安裝包：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

卸載其他中轉客戶端（可選）

檢查安裝位置：

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

執行卸載：

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

二、安裝 Claude Code

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

檢查是否安裝成功：

claude --version

三、取得金鑰

智能路由節點接入
傳統節點接入

Smart Routing 是一項智能模型路由能力，能夠根據輸入任務的複雜程度，自動將請求分配至最合適的模型。約束與指南見此處

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

注意ClaudeCode 無法接入非 \v1\messages 通訊的模型，使用智能路由接入時，所有路由層都需使用 Claude 系列模型。例如使用 claude-haiku-4.5、claude-sonnet-5、claude-opus-5 分別對應簡單、複雜、超複雜三個路由層級。

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

四、配置環境變數

基礎配置示例

智能路由接入請 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

雙模型配置說明

Claude Code 預設使用雙執行緒模型架構：

主執行緒模型：使用 ANTHROPIC_MODEL 環境變數配置
- 用於主要的程式碼生成、對話和複雜任務處理
副執行緒模型：使用 ANTHROPIC_DEFAULT_HAIKU_MODEL 環境變數配置
- 用途：輕量級 / 快速任務模型
- 使用場景：
  - 背景任務（檔案監控、linter 檢查等）
  - 快速回應（簡單問題、補全建議）
  - 低優先級的輔助任務

基礎配置（雙模型，推薦）

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

單模型配置（可選）

如果只需要使用一個模型，有兩種配置方法： 方法一：兩個環境變數配置為同一個模型 將 ANTHROPIC_MODEL 和 ANTHROPIC_DEFAULT_HAIKU_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

方法二：啟動後使用命令切換主執行緒模型 保持環境變數按「基礎配置（雙模型）」設定，啟動 Claude Code 後，在互動介面中輸入：

/model haiku

主執行緒會切換為使用 ANTHROPIC_DEFAULT_HAIKU_MODEL（即 claude-haiku-4-5）對應的模型。

故障處理

Beta 實驗性功能字段 400 拒絕

# 錯誤信息 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 ，禁止在請求頭部添加實驗性功能相關的字段。

對話型 AI

程式開發

技術工程

翻譯場景

一、安裝 Node.js（已安裝可跳過）

卸載其他中轉客戶端（可選）

二、安裝 Claude Code

三、取得金鑰

四、配置環境變數

基礎配置示例

雙模型配置說明

基礎配置（雙模型，推薦）

單模型配置（可選）

故障處理

Beta 實驗性功能字段 400 拒絕

​一、安裝 Node.js（已安裝可跳過）

​卸載其他中轉客戶端（可選）

​二、安裝 Claude Code

​三、取得金鑰

​四、配置環境變數

​基礎配置示例

​雙模型配置說明

​基礎配置（雙模型，推薦）

​單模型配置（可選）

​故障處理

​Beta 實驗性功能字段 400 拒絕

一、安裝 Node.js（已安裝可跳過）

卸載其他中轉客戶端（可選）

二、安裝 Claude Code

三、取得金鑰

四、配置環境變數

基礎配置示例

雙模型配置說明

基礎配置（雙模型，推薦）

單模型配置（可選）

故障處理

Beta 實驗性功能字段 400 拒絕