Codex 安装与使用教程：新手也能快速上手

第一次使用 Codex，不需要先研究复杂的命令行参数。对大多数新手来说，最顺畅的路线是：先安装桌面版，选择一个练习项目，让 Codex 完成一个范围明确的小任务。

桌面版有可视化任务列表、文件改动和权限确认，不要求你先配置 Node.js、npm 或终端环境。等你熟悉调查、修改、验证和审查这套流程后，再按需使用 CLI 或 IDE 扩展。

TIP

桌面版的下载安装、API Key 登录、Base URL、CC Switch 和中文界面设置，请直接阅读：Codex 桌面版安装配置全流程（图文教程）。

本文重点讲安装之后怎么开始使用，不重复图文安装步骤。

一、先选对 Codex 入口

Codex 有桌面版、CLI、IDE 扩展和云端等入口。它们解决的是不同使用习惯，不需要一次全部安装。

入口	推荐人群	新手建议
桌面版	希望用图形界面管理任务、查看改动的用户	优先选择
CLI	熟悉终端，需要脚本化或自动化的开发者	熟悉桌面版后再装
IDE 扩展	长时间在编辑器中工作的开发者	按编辑器需求安装
云端任务	希望把耗时任务交给托管环境执行的用户	先理解仓库和权限再用

macOS 和 Windows 用户建议从桌面版开始。Linux 用户如果没有可用的桌面客户端，可以使用 Codex CLI 或支持的 IDE 扩展；跨平台安装细节见 macOS / Windows / Linux 完整安装教程。

二、安装桌面版（推荐）

完整安装步骤已经整理成单独教程，你只需按顺序完成：

1. 下载与你的操作系统对应的桌面应用；
2. 安装并启动应用；
3. 使用支持的账号或 API Key 完成登录；
4. 根据需要设置接口和模型；
5. 把界面语言切换为中文。

立即查看：Codex 桌面版安装配置全流程（保姆级教程）

安装完成后先不要急着打开重要的生产仓库。准备一个可以随时恢复的小项目，或先创建 Git 分支，能让第一次练习更安心。

三、开始前准备一个项目

Codex 需要一个明确的工作目录。这个目录最好满足以下条件：

• 已使用 Git 管理，可以通过 git diff 查看改动；
• README 中写明启动、测试和构建命令；
• 依赖已经安装，项目原本能够正常运行；
• 不包含未妥善管理的密码、私钥和生产环境凭据。

如果是现有项目，先在终端记录基线：

git status --short

如果这里已经显示修改过的文件，要记住它们是你原来的改动。Codex 不应该擅自覆盖或删除这些内容。

IMPORTANT

第一次练习不要选择生产服务器目录，也不要把真实 API Key、.env 内容或客户数据粘贴到任务中。

四、发送第一条任务

打开桌面版，创建新任务并选择项目文件夹。第一条任务建议只让 Codex 调查，不修改文件：

请先阅读 README、项目清单文件和测试目录，不要修改任何文件。

告诉我：
1. 这个项目使用什么技术栈；
2. 如何启动、测试和构建；
3. 主要入口文件在哪里；
4. 当前工作区是否有未提交改动；
5. 适合新手完成的最小任务是什么。

回答时引用实际文件；不确定的地方请明确说明。

这条任务能帮助你确认 Codex 是否选对目录、是否理解项目，也能避免一上来就产生大量改动。

五、让 Codex 完成一个小改动

熟悉项目后，选择一个能清楚验收的任务，例如修改一段文案、修复一个小样式问题或补充一条测试。提示词可以使用下面的结构：

请把首页按钮文案从“开始”改为“立即开始”。

要求：
- 只修改与该按钮直接相关的文件；
- 不调整页面布局，不新增依赖；
- 修改前先定位按钮来源；
- 完成后运行相关测试或构建；
- 最后列出修改文件、验证命令和结果。

一个好任务通常包含四部分：

