Cursor 配置说明

不支持在 Cursor、Tare 等 Agent IDE 自带的 Agent 配置中使用。

请在 Cursor 或 VSCode 中安装官方 Codex 插件使用。GPT 模型针对 Codex 客户端专门训练，适配程度最好。

VSCode / Cursor 集成

1. 安装官方扩展

在 VSCode 扩展市场安装 OpenAI 官方扩展：

• 扩展：openai.chatgpt
• 市场链接：https://marketplace.visualstudio.com/items?itemName=openai.chatgpt

认准 OpenAI 官方认证标识，避免安装仿冒扩展。

2. 配置 CodexZH

使用一键脚本完成配置，无需手动修改任何文件。

参考：一键脚本配置

3. 重启并验证

配置完成后：

1. 重启 VSCode / Cursor，找到 Codex 插件并打开
2. 打开任意项目（插件在空项目下会提示需先打开项目），发起一次对话或任务

注意：Cursor 的插件需要点击插件页面的箭头展开，不要使用 Cursor 自带的 Agent 聊天框。

4. 使用注意事项

• 历史会话丢失：可能是插件更新导致的兼容性问题
• 模型差异：gpt-5-codex 的文件编辑行为可能与 gpt-5 有差异
• Windows Git 问题：如遇 Git 相关异常，建议等待官方更新

5. 指定模型

插件支持读取 ~/.codex/config.toml 中的 model 字段，无需手动修改插件文件。

在配置文件中设置：

model = "gpt-5.4"

保存后重启 VSCode / Cursor，插件自动使用指定模型。

配置文件完整写法见：环境配置