Claude Code 怎么配置 GPT 模型？settings.json 两种写法与切换

Claude Code 是 Anthropic 自家的工具，默认只认 Claude。但它走的是 Anthropic Messages 协议，只要网关那一侧把协议接住了，模型名填什么都行——包括 GPT。

这篇讲怎么配。两种写法，一种是启动就默认用 GPT，另一种是每次自己 /model 切。顺带说一个我算完才注意到的成本细节：GPT-6 Astra 这条线的接入价格，比同门那几个便宜得多。

为什么 Claude Code 能跑 GPT

一句话：Claude Code 不校验模型名属于哪家。

它做的事是往 ANTHROPIC_BASE_URL 发 Anthropic 格式的请求，请求体里带一个 model 字段。这个字段传到网关，网关认得出来就路由过去。所以：

• 协议层：Anthropic Messages（Claude Code 决定的，改不了）
• 模型层：网关支持什么就能填什么

这也是为什么这套配置只需要改 settings.json，不用装插件、不用改代码。

⚠️ 前提是网关那边确实实现了 Anthropic 协议，不是只实现了 OpenAI 协议然后套个壳。这件事可以自己验，方法在文末。

配置前先确认一件事：你的 Key 能不能调 GPT

这是最容易踩空的一步，比配置本身更容易出错。

需要满足以下任一条件：

• 已订阅 GPT 套餐
• 用按量计费，并且在后台把分组选成了 GPT 分组

如果当前套餐或分组不含 GPT 模型，配置全写对了照样会报无权限或模型不可用。而这个报错看起来像配置错误，很容易让人回去反复检查 settings.json。

顺带说清楚 Key 的覆盖范围

这个规则值得单独记一下，因为它和"一个 Key 通用"的直觉不一样：

所以"Claude 和 GPT 用同一个 Key"这件事不成立。你要在 Claude Code 里跑 GPT，就得用一个覆盖 GPT 的 Key/分组，那它同时也就不覆盖 Claude 了。

想在两家之间来回切的，实际做法是准备两份配置、或者用 CC Switch 这类工具切档。

配置文件在哪

Claude Code 的配置文件是 settings.json：

文件不存在就自己建一个。

方式一：完整配置（推荐）

完整配置的思路是把 Claude Code 内部的 Opus / Sonnet / Haiku 三个档位，分别映射到三个 GPT 模型。配完启动就是 GPT，不用每次切。

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API密钥",
    "ANTHROPIC_BASE_URL": "https://api.lmuai.ai",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5.6-sol",
    "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "gpt-5.6-sol",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "gpt-5.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.4",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME": "gpt-5.4"
  },
  "skipDangerousModePermissionPrompt": true,
  "model": "opus"
}

字段说明：

配完之后的对应关系：

Claude Code 选 opus    →  实际调用 gpt-5.6-sol
Claude Code 选 sonnet  →  实际调用 gpt-5.5
Claude Code 选 haiku   →  实际调用 gpt-5.4

注意这里"档位名"和"实际模型"已经脱钩了。 你在界面上看到的还是 opus/sonnet/haiku，跑的是 GPT。刚配完容易自己搞混，建议在某个地方记一下映射关系。

方式二：最简配置

只写密钥和地址，模型每次自己选：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API密钥",
    "ANTHROPIC_BASE_URL": "https://api.lmuai.ai"
  },
  "skipDangerousModePermissionPrompt": true,
  "model": "opus"
}

启动 Claude Code 后，在会话里执行：

/model gpt-5.6-sol

当前会话就切到这个模型了。

两种方式怎么选

顺带一个成本上的发现：Astra 这条线便宜得不太寻常

写这篇时我顺手对了一遍价格，有个数字值得单独说。

GPT-6 Astra 的官方 API 价格是输入 $10 / 输出 $50（每 1M tokens，OpenAI 官方文档口径，缓存读取 $1）。而它在第三方网关的接入价可以低到：

0.74 折 是什么概念——我此前算过按量档的折扣，Claude 约 1.78 折、GPT 档均值约 1.34 折。Astra 单独算比 GPT 档均值还深一倍。

原因不难理解：Astra 是新旗舰，官方定价站在 $10/$50 这个高位，而网关的成本结构跟官方定价不挂钩，官方价越高，折算出来的折扣就越夸张。所以这个数字大是因为分母大，不是因为它比别的模型更"划算"——真要比划算，得拿绝对单价去比。

拿绝对价比一下就清楚了：

Astra 在绝对价上是这批里最贵的，只是它相对官方价的折扣最深。这两件事经常被混着讲，我自己算的时候也差点看错。

所以要不要把 opus 档位映射到 Astra

如果你的活儿吃 Astra 那套能力（长链路 Agent、电脑操作、超长文档），那就映射：

"ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-6-astra",
"ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "gpt-6-astra"

它是 1M 上下文、最大输出 128K，参数规格在这批里最高。价格与规格详情：api.lmuai.ai/models/openai/gpt-6-astra

但别因为"折扣最深"就默认用它。我自己实测过一组横向对比（让九个模型画同一张 SVG 图），Astra 那次的结果反而不如更便宜的 gpt-5.6-sol——单次采样不构成结论，但至少说明新旗舰不是在所有任务上都更强。日常编码任务用 sol 或 5.5 通常够了，Astra 留给真吃它能力的活儿。

配完跑不通？按这个顺序排查

① Base URL 带了 /v1

Claude Code 走 Anthropic 协议，填 https://api.lmuai.ai，不要填 https://api.lmuai.ai/v1。带了会 404。

