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 CLI，GitHub 开源地址是 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/（Linux），your-username就是你登录系统时的账户名Windows：
C:\Users\your-username\.codex\，your-username就是你登录 Windows 时用的账户名
后续配置过程主要操作这个目录下的两个文件：
config.toml：Codex 主配置文件，用来配置中转站、模型、推理强度等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.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 重点关注某个文件的内容。
其他功能大家可以自行探索吧，用多了就熟悉了。
