VSCode / Cursor 集成

CodexZH 的上手指南明确：新版 VSCode / Cursor 插件已不再推荐使用 settings.json 配置，改为自动读取你在本机的 .codex 配置文件。

1. 安装官方扩展

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

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

提示：官方教程建议认准 OpenAI 官方认证标识，避免安装到仿冒扩展。

2. 配置 CodexZH（关键点）

确保本机已经完成环境配置：

• ~/.codex/config.toml
• ~/.codex/auth.json

详细写法见：环境配置

安装扩展后，VSCode / Cursor 会自动读取上述文件，一般无需再做额外配置。

3. 重启并验证

配置完成后：

1. 重启 VSCode / Cursor
2. 打开任意项目，尝试调用扩展并发起一次对话/任务

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

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