Claude Code 串接教學

Anthropic 官方的命令列程式設計助手，設兩個環境變數就能用櫻桃茶的 Claude 模型

介面：Anthropic Messages
網址寫法：只寫網域（https://gpt.cherrychat.org）
推薦模型：claude-sonnet-5-5、claude-opus-5-5
背景小模型：claude-haiku-5-5
平台：macOS、Windows、Linux、VS Code、JetBrains

串接步驟

安裝 Claude Code（裝過可略過）
macOS 開啟「終端機」，Windows 開啟「PowerShell」，貼上對應指令後按 Enter。裝好後輸入 claude --version 能看到版本號即可。官方腳本下載不順時，可以改用 npm 安裝（需先裝 Node.js 22 或更新版本）。
macOS / Linux
```
curl -fsSL https://claude.ai/install.sh | bash
```
Windows（PowerShell）
```
irm https://claude.ai/install.ps1 | iex
```
或改用 npm 安裝
```
npm install -g @anthropic-ai/claude-code
```
方法一（推薦）：寫進 settings.json
用下方指令開啟使用者目錄中的 ~/.claude/settings.json（Windows 是 %USERPROFILE%\.claude\settings.json），把整段設定貼進去並儲存。檔案裡已有其他內容時，只把 "env" 這一段合併進去，不要整個覆蓋；這個檔案是嚴格 JSON，不能寫註解，最後一項後面不能有逗號。這樣設定對所有終端機與 VS Code / JetBrains 擴充功能都有效。
- ANTHROPIC_BASE_URL（API 網址）：https://gpt.cherrychat.org（只寫到網域，不要加 /v1）
- ANTHROPIC_AUTH_TOKEN（API Key）：sk-你的金鑰
- ANTHROPIC_MODEL（主模型）：claude-sonnet-5-5
- ANTHROPIC_DEFAULT_HAIKU_MODEL（背景小模型）：claude-haiku-5-5（產生標題、摘要等背景任務用，便宜又快）
開啟檔案（macOS）
```
mkdir -p ~/.claude && touch ~/.claude/settings.json && open -e ~/.claude/settings.json
```
開啟檔案（Windows）
```
mkdir $HOME\.claude -Force; notepad $HOME\.claude\settings.json
```
settings.json 內容
```
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gpt.cherrychat.org",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的金鑰",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
  }
}
```

方法二：用環境變數

不想改 settings.json 時用這個方法。「永久生效」寫進 ~/.zshrc（用 bash 的把檔名換成 ~/.bashrc），Windows 用 setx，設好後要關掉終端機重新開啟；「只在目前視窗生效」適合先試試，關掉視窗就失效。兩種方法擇一即可。

永久生效（寫入 ~/.zshrc）

cat >> ~/.zshrc <<'EOF'
export ANTHROPIC_BASE_URL="https://gpt.cherrychat.org"
export ANTHROPIC_AUTH_TOKEN="sk-你的金鑰"
export ANTHROPIC_MODEL="claude-sonnet-5-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"
EOF
source ~/.zshrc

只在目前視窗生效

export ANTHROPIC_BASE_URL="https://gpt.cherrychat.org"
export ANTHROPIC_AUTH_TOKEN="sk-你的金鑰"
export ANTHROPIC_MODEL="claude-sonnet-5-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"
claude

永久生效（setx，設好後重開 PowerShell）

setx ANTHROPIC_BASE_URL "https://gpt.cherrychat.org"
setx ANTHROPIC_AUTH_TOKEN "sk-你的金鑰"
setx ANTHROPIC_MODEL "claude-sonnet-5-5"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "claude-haiku-5-5"

只在目前視窗生效

$env:ANTHROPIC_BASE_URL = "https://gpt.cherrychat.org"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的金鑰"
$env:ANTHROPIC_MODEL = "claude-sonnet-5-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-5-5"
claude

驗證是否接通
開一個新的終端機，進入你的專案資料夾，執行下方指令，能看到回覆就代表接通了。進入 claude 互動介面後輸入 /status：「Anthropic base URL」一行應顯示 https://gpt.cherrychat.org，「Auth token」一行應顯示 ANTHROPIC_AUTH_TOKEN。
```
claude -p "你好，用一句話介紹你自己"
```
提示登入時怎麼辦
出現登入畫面，代表 Claude Code 沒讀到 ANTHROPIC_AUTH_TOKEN：確認是在設定之後新開的終端機裡執行，或改用方法一寫進 ~/.claude/settings.json。不需要登入 Anthropic 帳號。以前登入過 claude.ai、啟動時提示兩個憑證衝突的，在 Claude Code 裡輸入 /logout 登出舊帳號即可。

