Codex CLI 工作原理及 App、Web 区别
了解 Codex CLI 如何在本地终端中工作，以及它与 Codex App、Codex Web 的核心区别。
Codex CLI 是 OpenAI 的本地命令行 coding agent。它在终端中运行，使用当前工作区，读取和修改文件，执行命令，并遵循你的沙箱和审批设置。它与 Codex App 的主要区别是以终端为核心界面；与 Codex Web 的区别是任务运行在本地环境，而不是浏览器或远程运行环境。
简短答案
它适合希望在本地仓库中用命令行方式处理代码修改、代码审查、测试修复、脚本编写和多步骤开发任务的用户。
Codex CLI 和普通 ChatGPT 对话不同。它不仅生成建议，还会围绕当前目录、项目说明、工具结果和本地执行权限来推进任务。
CLI、App 与 Web 对比
| 形态 | 运行位置 | 适合场景 |
|---|---|---|
| Codex CLI | 本地终端和工作区 | 需要命令、文件操作和 config.toml 配置 |
| Codex App | 桌面应用 | 需要图形化会话、插件或 Remote Control |
| Codex Web | 浏览器或远程环境 | 任务需要在云端或远程环境运行 |
需要更详细的判断方式，请阅读 Codex CLI、Codex App 和 Codex Web 的区别。
什么时候需要理解它
- 你正在第一次安装
@openai/codex - 你不确定 Codex CLI、Codex App、Codex Web 的差别
- 你想在本地项目中使用 agent 修改文件
- 你需要配置自定义 API provider、Base URL 或模型
- 你想理解 sandbox、approval 和
AGENTS.md的作用
核心概念
| 概念 | 说明 |
|---|---|
| Codex CLI | 本地终端中的 Codex coding agent |
| 工作区 | Codex 当前能读取、搜索和修改的目录 |
config.toml | Codex CLI 的本地配置文件，用于设置模型、provider、sandbox 等 |
AGENTS.md | 项目级说明文件，用来告诉 Codex 项目规则和协作约定 |
| Sandbox | 限制文件系统和网络访问的本地安全边界 |
| Approval | 决定哪些命令或操作需要用户确认 |
推荐工作流
- 在要修改的项目目录中启动 Codex CLI。
- 让它先阅读相关文件或说明，而不是直接要求它大范围改动。
- 对复杂任务先要求计划，再允许它修改文件。
- 根据任务风险选择合适的 sandbox 和 approval 模式。
- 把长期项目约定写入
AGENTS.md，把一次性需求留在当前对话里。
如果你需要使用第三方 API provider，重点是 config.toml 中的 model_provider、base_url、wire_api 和模型字段。Codex / 外部工具通常使用 OpenAI-compatible endpoint；在本仓库中对应 https://bettertoken.ai/v1。
常见误区
- 把 Codex CLI 当成只会回答问题的聊天工具。
- 以为 Codex CLI、Codex App、Codex Web 是完全相同的运行环境。
- 只改
model，不配置对应 provider 和 Base URL。 - 放开 sandbox 和 approval，却没有测试、代码审查或命令边界。
- 把 OpenAI-compatible Base URL 和 Anthropic-compatible Base URL 混用。
关于 BetterToken
如果你使用自定义 OpenAI-compatible provider，BetterToken 可以作为 Codex CLI 的模型 API 层。它负责 API Key、Base URL、模型路由、余额和用量记录。
BetterToken 不替代 Codex CLI 的本地 sandbox、approval、AGENTS.md 或命令执行策略。
如果你需要了解通用 Codex API 接入和产品使用场景，请查看 BetterToken Codex API 页面。这篇 FAQ 只解释 Codex CLI 及其本地工作方式。
Related docs
- Codex 接入 BetterToken 指南
- Codex CLI、Codex App 和 Codex Web 有什么区别？
- 如何配置 Codex CLI 的 config.toml？
- OpenAI-compatible API 和 Anthropic-compatible API 有什么区别？