Claude 配置

1. 什麼是 Claude Code

Claude Code 是 Anthropic 官方提供的終端編碼代理，可以直接在本地項目裡理解代碼、修改文件、執行命令，也可以和 VS Code、JetBrains 等 IDE 配合使用。

當你通過 RouteAPI 使用 Claude Code 時，本質上仍然是在走 Anthropic 協議，只是把 Claude Code 的請求改為發送到你的 RouteAPI 接入點。這樣更適合統一管理密鑰、額度和可用模型。

開始之前，請先準備：

一個可正常訪問的終端環境
已安裝的 Claude Code CLI
你的 RouteAPI 站點地址
你的 RouteAPI 密鑰
RouteAPI 控制台裡可用的 Claude 協議模型 ID

2. 步驟一：安裝 Claude Code

安裝 CLI

macOS / Linux / WSL 可直接運行：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell 可運行：

irm https://claude.ai/install.ps1 | iex

如果你在 Windows 原生環境中安裝，通常還需要提前準備 Git for Windows。

驗證安裝

claude --version

如果輸出版本號，說明 CLI 已經安裝成功。

3. 步驟二：配置 RouteAPI

Claude Code 可以從環境變量讀取接入點和密鑰。為了讓終端和 IDE 共用同一份配置，更推薦把這些變量寫入 settings.json。

3.1 找到配置文件

macOS / Linux: ~/.claude/settings.json
Windows: %USERPROFILE%\.claude\settings.json

3.2 寫入 RouteAPI 接入信息

{
  "env": {
"ANTHROPIC_BASE_URL": "https://www.routeapi.ai/",
"ANTHROPIC_AUTH_TOKEN": "你的 RouteAPI 密鑰"
  }
}

上面這段配置裡：

ANTHROPIC_BASE_URL：填寫你的 RouteAPI 站點根地址，通常不帶 /v1
ANTHROPIC_AUTH_TOKEN：填寫你的 RouteAPI 密鑰，適合使用 Bearer Token 方式鑑權的網關接入

如果你只是想臨時測試，也可以先在當前終端會話裡直接設置環境變量。請根據當前 Shell 選擇對應命令：

如果你使用的是 macOS / Linux / WSL 中的 bash、zsh 或 sh：

export ANTHROPIC_BASE_URL="https://你的-routeapi-域名"
export ANTHROPIC_AUTH_TOKEN="你的 RouteAPI 密鑰"

如果你使用的是 Windows PowerShell：

$env:ANTHROPIC_BASE_URL="https://你的-routeapi-域名"
$env:ANTHROPIC_AUTH_TOKEN="你的 RouteAPI 密鑰"

配置完成後，重新打開一個終端窗口再啟動 claude，通常會更穩妥。

4. 步驟三：選擇您的模型

Claude Code 的模型選擇有兩種常見方式。

方式 A：固定一個默認模型

如果你希望所有會話默認都走同一個模型，可以直接設置 ANTHROPIC_MODEL：

{
  "env": {
"ANTHROPIC_BASE_URL": "https://你的-routeapi-域名",
"ANTHROPIC_AUTH_TOKEN": "你的 RouteAPI 密鑰",
"ANTHROPIC_MODEL": "控制台中可用的模型 ID"
  }
}

這種方式最簡單，適合團隊統一指定一個默認模型。

方式 B：保留 Opus / Sonnet / Haiku 三檔選擇

如果你希望繼續使用 Claude Code 裡的檔位選擇能力，可以分別指定三檔默認模型：

{
  "env": {
"ANTHROPIC_BASE_URL": "https://你的-routeapi-域名",
"ANTHROPIC_AUTH_TOKEN": "你的 RouteAPI 密鑰",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "你的高性能模型 ID",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "你的主力模型 ID",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "你的輕量模型 ID"
  }
}

配置好之後，啟動 Claude Code：

claude

然後在會話中輸入：

/model

即可在 Claude Code 內選擇當前會話要使用的模型檔位。