OpenAI 的 Codex 是目前最强悍的 AI 编程助手之一，但很多人卡在了"用上"这一步：账号注册、Plus 充值、网络环境、配置文件，随便一个环节就能劝退。这篇文章把两个关键问题一次性解决：Codex 怎么用，以及 国内怎么用 Codex。

Codex 是什么，有哪些入口

Codex 是 OpenAI 推出的 AI 编程 Agent，能够在你本地环境中自主完成代码编写、调试、文件操作等任务。它有四个主要入口：

• Codex CLI：命令行工具，适合习惯终端的开发者
• Codex 桌面 App：图形化界面，工程化能力最强，支持 Computer Use 和浏览器控制
• Codex IDE 插件：集成在 VS Code 等编辑器中使用
• ChatGPT 手机端：在手机 App 中连接桌面端或远程开发机，随时随地审批和调整任务

开源项目 CodexGuide 按"认识入口、跑通任务、建立方法、团队沉淀"四层组织，从 CLI 入门到桌面端高级用法全覆盖。

开始前的准备

• 一个 OpenAI 账号（注册地址：chatgpt.com）
• ChatGPT Plus 订阅（$200/月，Codex 桌面端必需）
• macOS 或 Windows 系统（桌面端）
• 稳定的网络环境

如果你在国内，Plus 充值有门槛，后面会给出三种替代方案。

第一步：安装 Codex 桌面端

从 CodexGuide 提供的教程中找到桌面端下载链接，安装后使用 GPT 账号登录。订阅 Plus 后即可使用完整功能，包括插件系统、Computer Use 等。

订阅 Plus 的教程在 CodexGuide 中有详细步骤，能帮你省去找人代充的麻烦，自己的号更稳定。

第二步：手机端远程操控

Codex 的手机端入口其实是 ChatGPT 手机 App 里的 Codex 入口。它不是独立的 App，而是让你在离开电脑时，通过手机连接正在运行的 Codex 实例，继续查看、审批和调整任务。

配置好后，你几乎可以在任何地方用手机指挥 Mac 上的 Codex 工作。

国内怎么用：三种方案

如果你在国内，充值 Plus 和网络访问都有门槛。以下三种方案按难度递增排列，选择适合你的即可。

方案一：Codex++（推荐新手使用）

Codex++ 是一个图形化管理工具，帮你一键搞定第三方 API 配置，不用手写配置文件，而且支持插件功能。

操作步骤：

1. 从 Codex++ Releases 页面下载两个安装包：「管理工具」和「Codex++ app」
2. 安装后打开管理工具，如果 macOS 提示安全限制，去「系统设置」-「隐私与安全性」点「仍要打开」
3. 在「供应商配置」中添加你的第三方 API 供应商（Base URL 和 Key），接入方式选「纯API」
4. 从 Codex++ 入口启动 Codex（不是原版 Codex）

配置完成后，你就能看到 Codex 已用上自定义模型供应商，可选模型大幅增加，插件也能正常使用。

方案二：手动修改 config.toml

这种方式适合想理解底层配置的开发者。核心是修改 ~/.codex/config.toml 文件。

先备份：

cp ~/.codex/config.toml ~/.codex/config.toml.backup
cp ~/.codex/auth.json ~/.codex/auth.json.backup

修改配置文件：

model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.ciyuan]
name = "ciyuan"
base_url = "https://ciyuan.today/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"
requires_openai_auth = false

设置环境变量：

export OPENAI_API_KEY="你的API Key"

从终端启动 Codex App（Mac 必须从终端启动）：

open -a Codex

注意几个容易踩坑的点：model_provider 要和 [model_providers.xxx] 里的 xxx 完全一致；base_url 只写到 /v1；wire_api 保持 "responses" 不要改。

方案三：CCX + CC Switch（多供应商网关）

如果你有多个 API 供应商需要切换，或者上游只支持 Chat Completions 不支持 Responses API，可以用 CCX 做协议转换，CC Switch 做一键切换。

这个方案组件多，适合有一定网络代理经验的开发者。

实战案例参考

CodexGuide 还收集了 13 个典型实战案例，值得上手试一试：

• Codex x Draw.io MCP：让 AI 自动绘制架构图
• Codex x GitHub Actions：CI 失败自动修复
• Codex x Obsidian：在 Obsidian 中搭建 AI 知识库

资源链接

• CodexGuide 开源项目：GitHub 仓库
• CodexGuide 在线阅读站：提供更好的阅读体验
• Codex++ 下载：GitHub Releases 页面
• Codex 官方文档：OpenAI 官方最新文档

常见问题

• Mac 上直接点图标启动读不到模型怎么办？ 必须从终端用 open -a Codex 启动
• 认证错误怎么排查？ 先检查 model_provider 名称、base_url、环境变量，出问题先切回备份配置
• 上游不支持 Responses API 怎么办？ 用 CCX 网关做协议转换，或换一个支持 Responses API 的供应商