2026年Claude Code配置自定義API地址的3種完整方案

發(fā)布時(shí)間：2026-04-15 16:55:49 作者：與蝦牽手

本文介紹如何為 Claude Code 配置自定義 API 地址，作者因賬戶余額耗盡、充值受阻導(dǎo)致項(xiàng)目進(jìn)度受阻，最終通過切換第三方聚合接口解決問題，并整理出 3 種可行方案供開發(fā)者參考實(shí)測(cè),需要的朋友可以參考下

上周五晚上，我正用 Claude Code 重構(gòu)一個(gè)老項(xiàng)目的后端接口，寫到一半突然開始瘋狂報(bào) 401 Unauthorized。一看賬戶余額——沒了。充值頁(yè)面又打不開，卡在支付環(huán)節(jié)轉(zhuǎn)圈圈。當(dāng)時(shí)項(xiàng)目第二天要交，我差點(diǎn)原地爆炸。

折騰到凌晨?jī)牲c(diǎn)，我把 Claude Code 的 API 地址換成了第三方聚合接口，后面寫代碼絲滑得不行。核心操作就兩個(gè)字段：環(huán)境變量 ANTHROPIC_BASE_URL 或配置文件 ~/.claude/settings.json，覆蓋掉默認(rèn)端點(diǎn)，全程不到 5 分鐘，不需要改任何代碼邏輯。

踩過的坑和跑通的 3 種方案都在下面，直接抄作業(yè)就行。

2026年Claude Code配置自定義API地址的3種完整方案

先說結(jié)論

方案	適用場(chǎng)景	配置難度	是否持久化	推薦指數(shù)
環(huán)境變量 `ANTHROPIC_BASE_URL`	臨時(shí)切換、CI/CD	?	否（當(dāng)次會(huì)話）	????
`settings.json` 配置文件	日常開發(fā)、長(zhǎng)期使用	??	是	?????
Shell 別名封裝	多環(huán)境切換	???	是	???

三種方案都實(shí)測(cè)過，日常開發(fā)最推薦方案二，改一次配置文件后面就不用管了。

環(huán)境準(zhǔn)備

開始之前確認(rèn)這幾個(gè)東西：

Claude Code CLI 已安裝（npm install -g @anthropic-ai/claude-code，當(dāng)前最新版 1.x）
Node.js 18+（Claude Code 依賴）
一個(gè)可用的 API Key（官方的或第三方聚合平臺(tái)的都行）

確認(rèn)安裝沒問題：

claude --version
# 輸出類似 claude-code/1.x.x

方案一：環(huán)境變量直接覆蓋（最快）

最簡(jiǎn)單粗暴的方式，一行命令搞定：

# 設(shè)置自定義 API 地址
export ANTHROPIC_BASE_URL="https://api.ofox.ai/v1"
export ANTHROPIC_API_KEY="your-api-key-here"
# 然后正常啟動(dòng) Claude Code
claude

進(jìn)入 Claude Code 交互界面后，它會(huì)自動(dòng)讀取這兩個(gè)環(huán)境變量，所有請(qǐng)求都走你指定的地址。

驗(yàn)證是否生效，在 Claude Code 里隨便輸入：

> 幫我寫一個(gè) Python 的 hello world

正常返回代碼就說明配置成功。

注意：這種方式只對(duì)當(dāng)前終端會(huì)話有效，關(guān)掉終端就失效了。想每次打開終端都生效，寫進(jìn) ~/.bashrc 或 ~/.zshrc：

# 追加到 ~/.zshrc（macOS 默認(rèn) zsh）
echo 'export ANTHROPIC_BASE_URL="https://api.ofox.ai/v1"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.zshrc
source ~/.zshrc

方案二：配置文件持久化（最推薦）

Claude Code 支持通過 settings.json 管理各種參數(shù)，包括 API 端點(diǎn)。我目前在用的方案，改一次就完事了。

第一步：找到或創(chuàng)建配置文件

mkdir -p ~/.claude
touch ~/.claude/settings.json

第二步：編輯配置文件

{
 "apiBaseUrl": "https://api.ofox.ai/v1",
 "apiKey": "your-api-key-here",
 "model": "claude-sonnet-4-20250514",
 "permissions": {
 "allow": [
 "Read",
 "Write",
 "Bash"
 ]
 },
 "preferences": {
 "verbose": false,
 "autoApprove": false
 }
}

第三步：重啟 Claude Code 驗(yàn)證

claude

進(jìn)去之后隨便問個(gè)問題，看響應(yīng)是否正常。想確認(rèn)請(qǐng)求確實(shí)走了自定義地址，開啟 verbose 模式：

claude --verbose

終端會(huì)打印出實(shí)際請(qǐng)求的 URL，清楚看到請(qǐng)求發(fā)到了哪里。

