VS Code / Cursor 插件接入 AI API 中转站指南

如果你在 VS Code 或 Cursor 里同时用过 Cursor 原生 AI、Claude Code、Codex、Cline、Roo Code，第一步不是填 Key，而是先分清谁在发请求、谁读取哪份配置。

重要修正：Cursor 自己的 provider / base URL 设置，通常不会自动改掉 Claude Code 扩展、Codex 扩展、Cline 或 Roo Code 的请求线路。每个工具都有自己的登录态、配置入口和模型列表。排错时必须先确认当前报错来自哪个面板。

配置层级速查

一句话记忆：Cursor 原生看 Cursor，Claude Code 看 Claude Code settings/env，Codex 看 .codex，Cline/Roo Code 看 OpenAI Compatible provider 表单。

统一准备项

开始前先准备好：

• API Key：从账户页面复制。
• Claude Code 中转地址：本文示例沿用 https://www.aigcwuji.com。
• Codex / OpenAI 兼容地址：Codex、Cline、Roo Code、OpenAI compatible SDK 常用 https://www.aigcwuji.com/v1。
• 模型名：只用账户页面展示值，不猜官方 model id。

经验上，真正最容易出错的不是安装扩展，而是编辑器还在读旧进程、旧配置或旧登录态。改完配置后，最好完全退出编辑器和终端再重开。

Claude Code：VS Code / Cursor 扩展怎么接中转站

官方资料里值得先知道的点

Anthropic 官方 IDE integration 文档说明：

• Claude Code 扩展是官方推荐的 VS Code 图形界面用法，可安装到 VS Code 和 Cursor。
• 扩展支持 Spark 图标、Activity Bar、状态栏入口、@文件/目录 引用、选区带行号引用、Plan 模式、Diff 审批、多会话等。
• 扩展有 Extension settings in VS Code，用于控制扩展在编辑器里的行为，例如默认权限模式、打开位置、是否使用 terminal 模式。
• Claude Code 也有自己的 settings/env。官方 settings 文档说明 settings.json 有 user、project、local、managed 等层级，并且支持 VS Code / Cursor 的 JSON schema 与自动补全。
• 如果编辑器没有继承 shell 环境变量，官方建议从终端用 code . 启动，或执行 Developer: Reload Window。

另外，Anthropic LLM gateway 文档说明：当 ANTHROPIC_BASE_URL 指向 Anthropic Messages format 的 gateway 时，Claude Code 启动时会查询 gateway 的 /v1/models，并把发现的模型加入 /model 选择器；如果失败，会回退到缓存或内置模型列表。

这意味着：Claude Code 的中转配置属于 Claude Code settings/env，不属于 Cursor 原生 provider 设置。

安装步骤

1. 在 VS Code / Cursor 的扩展市场搜索 Claude Code。
2. 安装后，打开编辑器右上角 Spark 图标、左侧 Activity Bar 或状态栏入口。
3. 如果是第一次打开，会先看到登录或初始化界面。

Extension settings vs Claude Code settings/env

如果你走中转站，Base URL / Key 通常应该按 Claude Code 的 gateway/env 方式配置，而不是改 Cursor 原生 provider。编辑器里的 Extension settings 更多是“扩展怎么显示、怎么交互”。

Windows

%USERPROFILE%\.claude\settings.json

macOS / Linux

~/.claude/settings.json

推荐最小示例：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-xxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://www.aigcwuji.com",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "78"
  }
}

如果你已有 settings.json，不要整文件覆盖；只合并 env 里缺少的字段。项目级 .claude/settings.json 不要写入私人 Key。

验证是否真的走了中转

1. 保存配置。
2. 完全退出 Claude Code、编辑器和终端。
3. 重新打开编辑器；必要时从终端启动，让 IDE 继承环境变量。
4. 在 Claude Code 面板发送短消息：

请回复“配置已生效”。

如果仍然看到默认登录逻辑、模型列表不对或提示未登录，优先排查：

• 你改的是 Cursor 原生 provider，而不是 Claude Code settings/env。
• 编辑器没有继承新的环境变量。
• 旧终端或旧扩展进程还在。
• VS Code / Cursor Extension settings 和 ~/.claude/settings.json 混淆了。
• 当前仍是账号登录态，和你想要的 Key / gateway 路线不一致。
• gateway 没有按 Anthropic Messages format 暴露必要接口，或 /v1/models 返回不符合 Claude Code 过滤规则。

