Codex Manual
Codex 是什么
Codex 不是聊天机器人换皮，而是可以进入你的开发环境、阅读项目、修改文件并运行命令的编码代理。
Codex 是 OpenAI 面向软件开发的编码代理。它能理解你的项目文件、执行命令、修改代码、补测试、解释错误，也能在桌面 App、终端、编辑器或云端环境里协助完成开发任务。
你可以把它理解成一个会使用开发工具的助手：你给出目标，它会先查看项目，再给出计划，必要时修改文件并运行验证命令。
它适合做什么
Codex 适合处理这些任务：
- 解释陌生项目的目录结构和启动方式。
- 找出 bug 的可能原因并给出修复方案。
- 修改代码、补充测试、更新文档。
- 做代码审查，指出风险和遗漏。
- 把一个较大的需求拆成多个可验证步骤。
- 在云端或本地并行尝试不同方案。
它不适合做什么
Codex 不应该被当成不受限制的自动执行器。它能运行命令和写文件，所以你需要给它明确范围，并理解权限设置。
不建议一上来就让 Codex 做这些事：
- 在不理解项目的情况下大范围重构。
- 直接操作生产数据库、生产服务器或重要凭据。
- 在没有测试和回滚方案的情况下批量改文件。
- 使用全权限模式处理你不熟悉的仓库。
普通用户应该先记住什么
先记住三个概念就够了：
- 入口：CLI、App、IDE 扩展、Web/Cloud。
- 环境：Codex 在哪个系统和哪个目录里工作。
- 权限：Codex 能读写哪里，执行命令前是否需要确认。
后面的章节会按这三个问题展开。