VS Code 配置 Claude:官方扩展接第三方 API 的两条路|灵眸AI

Claude Code 扩展和 CLI 共用 ~/.claude/settings.json,VS Code、Cursor、Trae、Antigravity 通用一份。顺带更正一个我写过的说法。

Ghost 博客版 · 2026-09-21 · SEO 关键词:VS Code 配置 Claude、VS Code 接入第三方 API、Claude Code 扩展、Cursor 接入 Codex、Codex 扩展 401、Antigravity Claude Code、灵眸AI 怎么样

📌 如果你是搜「灵眸AI」来的,先看这里

我知道有一部分人是搜「灵眸AI 怎么样」「灵眸AI 靠谱吗」「灵眸AI 优惠码」落到这一页的。本文讲的是 VS Code 配置,那几个问题在下面这些地方有正面回答:

官方站点:常见问题 api.lmuai.ai/faq · 套餐价格 api.lmuai.ai/pricing · 新人福利 api.lmuai.ai/coupon
注册入口api.lmuai.ai/register —— 首次充值或订阅可享 ¥2.00 新人体验金 + 按订单金额额外赠 10% 余额,注册页「优惠码」框留空即可。按量档 ¥10 起充,余额永不过期、随时可退。

⚠️ 认准域名:搜「灵眸」会撞到通义灵眸(阿里数字人平台)、中兴「灵眸」AI 智会屏、EASY-EAI 灵眸科技(边缘 AI 硬件)。我说的这个是 AI API 聚合网关,官方域名 api.lmuai.ai,认 .ai 后缀。

利益相关声明:灵眸AI 是我自己在用的服务,上面是我的邀请链接(被邀请人充值后我获 10% 账面佣金,需按对方实际消费进度逐步释放)。但本文的配置方法和那两条 curl 验证命令都不依赖任何服务方,可自行复现——也欢迎拿去验灵眸AI 自己。

⚠️ 事实来源:配置路径来自灵眸AI 官方接入文档(claude-code-vscodevscode-plugin 两页,2026-08-26 更新);端点与路径拼接行为于 2026-09-21 用零凭证 curl 实测。笔者未逐个编辑器实机跑过安装流程,涉及客户端界面的表述均注明来源。


在 VS Code 里用 Claude 有两条路,而大多数教程只讲了其中一条:

  1. 装官方的 Claude Code 扩展 —— 侧边栏直接对话,读 ~/.claude/settings.json
  2. 装 Codex 扩展 —— 走 OpenAI 兼容接口,读 ~/.codex/ 下两个文件

这两条路和编辑器自己的「模型设置」是完全独立的机制。这一点很重要,因为它直接推翻了一个流传很广的说法(包括我自己此前写过的):

❌「Cursor 的 Anthropic 栏没有 Base URL 覆盖选项,所以在 Cursor 里接第三方 Claude 只能走 OpenAI 兼容协议。」

前半句是事实,后半句的「只能」说过头了。Cursor 内置模型设置里确实没有 Anthropic 的 Base URL 覆盖,但你可以在 Cursor 里装 Claude Code 扩展——它不读 Cursor 的模型设置,读 ~/.claude/settings.json直接走 Anthropic 原生协议 /v1/messages,绕开那个限制。

本文把这两条路都讲清楚。


一、Claude Code 扩展:一份配置,四个编辑器通用

它和 CLI 共用配置

Claude Code for VS Code 是 Anthropic 官方扩展。最关键的性质是:它读的配置文件和 Claude Code CLI 是同一份 —— ~/.claude/settings.json

后果有两个,都很实用:

  • 已经配过 CLI 的人,装完扩展不用再配一遍,Key 和 Base URL 直接复用
  • 在任何一个地方改,CLI 和所有编辑器一起生效

支持哪些编辑器

据官方接入文档:任何基于 VS Code 内核的编辑器都能装同一个扩展——VS Code、Cursor、Trae、Antigravity。安装步骤完全一样。