Claude Code 扩展适合谁

更适合：

• 想在编辑器里直接看 Diff 和审批。
• 想保留 @文件、Plan 审阅、多会话工作流。
• 想把 CLI 和 IDE 工作流放在一套工具里。

如果你只想要最稳定、最可控的中转站手动配置，先看：

• Claude Code 中转站手动配置教程

Codex：VS Code / Cursor 扩展怎么接中转站

官方资料里值得先知道的点

OpenAI 官方 Codex IDE 文档说明：

• Codex IDE 扩展支持 VS Code、Cursor、Windsurf 等 VS Code 兼容编辑器。
• 默认会出现在编辑器侧边栏。
• 在 Cursor 中，Activity Bar 可能是横向布局，图标会被折叠；官方建议临时改成竖向后，把 Codex 拖到右侧边栏。
• 扩展可用 ChatGPT 账号或 API Key 登录。
• 扩展支持模型切换、reasoning effort、Chat / Agent / Agent (Full Access)、@文件 引用、云端任务委派等。

OpenAI 官方 config basics 文档还说明：Codex CLI 和 IDE 扩展共享配置层级，用户配置在 ~/.codex/config.toml，项目覆盖可放 .codex/config.toml，扩展内可通过齿轮菜单打开 config.toml。

这意味着：Codex 的 provider、默认模型、审批和 sandbox 等底层行为，不靠 Cursor 原生 AI 设置控制。

安装步骤

1. 在 VS Code / Cursor 搜索并安装 Codex（扩展 ID 为 openai.chatgpt）。
2. 打开侧边栏里的 Codex 面板。
3. 若在 Cursor 中没看到面板，先检查图标是否被折叠；必要时临时把 Activity Bar 改成竖向，再把 Codex 拖到右侧边栏。

登录和配置文件

官方支持两种主路线：

• 用 ChatGPT 账号登录。
• 用 API Key 路线。

如果你要明确控制中转站、模型和 provider，通常更建议走 API Key + config.toml/auth.json 这条路。

Windows

%USERPROFILE%\.codex\config.toml
%USERPROFILE%\.codex\auth.json

macOS / Linux

~/.codex/config.toml
~/.codex/auth.json

最小示例：

model_provider = "custom"
model = "gpt-5.4"

[model_providers.custom]
name = "custom"
base_url = "https://www.aigcwuji.com/v1"
wire_api = "responses"
requires_openai_auth = true

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxx"
}

如果已有 config.toml，不要清空整文件，只确认 model_provider、model 和 [model_providers.custom] 指向目标线路。项目级 .codex/config.toml 只有在 Codex 信任该项目后才会加载；私人 Key 仍建议放用户级 auth.json。

你在插件里最该先调的 4 个开关

1. Model：选择账户页面可用的模型名。
2. Reasoning effort：先用 medium，复杂任务再升高。
3. Approval mode：
   • Chat：只聊天、先规划。
   • Agent：默认模式，可读文件、改文件、运行工作目录内命令。
   • Agent (Full Access)：放得更开，风险也更高。
4. Cloud delegation：长任务可丢到云端跑，回头再本地接力。

验证是否真的走了中转

1. 保存 config.toml 和 auth.json。
2. 完全退出 Codex、编辑器和终端。
3. 重新打开后先看登录状态：

codex login status

4. 再发短消息测试，确认模型、Key、线路是否符合预期。

如果改完还是不生效，优先排查：

• model_provider 没指向 custom。
• auth.json 放错目录。
• 旧登录态覆盖了当前 API Key 路线。
• 项目 .codex/config.toml 优先级覆盖了用户级配置。
• 编辑器扩展仍在读旧进程。
• Cursor 里 Codex 图标被折叠，你看到的其实不是 Codex 面板。

如果你只想先把 Codex 手动配置跑通，再回编辑器集成，先看：

• Codex API 手动配置指南

Cline / Roo Code：走 OpenAI Compatible，不走 Claude/Codex 专用配置

Cline 和 Roo Code 的常见接法更直接：它们在扩展设置面板里选择 OpenAI Compatible provider，然后填写 Base URL、API Key 和 Model ID。

对这类工具，通常填 https://www.aigcwuji.com/v1，不是 Claude Code 的 ANTHROPIC_BASE_URL，也不是 Codex 的 ~/.codex/config.toml。

