返回 Codex 文档首页 返回文档中心 返回站点文档首页

IDE 扩展教程

适合 VS Code、Cursor、Windsurf 用户。核心原则只有一个：IDE、桌面版、CLI 共用同一个本地配置文件，就是 ~/.codex/config.toml。

官方规则核对日期：2026-03-26
当前推荐主模型：gpt-5.4
当前推荐轻量模型：gpt-5.4-mini

扩展入口

OpenAI 官方 quickstart 页面里包含 VS Code / Cursor / Windsurf / VS Code Insiders 的安装入口。
如果你是 Cursor 或 Windsurf 用户，直接按官方 quickstart 对应按钮安装最稳。

开始前你要准备什么

  1. 一个能进入 IDE 扩展的官方登录方式：ChatGPT 账号或 OpenAI API key
  2. 你后台复制出来的完整 YUNCE_API_KEY
  3. ~/.codex/config.toml
  4. 你的项目文件夹
这里同样要分清两层：
1. IDE 扩展首次进入产品时，官方可能要求你先登录
2. 真正模型请求仍然通过你本机配置里的 yunce provider 走中转站

完整步骤

  1. 先安装 IDE 扩展
  2. 按官方界面完成登录
  3. 设置环境变量 YUNCE_API_KEY
  4. 把配置文件保存到 ~/.codex/config.toml
    下载地址：/docs/codex/yunce-codex-config.example.toml
  5. 完全关闭编辑器，再重新打开一次
    这是为了让编辑器重新读取新的环境变量和配置
  6. 打开你的项目文件夹
  7. 在侧边栏打开 Codex 面板
  8. 如果界面里能选模型，优先选 gpt-5.4
    想更快更省且后端支持，再选 gpt-5.4-mini
    如果后端暂时没有新 mini，再退回 gpt-5-codex-mini
  9. 第一次直接输入：reply exactly ok

你在 IDE 里真正要用什么

产品登录层:
ChatGPT account or OpenAI API key

本机配置文件:
~/.codex/config.toml

环境变量:
YUNCE_API_KEY

中转站地址:
https://yunce.cloud/v1

推荐模型:
gpt-5.4

推荐轻量模型:
gpt-5.4-mini

代码能力优先备选:
gpt-5.3-codex

Windows 用户额外建议

如果你在 Windows 上用 VS Code，而且项目本身也在 WSL 里，建议直接用 WSL Remote 打开仓库。
这样 CLI、终端、沙箱行为会更接近 OpenAI 官方当前推荐的 Windows 方式。

如果 IDE 里还是不对