VS Code / Cursor / Windsurf Codex 插件教程

这篇介绍的是 Codex 插件。如果你要配置 Cursor 自带模型，而不是 Codex 插件，请看 Cursor 自定义接口教程。

Codex CLI、独立 Codex Desktop App 和 IDE 插件共用 Codex 认证存储与用户目录中的 .codex/config.toml，不需要为每个编辑器重复维护一套 Key。

1. 安装 Codex 插件

1. 打开 VS Code、Cursor 或 Windsurf 的扩展面板。
2. 搜索 Codex。
3. 核对插件名称与发布者后安装。
4. 如果插件以前登录过其他账号，先退出旧登录。

插件支持的编辑器和系统可能变化，以 Codex IDE 官方说明 为准。

在编辑器中打开 Codex 面板；产生修改后通过 **Review** 检查文件差异，再决定接受或撤销。

2. 配置共享认证和 Provider

先安装 Codex CLI，并严格按照 Codex CLI 教程 中的“4. 登录共享认证存储”步骤运行 codex login --with-api-key。不要手写 auth.json；登录命令会生成认证模式为 api_key 的共享认证状态。

然后按同一教程中的“5. 写入公共配置”步骤创建 .codex/config.toml。三种 Codex 入口使用同一份配置：

model = "YOUR_MODEL_ID"
model_provider = "duckmans"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[model_providers.duckmans]
name = "DuckMans"
base_url = "https://duckmans.com/v1"
wire_api = "responses"
requires_openai_auth = true

requires_openai_auth = true 表示 DuckMans Provider 使用 codex login --with-api-key 创建的共享认证存储。不要添加 env_key，也不要把真实 Key 写入 config.toml。

把 YOUR_MODEL_ID 替换为 DuckMans 后台当前可用模型 ID。

3. 重启编辑器并测试

完整退出编辑器后重新打开一个测试项目。只关闭插件面板通常不会重新读取配置。

在 Codex 插件中输入：

请读取当前项目目录，并告诉我项目大概做什么，不要修改文件。

排查顺序

1. 在同一系统用户的终端运行 codex，先确认 CLI 可用。
2. CLI 正常后再完全重启编辑器。
3. 401：回到 Codex CLI 重新运行 codex login --with-api-key；不要手动修改共享认证文件。
4. 403：检查 Key 分组和模型权限。
5. 404：确认地址是 https://duckmans.com/v1，没有重复 /v1。
6. 仍走旧 Provider：退出插件旧登录，并确认没有其他配置覆盖 .codex/config.toml。

恢复原配置

恢复修改前备份的 ~/.codex/config.toml，然后完整退出并重启编辑器。若只需停用 DuckMans，不要删除或公开共享认证缓存。