Codex 配置和使用教程（Desktop/CLI/插件）

Codex 是 OpenAI 官方推出的开源编程助手可以帮你编程写代码、处理日常的工作甚至能直接操作电脑。最近我已经全面从 Claude Code 迁移到了 Codex主要是 GPT 模型性价比高GPT 5.5 能力在线而且 Codex Desktop 真的很好用封面图就是让 Codex 画的本文就介绍一下如何安装和使用 Codex如何在国内使用。目前 Codex 提供了三种安装方式Codex Desktop图形界面客户端使用体验最好我个人推荐用这个Codex CLI命令行客户端灵活轻量适合喜欢在终端开发的用户VSCode 插件直接在 VSCode 侧边栏唤起 Codex 对话面板适合喜欢用 vscode 的用户任意安装方式的使用效果都是一样的按自己的需求来安装即可。安装所有安装方式共用同一份配置都读~/.codex/目录下的配置文件所以根据自己的喜好任选一个或多个安装即可。安装 Codex Desktop推荐如果你喜欢图形化的界面可以用 Codex Desktop在官网下载即可https://openai.com/zh-Hans-CN/codex/get-started/我个人感觉 Codex Desktop 使用体验比 Codex CLI 好而且也更适合新手所以推荐使用 Codex Desktop。安装 Codex CLI如果你喜欢命令行界面可以使用 Codex CLIGitHub 开源地址是 https://github.com/openai/codex安装 CLI 前需要先装好 Node.js然后用 npm 安装npm install -g openai/codex验证 CLI 是否安装成功codex --version能打印出版本号就算装好了。安装 VSCode 插件如果你想要更集成的 IDE 体验比如用 UI 按钮触发会话、直接点击文件引用可以装 Codex 的 VSCode 插件。打开 VSCode打开侧边栏的插件市场搜索Codex找到 OpenAI 官方发布的那个扩展 ID 是openai.chatgpt点 Install装完后 VSCode 侧边栏会出现 Codex 图标点击图标可以打开对话面板就可以和 Codex 对话让它帮你写项目了。配置中转站前面三种形态Desktop / CLI / VSCode 插件共享~/.codex/目录下的配置文件下面的配置过程只需要做一次三个工具都能用。默认情况下 Codex 会引导你登录 ChatGPT 账号如果你能注册并订阅 ChatGPT 会员的话直接登录即可。但是大部分中国用户可能无法注册和订阅 ChatGPT 账号可以用中转站来使用 Codex。中转站的原理就是一个代理由它来解决支付和网络的问题帮你把请求转发到 OpenAI 官方接口方便国内用户使用我最近做了一个中转站 aicode007.com已经稳定运行几个月了需要的读者可以体验下下面的配置过程均以 aicode007.com 为例。创建 API key访问 https://aicode007.com/keys 页面创建 apikey。选择 GPT 模型创建一个 apikey把 apikey 秘钥sk-开头的那串字符复制下来然后按照下面的步骤进行配置。找到配置目录Codex 的配置目录是用户家目录下的.codex文件夹根据你的操作系统找到对应路径macOS / Linux~/.codex/其中~是你的家目录展开后通常是/Users/your-username/.codex/macOS或/home/your-username/.codex/Linuxyour-username就是你登录系统时的账户名WindowsC:\Users\your-username\.codex\your-username就是你登录 Windows 时用的账户名后续配置过程主要操作这个目录下的两个文件config.tomlCodex 主配置文件用来配置中转站、模型、推理强度等auth.json认证文件用来保存你的 API key如果这个目录和相关文件还不存在手动创建出来就行。写入 config.toml用编辑器打开config.toml文件确保这段内容放在文件顶部model_provider aicode007 model gpt-5.5 model_reasoning_effort high model_verbosity high [model_providers.aicode007] name aicode007 base_url https://api.aicode007.com wire_api responses requires_openai_auth true如果有其他内容没关系只要这部分内容在顶部即可。写入 auth.json打开同一个配置目录下的auth.json文件把内容整体替换成下面这段其中sk-your-api-key替换成你刚才复制的 apikey 秘钥{ OPENAI_API_KEY: sk-your-api-key }验证配置下面分别给出三种安装方式的验证方法Codex CLI在终端里运行codex启动交互式会话输入/status查看配置状态。配置成功时Model provider应该显示为aicode007 - https://api.aicode007.comCodex Desktop打开 Codex Desktop 应用在底部输入框右下角能看到当前 provider 是aicode007、模型是5.5 高VSCode 插件在 VSCode 侧边栏点击 Codex 图标打开对话面板在面板底部输入框右下角能看到当前 provider 是aicode007如果你看到的 provider 不是aicode007说明config.toml没生效检查一下配置文件的路径和文件顶部的model_provider aicode007是否正确。如果一切正常就可以和 Codex 愉快地对话了可以跟它发一句 Hello 看看模型是否能正常响应。常用命令在 Codex 的输入框里输入/会弹出所有可用命令的列表按需选择就行不用专门记。下面简单介绍几个常用的命令。/compact手动触发上下文压缩。上下文快满时 Codex 也会自动压缩你也可以提前手动触发避免影响当前任务。/plan切换到 plan 模式。plan 模式下 Codex 不会动你的代码文件写入被禁用它会先探索项目、给出实现计划必要时问几个澄清问题等你确认之后再切回普通模式实际写代码。简单任务直接说需求就行复杂任务建议用 plan 模式先对齐思路。/model查看和切换当前使用的模型同时可以调整推理强度reasoning effort。强度越高效果越好但速度更慢、token 消耗更多根据任务复杂度决定。除了斜杠命令在输入框里用可以引用具体文件让 Codex 重点关注某个文件的内容。其他功能大家可以自行探索吧用多了就熟悉了。