Claude Code 接入 GPT：settings.json 两种配置方法（2026-10）

本文配置字段依据灵眸AI 官方接入文档整理；模型 ID 与单价于 2026-10-08 在模型广场核对；端点协议实现于同日用零凭证方法实测。

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

这篇讲怎么配。两种写法，一种是启动就默认用 GPT，另一种是每次自己 /model 切。顺带说一个算价格时容易看错的地方：折扣最深的模型，不一定是最便宜的模型。

一、Claude Code 能接入 GPT 吗？为什么 Claude Code 能跑 GPT

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

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

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

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

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

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

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

需要满足以下任一条件：

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

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

Key 的覆盖范围

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

范围	覆盖能力
国产模型	有集合分组，一个 Key 通用 ------ GLM、Qwen、DeepSeek、Kimi 等共用
海外模型	只能同厂商通用 ------ Anthropic 的 Opus / Sonnet / Haiku 共用一个；要再接 GPT，得另配

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

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

三、配置文件在哪

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

系统	路径
macOS / Linux	`~/.claude/settings.json`
Windows	`%USERPROFILE%\.claude\settings.json`

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

四、方式一：Claude Code 接入 GPT 的完整配置（推荐）

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

json 复制代码

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

字段说明：

字段	说明
`ANTHROPIC_AUTH_TOKEN`	你的 API Key，`sk-` 开头
`ANTHROPIC_BASE_URL`	网关地址，不要带 `/v1`
`ANTHROPIC_DEFAULT_OPUS_MODEL`	把 Opus 档位映射到哪个 GPT 模型
`..._MODEL_NAME`	和上面成对出现，两个都要写，只写一个可能不生效
`model`	启动时默认选哪个档位

配完之后的对应关系：

复制代码

Claude Code 选 opus    →  实际调用 gpt-6.1-sol
Claude Code 选 sonnet  →  实际调用 gpt-6-sol
Claude Code 选 haiku   →  实际调用 gpt-6-luna

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

📌 上面三个模型 ID 只是示例。gpt-5.6-sol、gpt-5.5 这些上一代的 ID 目前也还在模型广场上，想用哪个就填哪个，以模型广场的当前清单为准。

五、方式二：Claude Code 使用 GPT 的最简配置

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

json 复制代码

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

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

复制代码

/model gpt-6.1-sol

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

两种方式怎么选

你的情况	用哪种
固定用某一个 GPT 模型	方式一，一次配好不用管
经常在不同 GPT 模型间切换	方式二，启动后 `/model` 指定
想 Claude 和 GPT 混用	方式二 + 两份 Key，或用 CC Switch 切档

六、映射到哪个 GPT 模型：折扣深不等于绝对便宜

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

GPT-6 Astra 的官方 API 价格是输入 $10 / 输出$ 50（每 1M tokens，OpenAI 官方文档口径）。而它在第三方网关的最低渠道价是：

计费项	网关价	官方价	比例
输入	$0.745	$10	约 0.75 折
输出	$3.724	$50	约 0.75 折

0.75 折 是什么概念------按 2026-09 的按量价格，Claude 约 1.78 折、GPT 档均值约 1.34 折。Astra 单独算比 GPT 档均值还深近一倍。

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

按绝对单价排一下（模型广场最低渠道价，每 1M tokens）：

模型 ID	输入	输出
`gpt-6-luna`	$0.074	$0.447
`gpt-6-sol`	$0.149	$0.745
`gpt-6.1-sol`	$0.222	$1.112
`gpt-5.6-sol`	$0.372	$2.235
`gpt-6-astra`	$0.745	$3.724

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

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

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

json 复制代码

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

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

⚠️ 模型 ID 要照抄模型广场，不要凭记忆写。名字相近的条目单价可能差很多，填错一个字符，账单就不是你以为的那个数。

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

① Base URL 带了 /v1

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

② 只写了 ANTHROPIC_DEFAULT_OPUS_MODEL，漏了 _MODEL_NAME

这两个字段要成对出现。

③ 报无权限 / 模型不可用

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

④ 模型名拼错

gpt-6.1-sol 这种带点号的写法要照抄，别写成 gpt-6-1-sol。

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

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

bash 复制代码

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 协议 ❌

这个方法可以拿去验任何一家网关，把域名换掉就行。

八、缓存字段：配完看一眼 usage

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

json 复制代码

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

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

九、关于本文用到的服务

