跳过正文
  1. 技术分享/

VS Code / Cursor / Trae Codex 插件接入 Lucoo 客户版教程

目录

这篇适合已经在用 VS Code、Cursor 或 Trae 的客户。三者的思路一样:插件读取的是你电脑上的 Codex 配置,所以先把 ~/.codex/config.toml~/.codex/auth.json 配好,再打开插件。

重点:插件里不要填兑换码。兑换码只用于 Lucoo 后台兑换余额;插件实际调用时需要 sk- 开头 API Key。
IDE 插件接入 Lucoo 流程示意图

一、先准备三样东西
#

项目 填什么
Lucoo 后台 https://cc.lucoo.net
Base URL https://cc.lucoo.net/v1
API Key 后台「API 密钥」里创建的 sk- 开头密钥

备用入口:

  • https://api.lucoo.net/v1
  • https://hkcc.lucoo.net/v1
  • https://sgcc.lucoo.net/v1
  • https://uscc.lucoo.net/v1

防丢主页:https://lucoo.net

二、安装或打开 Codex 插件
#

以下截图来自原始插件安装流程,VS Code / Cursor / Trae 的入口基本一致。

1. 打开扩展面板
#

打开 VS Code 扩展面板

2. 搜索 Codex
#

搜索 Codex 插件

3. 进入 Codex 插件页并安装
#

Codex 插件详情页

4. 如果之前登录过官方账号,先退出旧登录
#

Codex 插件退出旧登录

退出旧登录后,再重新打开 Codex 插件入口。

重新打开 Codex 插件

三、配置 Codex 公共文件
#

Codex CLI 和 IDE 插件共用用户级配置。配置目录如下:

系统 配置目录
macOS / Linux / WSL ~/.codex
Windows C:\Users\你的用户名\.codex

1. 创建 auth.json
#

路径:~/.codex/auth.json

{
  "OPENAI_API_KEY": "sk-这里填你在 Lucoo 后台创建的 API Key"
}

2. 创建 config.toml
#

路径:~/.codex/config.toml

model = "gpt-5.5"
model_provider = "lucoo"
model_reasoning_effort = "xhigh"
sandbox_mode = "workspace-write"
approval_policy = "on-request"
file_opener = "vscode"
web_search = "cached"
suppress_unstable_features_warning = true

[history]
persistence = "save-all"

[tui]
notifications = true

[shell_environment_policy]
inherit = "all"
ignore_default_excludes = false

[features]
unified_exec = false

[model_providers.lucoo]
name = "Lucoo"
base_url = "https://cc.lucoo.net/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

如果你使用的是备用入口,只改这一行:

base_url = "https://hkcc.lucoo.net/v1"

四、重启编辑器并测试
#

配置写完后,请完整退出 VS Code / Cursor / Trae,再重新打开。

测试方法:

  1. 打开一个项目文件夹。
  2. 打开 Codex 插件聊天窗口。
  3. 输入:
请阅读当前项目目录,并告诉我这个项目大概是做什么的。

能正常返回内容,就说明插件已经走 Lucoo 中转。

五、Cursor 和 Trae 怎么办
#

Cursor、Trae 基本也是 VS Code 扩展体系,按下面顺序处理:

  1. 先安装 Codex 插件。
  2. 确认本机存在 ~/.codex/auth.json
  3. 确认本机存在 ~/.codex/config.toml
  4. 完整退出编辑器,再重新打开。
  5. 如果插件里还有模型选择,选择 gpt-5.5 或后台当前可用模型。

不要在多个地方混填不同 Key。新手最稳的方式是:只维护 .codex 目录下这两个文件。

六、常见问题
#

1. 插件报 401
#

原文里的 401 报错,本质就是认证没有通过。优先检查:

  • auth.json 里是否是 sk- 开头 API Key。
  • 是否误把兑换码填进去了。
  • config.tomlmodel_provider 是否是 lucoo
  • base_url 是否带 /v1
  • 改完后有没有重启编辑器。

2. 插件还在跳官方登录
#

先退出插件里的旧账号,再重启编辑器。如果仍然跳登录,先用 Codex CLI 测通,再回插件测试。

3. 找不到 .codex 目录
#

目录不存在就手动创建。Windows 用户可以在资源管理器地址栏输入:

%USERPROFILE%\.codex

如果打不开,就先新建 .codex 文件夹。

4. 模型列表没有 gpt-5.5
#

后台可用模型可能会变,按 Lucoo 后台当前展示的模型名填写。如果客户不知道怎么选,建议先用卖家发货说明里推荐的模型。

七、参考入口
#

相关文章

Cockpit 本地反代与多账号管理教程

Cockpit 是一个本地反代和多账号管理工具,可以在本机统一管理 API Key、ChatGPT 账号、多个账号集合和不同 AI 编程工具的启动配置。常见用途包括一键切号、多账号管理、多开实例、配额监控、唤醒任务、设备指纹、插件联动,以及 GitHub Copilot、Windsurf、Kiro、Cursor、Gemini CLI、CodeBuddy、Qoder、Trae、Zed 等工具的账号管理。