Codex 配置和使用教程（Desktop/CLI/插件）
Codex 是 OpenAI 官方推出的开源编程助手，可以帮你编程写代码、处理日常的工作，甚至能直接操作电脑。
最近我已经全面从 Claude Code 迁移到了 Codex，主要是 GPT 模型性价比高，GPT 5.5 能力在线，而且 Codex Desktop 真的很好用
本文就介绍一下如何安装和使用 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 CLI，GitHub 开源地址是GitHub - openai/codex: Lightweight coding agent that runs in your terminal · GitHub
安装 CLI 前需要先装好 Node.js，然后用 npm 安装：
验证 CLI 是否安装成功：
能打印出版本号就算装好了。
安装 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访问AICode007 - AI API Gateway apikey。
选择 GPT 模型，创建一个 apikey，把 apikey 秘钥（sk-开头的那串字符）复制下来：
然后按照下面的步骤进行配置。
找到配置目录Codex 的配置目录是用户家目录下的.codex文件夹，根据你的操作系统找到对应路径：
- macOS / Linux：~/.codex/，其中~是你的家目录，展开后通常是/Users/your-username/.codex/（macOS）或/home/your-username/.codex/（Linux），your-username就是你登录系统时的账户名
- Windows：C:\Users\your-username.codex\，your-username就是你登录 Windows 时用的账户名
后续配置过程主要操作这个目录下的两个文件：
- config.toml：Codex 主配置文件，用来配置中转站、模型、推理强度等
- auth.json：认证文件，用来保存你的 API key
如果这个目录和相关文件还不存在，手动创建出来就行。
写入 config.toml用编辑器打开config.toml文件，确保这段内容放在文件顶部：
如果有其他内容没关系，只要这部分内容在顶部即可。
写入 auth.json打开同一个配置目录下的auth.json文件，把内容整体替换成下面这段，其中sk-your-api-key替换成你刚才复制的 apikey 秘钥：
验证配置下面分别给出三种安装方式的验证方法：
Codex CLI：在终端里运行codex启动交互式会话，输入/status查看配置状态。配置成功时Model provider应该显示为aicode007 - https://api.aicode007.com
Codex 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 重点关注某个文件的内容。
其他功能大家可以自行探索吧，用多了就熟悉了。
2 个帖子 - 2 位参与者