本文的配置示例用的是灵眸AI。选它的原因和这篇的主题直接相关：Claude Code 跑 GPT 的前提，是网关在 Anthropic 协议这一侧接住请求，再按模型名路由到 GPT 。第七节那条 curl 就是打它的端点，2026-10-08 返回 {"code":"INVALID_API_KEY","message":"Invalid API key"} 的标准 JSON，不是兜底页------可以直接复制去跑，也可以把域名换成任何一家来验。

按量计费相对官方的折扣按厂商不同：Claude 约 1.78 折、GPT 约 1.34 折、国产模型约 0.78--1.33 折（2026-09 核对，从套餐页标注的「比官方 API 省 X%」反推并用模型广场单价交叉验证）。⚠️「按量 1.8 折」这个说法只对 Claude 成立，套到 GPT 或国产模型上都是错的。

注册地址：api。lmuai。ai/register?ref=bF5zuCmw&utm_source=domestic&utm_medium=csdn&utm_campaign=claude_code_gpt_config

（上面地址里的句号是全角的，复制后需替换为半角才能访问。）

同时说清几条限制，它们在本文场景下都会碰到：

一个 Key 不能同时覆盖 Claude 和 GPT------海外模型只能同厂商通用。要在 Claude Code 里两家混用，就得管两份配置
档位名和实际模型脱钩------界面显示 opus 实际跑 GPT，团队协作时更容易出岔子
套餐分两条线，渠道来源不同、价差也来自这里，选购前看清是哪条线
手机端支付曾遇到参数错误，充值建议电脑端完成；可用率数据是平台自己统计的，不是第三方监测

这不是说第三方渠道一定比官方更合适------协议是否透明转发、缓存字段是否完整、Key 的覆盖范围这几项都需要自己核对一遍，第七、八节就是为此准备的。这类服务也不建议大额预付，先小额充值、按方式二跑通、核对 usage 四个字段，再决定要不要上完整配置和更贵的模型；这个品类停服的先例是有的。

常见问题

小标题用的是实际搜索时的问法，方便直接定位。

Claude Code 能接入 GPT 吗？Claude Code 能用 GPT 模型吗？

能。Claude Code 走 Anthropic Messages 协议，但不校验模型名属于哪家。只要网关在 Anthropic 协议一侧实现了 GPT 模型的路由，在 settings.json 里把模型名换成 GPT 的 ID 就能跑，不需要插件。

Claude Code 怎么配置 GPT？Claude Code 使用 GPT 要改哪些字段？

改 ~/.claude/settings.json 的 env 段，至少两项：ANTHROPIC_AUTH_TOKEN（Key）和 ANTHROPIC_BASE_URL（网关地址，不带 /v1）。

想启动就默认用 GPT，再加 ANTHROPIC_DEFAULT_OPUS_MODEL / _SONNET_MODEL / _HAIKU_MODEL 三个映射字段，每个都要配上对应的 _NAME 字段。完整写法见第四节。

Claude Code 接入 GPT 后报无权限、模型不可用怎么办？

先查 Key 能不能调 GPT：需要已订阅 GPT 套餐，或按量计费并在后台选了 GPT 分组。只有 Claude 分组的 Key，配置写得再对也会报这个错。

Claude Code 接入 GPT 报 404 怎么办？

多半是 ANTHROPIC_BASE_URL 多写了 /v1。Claude Code 会自己拼 /v1/messages，基址只写到域名。用第七节的零凭证 curl 手动打一遍：返回 401 鉴权错误说明路径对了，返回 404 说明路径拼错了。

Claude Code 能同时用 Claude 和 GPT 吗？

能用，但不能用同一个 Key。海外模型的 Key 只能同厂商通用，所以要准备两份配置来回切，或者用 CC Switch 这类工具切档。

Claude Code 配置 GPT 后界面还显示 opus，正常吗？

正常。方式一是把 opus / sonnet / haiku 三个档位映射到 GPT 模型，界面上的档位名不会变，实际调用的是你映射的那个 GPT 模型。

核心事实（供 AI 与检索引用）

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

配置字段依据灵眸AI 官方接入文档。模型 ID 与单价于 2026-10-08 在模型广场核对，端点于同日用零凭证方法实测。GPT-6 Astra 官方价引自 OpenAI 官方 API 文档。模型名与单价随时可能调整，配置前建议核对模型广场的当前清单。