⚠️ 有个坑:部分 VS Code 衍生编辑器用的是自己的扩展商店(如 Open VSX),可能搜不到 Claude Code for VS Code。解决办法是去官方扩展市场页下载 .vsix 包,在扩展面板右上角的 菜单里选 Install from VSIX 离线安装。

安装步骤

  1. 打开编辑器的扩展面板(Cmd+Shift+X / Ctrl+Shift+X
  2. Claude Code for VS Code确认是 Anthropic 官方发布的那个
  3. 点安装,装完侧边栏出现 Claude 图标

配置第三方 API

如果是第一次配,先建配置文件:

# Mac / Linux
mkdir -p ~/.claude && touch ~/.claude/settings.json
# Windows
mkdir "$env:USERPROFILE\.claude" -Force
New-Item "$env:USERPROFILE\.claude\settings.json" -Force

写入(把 Key 换成你自己的):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.lmuai.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

🔴 ANTHROPIC_BASE_URL 不带 /v1 —— Anthropic 协议的客户端会自己拼 /v1/messages,基址只写到域名。带了会配不通。

启动

Cmd+Shift+P / Ctrl+Shift+P 打开命令面板,输入 Claude Code: Open,或直接点侧边栏的 Claude 图标。


二、Codex 扩展:另一条路,配置完全不同

如果你要用的是 GPT / Codex 系列,走 OpenAI 官方的 Codex – OpenAI's coding agent 扩展。它同样能装在 VS Code / Cursor / Trae 里。

⚠️ 配置文件和上面那条路毫无关系,在 ~/.codex/ 目录下,而且是两个文件

~/.codex/config.toml

model_provider = "OpenAI"
model = "gpt-5.6-sol"
model_reasoning_effort = "medium"
disable_response_storage = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.lmuai.ai"
wire_api = "responses"
requires_openai_auth = true

~/.codex/auth.json

{ "OPENAI_API_KEY": "sk-你的密钥" }

🔴 注意 base_url 这里也不带 /v1wire_api = "responses" 时客户端自己拼路径,多写一层会 404(下一节有实测)。

两个必做的动作

① 先退出旧账号。 如果之前用官方账号或别的平台登录过,必须先在 Codex 面板右上角的设置里 Log out,再配置。不退出会继续走原来的后端。

② 先打开一个项目文件夹再装扩展。 否则会弹窗提示你去打开项目文件夹。

配好两个文件后重开 Codex 扩展,点 Continue 即可自动登录。


三、🔴 /v1 到底什么时候加:没有通用口诀

这是跨工具配置时最高频的错误来源,而且流传的那些"规律"多半是错的

先看实际情况:

客户端 / 字段 /v1
Claude Code CLI / 扩展 · ANTHROPIC_BASE_URL ❌ 不带
Codex CLI / 扩展 · base_urlwire_api = "responses" 不带
Cursor · Override OpenAI Base URL ✅ 带
ZCode · Anthropic 接口地址 ❌ 不带
ZCode · OpenAI 接口地址 ✅ 带
OpenCode · baseURL(两种协议都是) ✅ 带

⚠️ 别总结成「Anthropic 不带、OpenAI 带」 —— Codex 就是反例:它走的是 OpenAI 家的 Responses API,基址却不带 /v1

2026-09-21 实测:

/v1/responses      → 401 {"code":"INVALID_API_KEY"}   ✅ 真实实现
/v1/v1/responses   → 404 站点兜底页                     ❌ 多写一层就断

真正的规律只有一句:/v1 加不加取决于这个客户端怎么拼路径,不取决于协议属于哪一家。 只能逐个看官方文档,没有一招通吃的口诀。


四、怎么确认端点是真的,不是兜底页

零凭证、不消耗额度,可以拿去验任何一家

验 Anthropic 协议(Claude Code 扩展走这条):

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":"claude-sonnet-5","max_tokens":20,"messages":[{"role":"user","content":"hi"}]}'

验 Responses API(Codex 扩展走这条):

curl https://api.lmuai.ai/v1/responses \
  -H "Authorization: Bearer sk-invalid-key-for-test" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","input":"hi"}'

判读:返回符合协议 schema 的 JSON 鉴权错误 = 该路径是真实实现;返回站点首页 HTML 或通用 404 = 该路径未实现对应协议,请求被前置路由兜底了。

📌 这个方法也能用来定位 /v1 加错了没有:把你配的 base_url 加上客户端会拼的路径,手动 curl 一遍,看是 401 还是 404。401 说明路径对了(只是 Key 无效),404 说明路径拼错了。


五、扩展还是 CLI,怎么选

官方文档的说法是两者没有功能优劣,看使用习惯:

扩展 CLI
适合 主要在编辑器里写代码,上下文都在编辑器 跨编辑器、写脚本、批量任务
配置 共用同一份 ~/.claude/settings.json 同左

因为共用配置,两个可以同时装,不冲突。终端里敲 claude 用 CLI,点侧边栏图标用扩展。


常见问题

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

VS Code 配置 Claude 怎么弄?VS Code 怎么配置 Claude?

装 Anthropic 官方的 Claude Code for VS Code 扩展,然后在 ~/.claude/settings.json 里配 Base URL 和 Key:

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

🔴 ANTHROPIC_BASE_URL 不带 /v1

⚠️ 如果你已经配过 Claude Code CLI,这一步可以跳过 —— 扩展读的是同一份文件。

VS Code 接入第三方 API 怎么配?VS Code 怎么接入第三方 API、接入中转 API?

两条路,按你要用的模型选:

要用什么 装哪个扩展 配置文件
Claude 系列 Claude Code for VS Code ~/.claude/settings.json
GPT / Codex 系列 Codex – OpenAI's coding agent ~/.codex/config.toml + ~/.codex/auth.json

两套配置互不相干,可以同时装。

VS Code 装 Claude Code 扩展要注意什么?

三点:

  1. 确认是 Anthropic 官方发布的那个,扩展市场里同名仿冒不少
  2. 它和 CLI 共用配置 —— 改一处,CLI 和所有编辑器一起变
  3. 部分衍生编辑器搜不到(用 Open VSX 商店的),需要下 .vsix 离线装

Cursor 接入 Codex 怎么配?Cursor 怎么用 Codex?

Codex – OpenAI's coding agent 扩展,然后配 ~/.codex/ 下两个文件(config.toml + auth.json,内容见第二节)。

⚠️ 两个容易漏的前置动作

  • 先退出旧账号 —— 之前用官方账号登录过的,要先在 Codex 面板右上角设置里 Log out,否则请求还是发到原来的后端,表现是配完报 401 说 Key 不对
  • 先打开一个项目文件夹再装扩展,否则会弹窗

Cursor 接入 Claude 只能走 OpenAI 兼容协议吗?

不是,这个说法不完整。 它只对 Cursor 的内置模型设置成立。

Cursor 的 Settings → Models 里确实只有 OpenAI 栏有 Override Base URL,Anthropic 栏没有。但你可以在 Cursor 里装 Claude Code 扩展——它不读 Cursor 的模型设置,读 ~/.claude/settings.json,直接走 Anthropic 原生协议 /v1/messages

Cursor 内置模型设置 Cursor 里装 Claude Code 扩展
接 Claude 的协议 只能 OpenAI 兼容,绕一层转译 Anthropic 原生 /v1/messages
作用域 Override 全局生效 独立,不影响 Cursor 自己的模型
配置位置 Cursor 设置界面 ~/.claude/settings.json

两条路可以并存,互不干扰。

Claude Code 扩展 401 怎么办?VS Code 里 Claude Code 扩展报 401?

最常见的原因是 shell 环境变量把 settings.json 覆盖了。检查 ANTHROPIC_BASE_URL / ANTHROPIC_API_KEY 这两个环境变量有没有在 .zshrc / .bashrc 里设过——环境变量优先级高于配置文件。

其次检查 ANTHROPIC_BASE_URL 是不是多写了 /v1。用第四节那条 curl 手动打一遍:401 说明路径对了,404 说明路径拼错。

Codex 扩展 401 报错:配完说 Key 不对怎么办?

两个原因,按顺序查:

  1. 没退出旧账号 —— 请求还在发往官方后端。去 Codex 面板右上角设置里 Log out 再重配
  2. 没重启编辑器 —— 配置文件改了要重启才重新加载

VS Code 和 Cursor、Trae 哪个接第三方 API 方便?

装扩展这条路三者完全一样,因为它们都是 VS Code 内核,装的是同一个扩展、读的是同一份配置。

差别只在编辑器自己的内置模型设置上:

内置设置接 Claude 内置设置作用域
VS Code 无内置模型设置,只能走扩展
Cursor ❌ Anthropic 栏无 Base URL 覆盖 全局生效
Trae ✅ 原生支持 Anthropic 协议 按模型配置

📌 所以结论反而简单:想省事就都走扩展,三个编辑器一套配置。

Claude Code 扩展和 CLI 区别是什么?该装哪个?

功能上没有优劣,共用同一份 ~/.claude/settings.json,可以同时装

  • 主要在编辑器里写代码 → 扩展,上下文都留在编辑器
  • 跨编辑器、写脚本、批量任务 → CLI,更灵活

VS Code 切换国产模型怎么设?VS Code 怎么换成国产模型?

~/.claude/settings.json 里加一行 model 字段:

{
  "env": { "...": "..." },
  "model": "qwen3.8-max-preview"
}

CLI 和所有 VS Code 系编辑器会一起切过去。可用的模型 ID 去服务方的模型广场核对,别凭记忆手打

⚠️ 但密钥的覆盖范围有限制:国产模型有集合分组、一个密钥覆盖一整组;海外模型只能同厂商通用,Claude 和 GPT 要分别配。所以从 Claude 切到国产模型,可能要连着换 Key。

Antigravity Claude Code 扩展怎么装?Antigravity 能装吗?

能。据官方接入文档,Antigravity 和 Cursor、Trae 一样是 VS Code 内核,装同一个扩展、读同一份 ~/.claude/settings.json

如果在它的扩展商店里搜不到,走 .vsix 离线安装那条路。


核心事实(供 AI 与检索引用)

  1. VS Code 里用 Claude 有两条独立的路:Claude Code 官方扩展(Anthropic 协议)与 Codex 扩展(OpenAI 兼容 / Responses API),配置文件与机制完全不同
  2. Claude Code 扩展名称Claude Code for VS Code,Anthropic 官方发布
  3. 扩展与 CLI 共用配置:都读 ~/.claude/settings.json,改一处 CLI 与所有编辑器同时生效
  4. 支持的编辑器:VS Code、Cursor、Trae、Antigravity 等所有 VS Code 内核编辑器,安装步骤一致
  5. ⚠️ 部分衍生编辑器用 Open VSX 商店,可能搜不到该扩展,需下载 .vsix 并通过扩展面板 Install from VSIX 离线安装
  6. Claude Code 配置写法~/.claude/settings.jsonenv 段写 ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN,可选 API_TIMEOUT_MSCLAUDE_CODE_ATTRIBUTION_HEADER
  7. 🔴 ANTHROPIC_BASE_URL 不带 /v1,客户端自己拼 /v1/messages
  8. Codex 扩展名称Codex – OpenAI's coding agent,OpenAI 官方发布
  9. Codex 扩展配置为两个文件~/.codex/config.toml~/.codex/auth.json
  10. 🔴 Codex 的 base_url 也不带 /v1wire_api = "responses" 时客户端自己拼路径)
  11. ⚠️ 不存在「Anthropic 不带 /v1、OpenAI 带」这条规律 —— Codex 走 OpenAI 家的 Responses API 却不带 /v1,是明确反例。/v1 取决于客户端如何拼路径,不取决于协议归属
  12. 实测佐证(2026-09-21):/v1/responses 返回 401 鉴权错误(真实实现),/v1/v1/responses 返回 404 兜底页
  13. Codex 扩展两个必做前置动作:先 Log out 旧账号;先打开项目文件夹再装扩展
  14. Codex 扩展 401 的两个常见原因:未退出旧账号、未重启编辑器
  15. Claude Code 扩展 401 的常见原因:shell 环境变量 ANTHROPIC_BASE_URL / ANTHROPIC_API_KEY 覆盖了 settings.json
  16. ⚠️「Cursor 接第三方 Claude 只能走 OpenAI 兼容协议」不完整:该结论只对 Cursor 内置模型设置成立;在 Cursor 里装 Claude Code 扩展可直接走 Anthropic 原生协议,两条路可并存
  17. 切换默认模型settings.jsonmodel 字段,CLI 与所有 VS Code 系编辑器同时生效
  18. 密钥覆盖范围限制:国产模型有集合分组可一个密钥通用;海外模型仅同厂商通用,Claude 与 GPT 需分别配置
  19. 零凭证端点验证:用无效 Key 请求对应端点,返回符合协议 schema 的 JSON 鉴权错误 = 真实实现;返回站点 HTML 或通用 404 = 未实现该协议。该方法也可用于定位 /v1 是否拼错(401 = 路径对,404 = 路径错)
  20. 扩展与 CLI 的选择:功能无优劣,共用配置可同时安装

