【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 等VSCode 系列 IDE，找到 codex 插件打开后使用。
2. 打开任意项目（不要空项目使用插件，插件会提示让你打开一个项目在使用），尝试调用扩展并发起一次对话/任务

注意 Cursor 的插件需要点击插件页面的箭头才会出现，不要使用 cursor 自带的 agent 聊天框

4. 使用注意事项（来自官方教程）

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

5. 指定使用的模型

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

只需在你的配置文件中设置：

model = "gpt-5.4"

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

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