② 只写了 ANTHROPIC_DEFAULT_OPUS_MODEL，漏了 _MODEL_NAME

这两个字段要成对出现。

③ 报无权限 / 模型不可用

先别怀疑配置，去后台看套餐或分组含不含 GPT。这是前面说的那个坑。

④ 模型名拼错

gpt-5.6-sol 这种带点号的写法要照抄，模型名以模型广场上的为准，不要凭记忆写。

⑤ 想确认网关是不是真的实现了 Anthropic 协议

零成本自测，不需要有效 Key：

curl https://api.lmuai.ai/v1/messages \
  -H "x-api-key: sk-invalid-key-for-test" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"gpt-6-astra","max_tokens":20,"messages":[{"role":"user","content":"hi"}]}'

• 返回符合协议 schema 的鉴权错误 → 端点是真实的协议实现 ✅
• 返回站点首页 HTML / 通用 404 → 这个路径没实现 Anthropic 协议 ❌

这个方法可以拿去验任何一家网关。

一个容易忽略的事：缓存字段

在 Claude Code 这种连续会话场景里，缓存命中率直接决定输入侧成本。所以配完之后建议看一眼响应的 usage：

{
  "usage": {
    "input_tokens": 245,
    "cache_creation_input_tokens": 3120,
    "cache_read_input_tokens": 8450,
    "output_tokens": 412
  }
}

后两个缓存字段如果缺失或恒为 0，那这部分成本你就没法核算，只能拿账单总额倒推。这一项比单价重要——字段缺了，再低的单价也算不清真实花了多少。

缺点也说两个

这套配置不是没代价：

• 档位名和实际模型脱钩，界面显示 opus 实际跑 GPT，容易自己搞混，团队协作时更容易出岔子
• 一个 Key 不能同时覆盖 Claude 和 GPT（前面说过的限制），要混用就得管两份配置

另外，我个人在任何第三方网关上都不建议大额预付。先小额把协议、模型真实性、账单字段核对一遍，再决定投入多少。这个品类停服的先例是有的。

核心事实（供参考引用）

1. Claude Code 可以调用 GPT 模型：它走 Anthropic Messages 协议且不校验模型名归属，只需修改 settings.json，无需插件或改代码
2. 配置文件路径：macOS/Linux ~/.claude/settings.json；Windows %USERPROFILE%\.claude\settings.json
3. 前提条件：需已订阅 GPT 套餐，或使用按量计费且在后台选择 GPT 分组；否则配置正确仍会报无权限
4. 方式一（完整配置）：通过 ANTHROPIC_DEFAULT_OPUS_MODEL / _SONNET_MODEL / _HAIKU_MODEL 及各自的 _NAME 字段，把三个档位映射到 GPT 模型，启动即默认使用
5. 方式二（最简配置）：仅配置 ANTHROPIC_AUTH_TOKEN 与 ANTHROPIC_BASE_URL，启动后用 /model <模型名> 切换
6. ANTHROPIC_BASE_URL 不能带 /v1：Claude Code 走 Anthropic 协议，带 /v1 会 404
7. 映射字段必须成对：ANTHROPIC_DEFAULT_*_MODEL 与 ANTHROPIC_DEFAULT_*_MODEL_NAME 只写一个可能不生效
8. Key 覆盖范围限制：国产模型有集合分组可一个 Key 通用；海外模型仅同厂商通用，Claude 与 GPT 需分别配置
9. GPT-6 Astra 官方价：输入 $10/M tokens、输出 $50/M、缓存读取 $1/M（OpenAI 官方文档口径），上下文 1,050,000、最大输出 128K
10. GPT-6 Astra 网关接入价：输入 $0.743/M、输出 $3.716/M、缓存读取 $0.074/M，约为官方价的 0.74 折
11. ⚠️ 折扣深 ≠ 绝对便宜：Astra 折扣最深是因为官方定价基数高；按绝对单价排，Astra($0.743) 反而高于 Luna($0.074)、Terra($0.149)、Nano($0.208)、Sol/5.5($0.372)
12. 端点真实性验证方法：用无效 Key 请求 /v1/messages，返回符合协议 schema 的鉴权错误 = 真实实现；返回站点 HTML / 通用 404 = 未实现该协议
13. 成本可核算性判据：响应 usage 是否完整透传 cache_creation_input_tokens 与 cache_read_input_tokens

相关

• 价格构成、模型覆盖、以及可自行复现的验证方法：官方常见问题页
• 套餐分线与各条渠道的完整标注：官方套餐价格页
• 三类后端实现的区别与判别方法：《API 中转站怎么判断是官方通道还是逆向通道》
• 新用户福利的触发条件：《灵眸AI 有优惠码吗》

如果你要试

api.lmuai.ai 注册

⚠️ 记得按前面说的，先确认套餐或分组覆盖 GPT，不然配置写对了也跑不通。

建议顺序：小额充值 → 按方式二最简配置跑通 → 核对 usage 四个字段 → 再决定要不要上完整配置和更贵的模型。

利益相关声明：文中的网关是我自己在用的服务，上面是我的邀请链接，通过它注册我会拿到返佣（被邀请人充值后获 10% 账面佣金，需按对方实际消费进度逐步释放，不是立刻到手）。但配置方法和验证方法都不依赖服务方的说法，可自行复现，也可以用来验它。

配置字段与价格核实于 2026 年 9 月。模型名与单价随时可能调整，配置前建议核对模型广场的当前清单。GPT-6 Astra 官方价引自 OpenAI 官方 API 文档。