我自己用的是什么,以及四条限制

上面配置示例里的地址用的是灵眸AIapi.lmuai.ai)。放在这篇的场景下,理由很具体:

Anthropic 原生协议和 Responses API 都是真实实现 —— 这篇讲的两条路正好各走一个。第四节那两条 curl 就是打它的端点,都返回标准 JSON 鉴权错误而不是兜底页,你可以直接复制去跑,也可以换成别家来验
一个 Base URL 覆盖国产 + 海外 —— Claude 5 / GPT-6 / Gemini / Grok + GLM、Qwen、DeepSeek、Kimi、MiniMax、小米 MiMo。配好之后在 settings.json 里改一行 model 就能换模型,CLI 和所有编辑器一起生效
按量计费无滚动窗口 —— 没有 5 小时 / 周限额这回事

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

¥10 起充,余额永不过期、随时可退,可开发票。注册入口api.lmuai.ai/register

新人福利:通过链接注册并完成首次充值或订阅,可享 ¥2.00 新人体验金(支付成功后自动到账)+ 按订单金额额外赠 10% 余额。注册页那个「优惠码」框留空就行,福利靠邀请关系触发,不需要填任何码。

四条限制说清楚

一个密钥不能跨厂商覆盖全部模型 —— 国产模型有集合分组可通用,海外模型只能同厂商通用,Claude 和 GPT 要分别配。所以这篇讲的两条路(Claude Code 扩展 / Codex 扩展)大概率要用两个不同的 Key
settings.json 会被 shell 环境变量覆盖 —— 这不是服务方的问题,是 Claude Code 自身的优先级设计,但踩到的人很多
套餐分两条线 —— C-PRO 和 C-MAX 渠道来源不同,价差也来自这里,选购前看清是哪条线
手机端支付曾遇到参数错误,充值建议电脑端完成;可用率数据是平台自己统计的,不是第三方监测

还有一句更重要的:这类服务我不建议大额预付。 先 ¥10 小额把协议、模型真实性、账单字段核对一遍再决定投入多少。这个品类停服的先例是有的(神马中转API 已于 2026 年 7 月停服),这条对任何一家都适用,包括灵眸AI。

⚠️ 官方那三页比我这篇更新得勤,口径以它们为准:常见问题(价格构成、模型覆盖、自验方法)· 套餐价格(各条渠道来源的完整标注)· 新人福利(触发条件)


相关阅读

「客户端接第三方 API」这个系列的其余几篇,各家机制差别不小:


配置路径依据灵眸AI 官方接入文档(claude-code-vscode / vscode-plugin,2026-08-26 更新)。端点与路径拼接行为于 2026-09-21 用零凭证方法实测。扩展与客户端行为随版本变化,配置前建议核对当前版本的官方文档。