Codex 插件使用

本指南将帮助你在 VSCode、Cursor、Trae 等编辑器中使用 Codex 插件。

开始之前

请确保你已准备好：

VSCode / Cursor / Trae 等编辑器（插件方式），或 Node.js 20+（CLI 方式）
一个有效的 API 密钥

如果你还没有 API 密钥，请先前往密钥管理界面创建一个。

Codex 插件（VSCode / Cursor / Trae）

安装插件

在编辑器的扩展市场搜索 codex 或 openai，找到 Codex 插件并安装。

在扩展市场搜索 Codex 并安装

打开 Codex 插件，选择第一个登录选项（Provide your own API key），输入 null 即可。

选择第一个选项登录

如果跳转到浏览器，请返回编辑器按 Esc 键跳过。

配置环境

在用户目录下创建 .codex 文件夹（如果没有），然后创建 config.toml 文件：

Windows: C:\用户\你的用户名\.codex\config.toml
Mac / Linux: ~/.codex/config.toml

将 config.toml 放到 .codex 目录下

文件内容如下：

model_provider = "mmkg"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.mmkg]
name = "mmkg"
base_url = "https://yy.52ai.ai"
wire_api = "responses"
requires_openai_auth = true

配置 API 密钥

在同一个 .codex 目录下创建 auth.json 文件：

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

将 sk-你的API密钥 替换为你在密钥管理界面获取的真实密钥。

授权文件编辑权限

重启编辑器和终端。首次使用时，Codex 会请求文件编辑权限，点击允许即可。

授权文件编辑权限

开始使用

使用配置文件后，插件默认使用 gpt-5.3-codex 模型，无需手动选择。鼠标移到模型名称处可确认。

鼠标移到模型处确认显示 5.3

常见问题

按教程配置还是无法连接？

重启所有编辑器和终端后再试
确认浏览器能打开 yy.52ai.ai
删除 .codex 文件夹下的所有文件，重新配置

VSCode SSH 连接远程仓库怎么使用？

需要将 config.toml 配置文件复制到远程服务器的 ~/.codex 目录。

退出登录

CLI: 终端输入 codex logout。插件: 在插件设置中退出。

下一步