Skip to main content
Codex CLI 是 OpenAI 的本地命令行 coding agent。它在终端中运行，使用当前工作区，读取和修改文件，执行命令，并遵循你的沙箱和审批设置。它与 Codex App 的主要区别是以终端为核心界面；与 Codex Web 的区别是任务运行在本地环境，而不是浏览器或远程运行环境。

​
简短答案

它适合希望在本地仓库中用命令行方式处理代码修改、代码审查、测试修复、脚本编写和多步骤开发任务的用户。 Codex CLI 和普通 ChatGPT 对话不同。它不仅生成建议，还会围绕当前目录、项目说明、工具结果和本地执行权限来推进任务。

​
CLI、App 与 Web 对比

需要更详细的判断方式，请阅读 Codex CLI、Codex App 和 Codex Web 的区别。

​
什么时候需要理解它

  • 你正在第一次安装 @openai/codex
  • 你不确定 Codex CLI、Codex App、Codex Web 的差别
  • 你想在本地项目中使用 agent 修改文件
  • 你需要配置自定义 API provider、Base URL 或模型
  • 你想理解 sandbox、approval 和 AGENTS.md 的作用

​
核心概念

​
推荐工作流

  1. 在要修改的项目目录中启动 Codex CLI。
  2. 让它先阅读相关文件或说明，而不是直接要求它大范围改动。
  3. 对复杂任务先要求计划，再允许它修改文件。
  4. 根据任务风险选择合适的 sandbox 和 approval 模式。
  5. 把长期项目约定写入 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 及其本地工作方式。

​
References