Cline 简要步骤

1. 打开 Cline 设置面板。
2. API Provider 选择 OpenAI Compatible。
3. Base URL 填 https://www.aigcwuji.com/v1。
4. API Key 填账户页面生成的 Key。
5. Model ID 填账户页面展示的模型名。
6. 点击 Verify 或发送短消息验证。

Roo Code 简要步骤

1. 打开 Roo Code 设置面板。
2. API Provider 选择 OpenAI Compatible。
3. Base URL 填 https://www.aigcwuji.com/v1。
4. API Key 填账户页面生成的 Key。
5. Model 选择或输入账户页面模型名。
6. 如果出现 tool-calling 相关错误，优先换成明确支持 OpenAI native tool calling 的模型。

更详细的步骤看：

• Cline / Roo Code 配置入口
• OpenAI 兼容 API Base URL 总指南

不要混用的 5 个点

1. 不要用 Cursor 原生 provider 去排 Claude Code / Codex 的错：先确认你打开的是哪个面板。
2. 不要把 Claude Code 的 ANTHROPIC_BASE_URL 写进 Cline/Roo Code：Cline/Roo Code 用 OpenAI Compatible provider 表单。
3. 不要把 Codex 的 ~/.codex/config.toml 当成全局 AI 插件配置：它只管 Codex CLI/IDE 配置层级。
4. 不要把 Base URL 的 /v1 到处复制：Codex、Cline/Roo Code 和 OpenAI Compatible SDK 通常要带 /v1；Claude Code 的 ANTHROPIC_BASE_URL 通常不带。按当前工具要求填写。
5. 不要凭教程猜模型名：模型名以账户页面和当前 provider 实际支持为准；Roo Code 还要确认 tool calling 支持。

常见问题

VS Code / Cursor 里装好扩展后，为什么还是走默认账号？

通常是因为：

• 当前扩展仍使用旧登录态。
• 编辑器没有继承你新写入的环境变量。
• 你改的是 Cursor 原生 API 设置，但实际报错来自 Claude Code / Codex / Cline / Roo Code。
• 你改的是 Claude Code / Codex 共享配置，但扩展会话还没重启。

先完全退出编辑器，再重开；Claude Code 场景下可尝试从终端启动编辑器，让它继承环境变量。

Claude Code、Codex、Cline、Roo Code 分别适合什么场景？

• Claude Code：更强调 Anthropic 官方 IDE/CLI 一体化、计划审阅、@文件、Diff 审批、多会话。
• Codex：更强调 OpenAI 官方 IDE/CLI 一体化、Chat/Agent/Full Access、reasoning effort、云端任务。
• Cline：适合想用 OpenAI compatible provider 表单快速接入不同模型的用户。
• Roo Code：适合需要 OpenAI compatible + 原生工具调用工作流的用户，但要确认模型 tool calling 能力。

插件里看到的模型和账户页面不一致怎么办？

先以账户页面和扩展当前 provider 为准。不要凭印象填写 model id，更不要把别家教程里的模型名直接复制过来。

我只想配置 Cursor 自带 AI，不想装扩展怎么办？

看 Cursor 原生配置页，不要套用 Claude Code / Codex / Cline / Roo Code 的步骤：

• Cursor API 配置入口
• OpenAI 兼容 API Base URL 总指南

参考资料

• Anthropic Claude Code IDE integrations: https://docs.anthropic.com/en/docs/claude-code/ide-integrations
• Anthropic Claude Code settings: https://docs.anthropic.com/en/docs/claude-code/settings
• Anthropic Claude Code LLM gateway: https://docs.anthropic.com/en/docs/claude-code/llm-gateway
• OpenAI Codex IDE extension: https://developers.openai.com/codex/ide
• OpenAI Codex config basics: https://developers.openai.com/codex/config-basic
• Cline OpenAI Compatible provider: https://docs.cline.bot/provider-config/openai-compatible
• Roo Code OpenAI Compatible provider: https://docs.roocode.com/providers/openai-compatible

相关页面

• Claude Code 中转站手动配置教程
• Codex API 手动配置指南
• Cursor API 配置入口
• Cline / Roo Code 配置入口
• OpenAI 兼容 API Base URL 总指南
• 429 与余额排查
• Model Not Found 排查