graph LR
 A[Claude Code CLI] -->|讀取 settings.json| B{apiBaseUrl}
 B -->|自定義地址| C[聚合 API 網(wǎng)關(guān)]
 C --> D[Claude Opus 4.6]
 C --> E[Claude Sonnet 4.6]
 C --> F[其他模型]
 B -->|默認(rèn)地址| G[api.anthropic.com]

model 字段可以指定默認(rèn)使用的模型。聚合平臺(tái)通常支持多個(gè) Claude 版本，比如 claude-opus-4-20250514、claude-sonnet-4-20250514，按需填寫。

方案三：Shell 別名封裝（多環(huán)境切換）

有時(shí)候用官方 API，有時(shí)候用聚合平臺(tái)，需要快速切換的話，用 Shell 別名：

# 追加到 ~/.zshrc

# 官方 API
alias claude-official='ANTHROPIC_BASE_URL="https://api.anthropic.com" ANTHROPIC_API_KEY="sk-ant-xxx" claude'

# 聚合平臺(tái)
alias claude-agg='ANTHROPIC_BASE_URL="https://api.ofox.ai/v1" ANTHROPIC_API_KEY="your-ofox-key" claude'

# 默認(rèn)用聚合平臺(tái)（延遲更低）
alias cc='claude-agg'

source ~/.zshrc

# 用聚合平臺(tái)
cc

# 用官方
claude-official

不同場(chǎng)景一個(gè)命令切換，不用反復(fù)改配置文件。

踩坑記錄

幾個(gè)我實(shí)際踩過的坑，幫你少走彎路。

坑 1：base_url 末尾的斜杠問題

這個(gè)坑很隱蔽。有些 API 端點(diǎn)對(duì)末尾的 / 敏感：

# ? 可能報(bào)錯(cuò)
export ANTHROPIC_BASE_URL="https://api.ofox.ai/v1/"

# ? 正確
export ANTHROPIC_BASE_URL="https://api.ofox.ai/v1"

多一個(gè)斜杠，請(qǐng)求路徑會(huì)變成 https://api.ofox.ai/v1//v1/messages，直接 404。我在這上面浪費(fèi)了半小時(shí)，一直以為是 Key 的問題。

坑 2：環(huán)境變量?jī)?yōu)先級(jí)

Claude Code 讀取配置的優(yōu)先級(jí)：

命令行參數(shù) > 環(huán)境變量 > settings.json > 默認(rèn)值

settings.json 里配了地址 A，但環(huán)境變量設(shè)了地址 B，最終走地址 B。我之前配置文件改了半天不生效，就是因?yàn)?.zshrc 里還殘留著一個(gè)舊的環(huán)境變量。

排查方法：

# 檢查是否有殘留的環(huán)境變量
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

# 清除
unset ANTHROPIC_BASE_URL
unset ANTHROPIC_API_KEY

坑 3：協(xié)議兼容性

Claude Code 默認(rèn)走 Anthropic 原生協(xié)議（/v1/messages），不是 OpenAI 的 /v1/chat/completions。所以選的第三方服務(wù)必須兼容 Anthropic 協(xié)議，隨便找個(gè) OpenAI 兼容的中轉(zhuǎn)是不夠的。

ofox.ai 同時(shí)兼容 OpenAI、Anthropic、Gemini 三大 API 協(xié)議，一個(gè) Key 可以調(diào)用 GPT-5、Claude Opus 4.6、Gemini 3 等 50+ 模型，所以 Claude Code 直接改 base_url 就能用，不需要額外的協(xié)議轉(zhuǎn)換。

坑 4：權(quán)限配置導(dǎo)致的假性失敗

有時(shí)候 API 調(diào)用成功了，但 Claude Code 執(zhí)行代碼時(shí)報(bào)權(quán)限錯(cuò)誤，這不是 API 的問題，是本地權(quán)限沒開：

{
 "permissions": {
 "allow": [
 "Read",
 "Write",
 "Bash"
 ]
 }
}

或者啟動(dòng)時(shí)加 --dangerously-skip-permissions（僅限本地開發(fā)，別在生產(chǎn)環(huán)境用）。

配合 Skills 使用

配置好自定義 API 之后，Skills 完全不受影響——Skills 本質(zhì)上是 prompt 模板 + 工具鏈定義，跟 API 端點(diǎn)沒關(guān)系。

我現(xiàn)在的工作流：

graph TD
 A[啟動(dòng) Claude Code] -->|讀取 settings.json| B[連接聚合 API]
 B --> C{選擇任務(wù)}
 C -->|代碼生成| D[加載對(duì)應(yīng) Skill]
 C -->|代碼審查| E[加載 Review Skill]
 C -->|重構(gòu)| F[加載 Refactor Skill]
 D --> G[調(diào)用 Claude Sonnet 4.6]
 E --> G
 F --> G
 G --> H[返回結(jié)果到終端]

Skills 配置放在項(xiàng)目根目錄的 .claude/skills/ 下面，跟 API 配置互不干擾。