Codex 使用指南：普通人也能上手的客户端、CLI
wayn约 10 分钟如果你最近才开始关注 Codex，我先给一个最直接的结论：
普通人想上手 Codex，先用官方客户端；想把它接进终端工作流、项目目录和中转配置，再去装 codex-cli。
很多人一看到 Codex，就会下意识把它理解成“另一个 AI 聊天工具”。这其实不对。Codex 的核心价值，不是跟你对话，而是直接进入你的项目、理解上下文、执行任务、修改文件、跑检查，然后把结果交回来。
所以这篇文章我不准备写成说明书，也不打算堆一堆参数。我只想把三件事讲清楚：
最新的 Codex 客户端到底怎么用； codex-cli在 Windows 下怎么安装、登录和开始用；如果你想通过 Unity2.ai 这类中转方式来接 Codex，应该怎么配。
先搞清楚：Codex 到底有哪几种用法
OpenAI 现在给 Codex 提供了几种主要入口，但对普通用户来说，真正需要先理解的其实就两个：
Codex app：桌面客户端，适合直接上手。Codex CLI：命令行版本，适合进阶使用、项目级工作流和自定义配置。
如果你只是想先体验一下 Codex 到底能帮你做什么，我的建议非常明确：先装客户端，不要一上来就碰 CLI。
原因很简单。客户端更直观，你能直接看到线程、任务状态、修改结果、项目预览和权限提示。CLI 的优势在于更灵活，但它天然要求你愿意碰终端、环境变量和配置文件。
换句话说：
想先用起来，选 Codex app想把它接进开发流程，选 Codex CLI想两边都用，也完全没问题，因为它们本来就是同一套生态
最新 Codex 客户端，普通人该怎么上手
从 OpenAI 官方文档和官方仓库现在的写法来看，最新客户端就是 Codex app。官方把它定位成一个更专注的桌面工作区，不只是聊天窗口，而是一个可以并行跑任务、切项目、看项目、做 review 的本地工作台。
对 Windows 用户来说，这一点尤其重要。官方文档已经单独给了 Windows 页面，明确说明 Codex app 可以原生运行在 Windows 上，使用 PowerShell 和 Windows sandbox，也可以按需切到 WSL2，但不是必须。Windows 版的下载入口也很直接，官方现在给的是 Microsoft Store ，搜索 codex 就可以下载。
它最适合什么人
如果你符合下面任意一种情况，先从 app 开始通常是最省事的：
你想先理解 Codex 的工作方式，而不是先折腾命令行； 你更习惯在可视界面里看任务进度、审批和结果； 你会做网页、产品、内容、文档、脚本，但不一定想天天待在终端里； 你希望一边看结果，一边让 Codex 继续改，而不是全靠文字想象。
它和普通聊天工具最大的区别
我觉得可以用一句话概括：
Codex app 不是让你“问问题”的，它是让你“交任务”的。
比如你可以直接让它：
在本地项目里改一个页面； 打开预览页检查视觉问题； 看生成的 PPT、表格、PDF； 在需要的时候进入浏览器或应用界面继续执行。
这也是为什么我更建议普通人先用客户端。你看到的不是抽象回答，而是一个正在做事的 agent。
图 1：Windows 版 Codex app 界面
这张图最能帮助新手建立直觉。左边是项目和线程，中间是 Codex 正在执行的任务，底部是继续追问和补充要求的位置。它的思路不是“开一个聊天框”，而是“围绕项目跑任务”。
客户端里最值得普通人马上用的 3 个功能
1. In-app browser
如果你在 Windows 下用 Codex app，In-app browser 其实很简单：按 Ctrl + Shift + B 打开 Codex 内置浏览器预览，输入浏览地址或者本地文件地址，然后按 Ctrl + . 进入页面元素选择，选中后直接评论即可。
它最适合本地页面预览、公开页面检查和前端细节修改。你不用截图再描述，而是可以直接在页面上点选具体区域，让 Codex 按这个位置继续改。
图 2：In-app browser 可以直接在页面里评论
如果你做的是网页、运营页、后台界面或者内容排版，这个功能的价值会非常直观。你不再只是“描述问题”，而是在具体位置上给反馈。
2. Computer use
这是这次官方文档里我觉得很值得单独拎出来说的功能。按照 OpenAI 的介绍，Computer use 可以让 Codex 通过“看、点、输”的方式操作图形界面应用。需要注意的是，官方当前在功能页里主要用 macOS app 来演示这项能力，所以你应该把它理解成 Codex app 的重点方向，而不是默认假设所有平台的体验已经完全一致。
它适合的场景包括：
测试桌面应用； 检查浏览器或模拟器流程； 修改图形界面里的设置； 复现那些只能在 GUI 里出现的 bug。
但这里也要把边界讲清楚。官方文档也提醒了，因为这个功能可能会影响项目目录之外的应用和系统状态，所以任务必须尽量窄，而且权限提示一定要认真看。
图 3：Computer use 需要显式授权
这张图其实也说明了 Codex 的一个重要原则：它不是默默替你乱点，而是在关键动作前把控制权交还给你。
3. 项目预览和任务侧栏
很多人以为 Codex 只擅长代码，但官方功能页专门提到了一件事：当任务产出的是 PDF、表格、文档或演示文件时，侧栏可以直接预览这些非代码结果。
这件事对普通用户很关键。因为一旦你不是纯写代码，能不能直接看项目，比“它是不是会写代码”更重要。
图 4：生成的演示文稿可以在侧栏直接预览
如果你让 Codex 帮你整理报告、做表格、做分享材料，这类预览能力会明显降低来回切换的成本。
Windows 下怎么安装 codex-cli
如果你已经开始觉得客户端不够了，想让 Codex 直接在项目目录里工作、走终端命令、吃配置文件，那下一步就是 codex-cli。
根据 OpenAI 官方 GitHub 仓库里的最新 README，安装方式非常直接：
npm install -g @openai/codex
如果你是 macOS 用户，也可以走 Homebrew：
brew install --cask codex
安装前你需要准备什么
最基础的就两样：
一套正常可用的 Node.js / npm 环境 能打开浏览器完成登录授权
如果你输入 npm -v 没反应，先别急着装 Codex，先把 Node.js 安装好。对绝大多数普通用户来说，Codex 安装失败，第一原因不是 Codex 本身，而是本机根本没有可用的 Node/npm。
安装完成后怎么启动
安装成功后，直接在终端输入：
codex
第一次启动时，它会引导你登录。OpenAI 官方文档明确写了两种登录方式：
用 ChatGPT 账号登录 用 API Key 登录
我的建议也很直接：
个人体验、日常使用，优先 ChatGPT 登录 脚本化、批量任务、代理配置、中转接入，优先 API Key
这是因为 ChatGPT 登录更像现成账号直接开用，而 API Key 更适合你自己管理额度和接入方式。
第一次装好 codex-cli 后，先这样用就够了
很多新手一装好 CLI，就开始找高级参数、自动化、子代理和一堆 slash commands。其实完全没必要。你第一阶段只要把下面这个基本流程走通，就已经够了：
1. 进入你的项目目录
cd D:\your-project
2. 启动 Codex
codex
3. 直接交一个小任务
比如你可以从这种任务开始：
帮我先阅读这个项目，告诉我目录结构、启动方式和最核心的 3 个模块分别是什么。
或者：
先不要改代码，先帮我找出这个页面的入口文件和相关样式文件。
这类任务有两个好处：
容易验证结果对不对； 可以让你先理解 Codex 的工作方式，而不是一上来就把复杂任务交给它。
4. 复杂任务先让它计划
这是我非常建议新手养成的习惯。不要一上来就说“帮我重构这个项目”，更好的写法是：
先别动代码，先帮我列一个计划：这个任务应该拆成哪几步，每一步风险是什么，最后怎么验证。
这样做的好处不是形式正确，而是你能更早发现它有没有理解错你的意图。
真正把 Codex 用顺手的几个最佳实践
这部分我建议你认真看，因为这决定了你会不会很快得出“Codex 很强”或者“Codex 不行”的结论。
OpenAI 官方 best practices 讲了很多内容，但如果让我保留最重要的实践参考，我会保留下面 5 条。
1. 提示不要只写一句话，至少讲清 4 件事
官方建议一个好 prompt 默认带上这 4 个部分：
Goal：你到底想改什么、做什么Context：相关文件、目录、文档、报错、页面在哪Constraints：必须遵守什么规则、风格、架构或限制Done when：什么状态才算完成
这其实就是在帮 Codex 降低误解概率。
举个更像人话的写法：
目标：把首页顶部的 CTA 改得更清晰。
上下文：相关文件在 src/pages/home.tsx 和 src/styles/home.css。
限制：不要改接口，不要动移动端布局。
完成标准：桌面端首屏文案更聚焦，按钮样式更醒目，npm run build 能通过。
你会发现，一旦这 4 件事讲清楚，Codex 跑偏的概率会明显下降。
2. 复杂任务先 plan，再执行
OpenAI 在官方 best practices 里也明确强调了这一点。任务一复杂、一模糊，先 plan，通常比直接让它动手靠谱得多。
对普通人来说，这个动作非常值，因为你不是为了“流程感”，而是为了先确认它有没有把事情理解对。
3. 把重复说明写进 AGENTS.md
这是很多人一开始会忽略，但越用越离不开的东西。
官方的说法很准确：AGENTS.md 可以理解成写给 agent 的 README。你们团队怎么写代码、怎么启动项目、怎么跑测试、什么算完成，都可以写进去。
这样你就不用每次都重复说：
我们这个仓库怎么启动 我们不用什么风格 改完必须跑哪些检查 什么行为不能做
而且官方还提到一个很好用的小技巧：如果 Codex 同样的错误犯了两次，就让它做一次复盘，然后更新 AGENTS.md。
这套思路比不断重复提醒更有效。
4. 不要只让它改代码，要让它顺手做验证和 review
这是 OpenAI 文档里我最认同的一点。
很多人用 Codex，停留在“让它生成代码”这一步；但官方建议得更完整：让它在必要时补测试、跑检查、确认结果、review diff。
这会直接改变你使用它的方式。更好的说法不是：
帮我改一下这个 bug
而是：
帮我修这个 bug。改完后跑相关检查，确认问题不再复现，再帮我 review 一遍有没有明显风险。
这不是更麻烦，而是更省事。因为你省掉的是后面反复返工。
5. 配置要尽早做，不要一直靠临时提示词硬撑
官方 best practices 专门提到，很多“质量问题”其实不是模型本身的问题，而是配置没对上，比如：
工作目录不对 默认模型不对 权限不对 工具没接上 规则没沉淀
这也是为什么我建议你在用顺一点之后，尽早去看 ~/.codex/config.toml 和项目里的 AGENTS.md。
很多人觉得配置文件是进阶玩法，其实不是。它更像是让 Codex 从“偶尔好用”变成“持续稳定”的关键一步。
如果你想自定义配置 Codex
你需要先知道一件事：Codex 不是一个随便填个中转地址就一定能跑起来的通用聊天壳。
它对接的是 OpenAI 自己的 Codex 工作流，所以中转服务至少要满足两个条件：
能提供稳定的 OpenAI 兼容接口； 最好支持 Codex 需要的 Responses路径，而不是只支持老式聊天接口。
Codex CLI 的配置思路
Codex CLI 会读取你的配置文件：一般在 ~/.codex/（Windows 也是用户目录下的 .codex）。创建两份文件：
auth.json：放密钥 config.toml：放模型与网关配置
Windows 配置路径与文件
进入用户目录的 .codex（示例：C:\Users\testuser.codex）。如果看不到，先在资源管理器开启“显示隐藏项目”。
没有就手动创建 .codex 文件夹，并创建：
auth.json config.toml
auth.json（把 sk-xxx 换成你的中转API Key）
{"OPENAI_API_KEY": "sk-xxx进行替换"}
config.toml
model_provider = "unityai"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"[model_providers.unityai]
name = "unityai"
base_url = "https://unity2.ai"
wire_api = "responses"
macOS / Linux 配置命令 创建文件：
mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml
这里我们使用的 Unity2.Ai 中转。它支持标准 OpenAI 和 Anthropic 格式，接插件、IDE 和各类现成工具会比较省事，适合想尽快跑起来的人。注册地址：https://unity2.ai/register?ref=TvkMJGTU。
注册后新增 codex 分组的 apikey 即可。
最后一句话
如果你今天只是想把 Codex 用起来，我的建议还是很简单：
直接装 Codex app，理解它的工作方式进阶装 codex-cli，把它接进你的项目目录真正开始频繁使用后，再去做 config.toml、AGENTS.md和 Unity2.ai 这类配置
很多人把顺序搞反了，一上来就先折腾接口、参数和中转，最后反而没有真正体验到 Codex 最有价值的部分。
先用起来，再配顺它，效果会好很多。