1. 目标：最终想得到什么结果；
2. 范围：允许修改哪些内容；
3. 约束：哪些行为必须保持不变；
4. 验证：用什么命令或现象判断完成。

不要只写“优化一下项目”或“修复所有问题”。范围越模糊，Codex 越容易做出与你预期不同的改动。

六、看懂权限确认

Codex 在工作时可能请求运行命令、访问网络或写入工作区。看到确认框时，先看清楚具体命令和目标：

• 安装项目已有依赖通常是正常操作，但应确认包管理器和工作目录；
• 运行测试、类型检查和构建通常风险较低；
• 删除文件、覆盖配置、访问工作区外目录需要格外谨慎；
• 不理解的命令可以拒绝，并要求 Codex 解释用途或提供更小范围的方案。

权限请求不是故障，它是在告诉你任务即将跨越当前边界。不要为了省一次点击而长期开放不必要的高权限。

七、检查改动，而不是只看“已完成”

Codex 报告完成后，至少检查下面四项：

1. 修改了哪些文件

确认文件数量和任务范围相符。一个文案修改不应该顺带升级依赖或重写大量配置。

2. Diff 是否符合预期

逐项查看新增、删除和移动的代码。重点留意密钥、调试日志、临时文件和无关格式化。

3. 验证是否真的执行

区分“建议运行”和“已经运行”。可靠的交付说明应包含具体命令、退出结果，以及没有运行某项检查的原因。

4. 页面是否正常

前端改动还要在浏览器中检查桌面与窄屏布局、交互状态和控制台错误。测试通过不等于视觉效果一定正确。

八、推荐的新手工作流

每个任务都可以按下面的顺序完成：

选择项目 → 只读调查 → 确认范围 → 小步修改 → 运行验证 → 审查 Diff → 决定是否保留

对应的提示词可以很简单：

先调查原因，不要修改。

给出不超过 5 步的计划，说明每步修改和验证内容。

按计划实现，只处理当前问题，不做无关重构。

运行相关测试和构建，然后从回归、安全和遗漏测试角度审查本次改动。

这种分阶段方式比一次塞入很多需求更容易检查，也更容易在方向不对时及时纠正。

九、常见问题

Codex 能聊天，但看不到项目文件

检查当前任务是否已经选择正确的本地文件夹，以及操作系统是否授予应用文件访问权限。不要通过扩大整块磁盘权限来代替定位问题。

Codex 能读文件，但不能修改

当前任务可能处于只读模式，或目标文件不在已授权工作区。确认任务模式和目录后，只开放完成当前任务所需的写权限。

安装后界面是英文

打开设置中的语言选项，选择中文并按提示重启。具体界面截图见桌面版安装配置教程。

修改很多，但结果不符合预期

先停止继续修改，回到原始目标，要求 Codex 列出当前 diff 与需求不一致的地方。必要时利用 Git 恢复到开始任务前的状态，再把需求拆小。

是否必须安装 Codex CLI？

不必须。桌面版能够满足大多数新手的日常代码任务。只有需要终端操作、自动化、非交互执行或更精细的参数控制时，才需要继续安装 CLI。

十、下一步学什么？

完成第一个小任务后，可以依次学习：

1. 提示词与上下文：把目标、范围和验证写得更清楚；
2. 5 分钟上手 Codex：快速熟悉基础协作流程；
3. AGENTS.md 自定义指令：把项目固定规则交给 Codex；
4. Codex CLI 中文文档：进入终端和自动化工作流；
5. 重构一个 Vite 应用：练习调查、计划、实现与审查。

总结

新手使用 Codex 的关键不是一次安装所有入口，而是先用桌面版跑通一个小任务。选择安全的练习项目，先调查再修改，把目标和验收标准说清楚，并在每次完成后检查 diff 与验证结果。

如果你还没有安装，请从桌面版安装配置全流程开始；如果需要兼顾 macOS、Windows、Linux 或安装 CLI，请继续阅读2026 完整安装教程。

最后校对：2026 年 7 月 22 日