在 VS Code 擴充功能中使用（選用）

VS Code 擴充功能啟動前會先檢查登入，所以要在 VS Code 自己的設定裡再寫一次：按 Cmd/Ctrl + Shift + P，執行「Preferences: Open User Settings (JSON)」，把下面這段加進最外層的大括號裡並儲存，然後重新啟動 VS Code。

"claudeCode.environmentVariables": [
  { "name": "ANTHROPIC_BASE_URL", "value": "https://gpt.cherrychat.org" },
  { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的金鑰" },
  { "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5-5" },
  { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-haiku-5-5" }
]

容易踩的坑

API 網址只寫到網域 https://gpt.cherrychat.org，不要帶 /v1，Claude Code 會自己補上 /v1/messages。
key 放在 ANTHROPIC_AUTH_TOKEN 裡；不要同時再設 ANTHROPIC_API_KEY，兩個都設會互相衝突。
不要把 key 寫進專案資料夾裡的 .claude/settings.json，它會跟程式碼一起提交、被別人看到；只寫使用者目錄的 ~/.claude/settings.json。
settings.json 和終端機環境變數都設了時，以 settings.json 為準；換 key 時兩處都要改。
ANTHROPIC_SMALL_FAST_MODEL 是舊變數名，官方已標記棄用，新版用 ANTHROPIC_DEFAULT_HAIKU_MODEL；很舊的版本可以兩個都設。想在 /model 裡切換 Opus / Sonnet，再加 ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5 與 ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5-5。
Claude Code 內建的 WebSearch 聯網搜尋暫不支援；Claude 桌面 App 也不讀這些設定，本教學只適用於命令列與 VS Code / JetBrains 擴充功能。

錯誤訊息 → 原因 → 怎麼辦

看到的錯誤	原因	怎麼辦
出現 401 / Invalid bearer token	key 複製錯了、前後多了空格，或這把 key 已停用 / 刪除；也可能誤寫進了 ANTHROPIC_API_KEY	到 API 頁「我的金鑰」重新複製，填進 ANTHROPIC_AUTH_TOKEN，然後開新的終端機再試
出現 404 Not Found	ANTHROPIC_BASE_URL 寫成了 https://gpt.cherrychat.org/v1 或帶了 /messages，路徑被重複拼接	改成只到網域：https://gpt.cherrychat.org
提示「There's an issue with the selected model」或模型不存在	ANTHROPIC_MODEL 的名稱寫錯（大小寫、多空格），或用了櫻桃茶沒有的模型名	改成「模型價格」頁上的名稱，例如 claude-sonnet-5-5（全小寫）
出現 402 或「餘額不足」（Claude 格式顯示 billing_error）	帳戶點數不足以支付這次呼叫。API 呼叫只扣點數，會員卡與無限卡都不抵扣	到櫻桃茶·智域GPT 的「商店」儲值任意金額，幾秒後重試即可
出現 429 Too Many Requests	請求太快：預設每把 key 每分鐘最多 120 次，每個帳號同時最多 8 個請求	調低工具裡的並行數或每秒請求數，依提示的 Retry-After 秒數稍等再試；多數工具會自動重試
一直轉圈後出現連線失敗 / 逾時（ECONNREFUSED、ENOTFOUND、timeout）	網址拼錯、漏了 https://，或目前的網路連不到這個網域	用瀏覽器開啟 https://gpt.cherrychat.org/v1/models：能看到一段 JSON（就算是錯誤訊息）就代表網路是通的，再回到工具裡逐字核對網址

教學核對於 2026-11-02。工具介面改版後可能和這裡略有不同，以官方文件為準。

API 串接 · API 模型價格

Operated by UK Company CHERRYCHAT LTD · Company Number 16096119 · 客服微信 JsnonoChat · 內容由 AI 生成，請仔細甄別

Claude Code 串接教學

串接步驟

安裝 Claude Code（裝過可略過）

方法一（推薦）：寫進 settings.json

方法二：用環境變數

驗證是否接通

提示登入時怎麼辦

在 VS Code 擴充功能中使用（選用）

容易踩的坑

錯誤訊息 → 原因 → 怎麼辦