OpenAI Codex CLI：完整开发者指南（2026）

Codex CLI 使用 `~/.codex/config.toml`。运行 `codex --help` 查看当前版本支持的选项。可用模型取决于账户和环境，不要直接复制旧示例中的过时模型名称。

by AnyCap

OpenAI Codex CLI 是运行在终端中的智能编程助手——它能规划功能、跨整个代码库编写代码、执行 Shell 命令，并将成果交付给你。

Codex 是 OpenAI 的编码智能体，可通过终端、IDE、桌面和云端工作流使用。本地与 worktree 任务在你的电脑上运行，云端任务在远程环境运行。参见 OpenAI 环境文档。

以下是你在 2026 年需要了解的关于 Codex CLI 的一切——安装、配置、扩展与集成。

什么是 OpenAI Codex CLI？

Codex CLI 是 OpenAI 于 2025 年 4 月推出的智能编程工具，并持续更新至 2026 年。它与早期「Codex」产品（API 模型）有一个核心区别：它会执行操作，而不仅仅是给出建议。

Codex CLI 能做什么：

  • 将整个代码仓库作为上下文（而不仅仅是当前打开的文件）
  • 在编写任何代码之前，先规划多步骤实现方案
  • 执行 Shell 命令（npm test、git commit、make build）
  • 跨目录编写、编辑和重构文件
  • 循环运行，直到测试通过或出现阻塞性问题

Codex 的能力取决于所选环境与已启用工具。OpenAI 已提供图片生成和网络搜索文档；AnyCap 可以补充模型选择与 CLI 工作流。

codex --search "Find the official migration guide for this project"

使用 Codex CLI 在终端智能编程环境中工作的开发者

如何安装 Codex CLI

按照官方指南安装，然后运行 codex login 并完成支持的登录流程。API key 是另一种认证方式，并非使用 Codex 的唯一方式。

npm i -g @openai/codex

codex login
codex --help

验证安装：

codex --version

MacBook 终端中 Codex CLI 正在执行多步骤智能任务

如何配置 Codex CLI

Codex CLI 使用 ~/.codex/config.toml。运行 codex --help 查看当前版本支持的选项。可用模型取决于账户和环境，不要直接复制旧示例中的过时模型名称。

沙盒权限与审批策略是不同的控制项。修改前先检查当前设置。配置和平台支持请参见 Codex 官方文档。

Codex CLI 核心功能

以下是 Codex 开箱即用的能力——无需任何扩展：

1. 智能代码实现

codex "Add a rate limiter middleware to the Express API — 100 req/min per IP, return 429 with Retry-After header"

Codex 读取项目结构，定位正确的文件，编写中间件，将其接入 app.js，并添加测试。

2. 全仓库重构

codex "Migrate all fetch() calls in /src to use the axios wrapper in lib/http.js"

Codex 在整个代码库中找到所有实例，统一改写，并运行测试套件。

3. 测试生成

codex "Generate Jest tests for every exported function in /src/utils — aim for 80% branch coverage"

4. Shell 命令链式执行

Codex 可以自然地链式执行命令：

npm run build

它了解每条命令的输出并据此调整策略。如果 npm run build 失败，它会诊断错误，而不是继续执行。

5. 文档生成

codex "Write a README for this project — setup instructions, API reference, and examples"

扩展 Codex CLI：能力层

Codex 的能力取决于所选环境与已启用工具。OpenAI 已提供图片生成和网络搜索文档；AnyCap 可以补充模型选择与 CLI 工作流。

MCP 服务器

Skill 包含操作说明，也可以引用脚本或资源。MCP server 提供工具，一个 server 可以提供多种能力。Skill 需要 CLI 时，应单独安装并认证该 CLI，并检查当前任务实际可用的工具。

原生工具与外部集成都可以支持完整工作流。需要特定模型、明确的 CLI 控制或交付操作时，再选择适合的 AnyCap 能力。

npm i -g anycap
anycap login
anycap --version
anycap status

AnyCap setup · MCP

Codex + AnyCap 能做什么

生成产品演示视频

anycap video generate \
  --prompt "a smooth walkthrough of a SaaS dashboard, clean UI, soft lighting" \
  --model veo-3.1 \
  -o demo.mp4

Codex 实现功能，AnyCap 生成演示视频。同一个终端会话内完成。

→ 完整指南：如何用 Codex 生成视频

为构建生成图片

anycap image generate \
  --prompt "product hero shot, dark UI, floating interface, product photography" \
  --model gpt-image-2 \
  -o hero.png

→ 完整指南：如何用 Codex 生成图片

搜索网络获取最新信息

anycap search --prompt "best practices for API rate limiting 2026"

Codex 获得带引用的结构化搜索结果，为代码生成提供真实可靠的依据。

→ 完整指南：Codex 网络搜索指南 2026

存储和共享生成的文件

anycap drive upload demo.mp4

返回可共享链接。Codex 可将其嵌入它生成的文档中。

Codex CLI vs. Claude Code vs. Cursor

Codex 的能力取决于所选环境与已启用工具。OpenAI 已提供图片生成和网络搜索文档；AnyCap 可以补充模型选择与 CLI 工作流。

Cursor Agent 已提供网络搜索、浏览器工具、图片输入和原生图片生成。请检查官方工具文档及当前环境实际可用的工具。AnyCap 是按模型选择和可重复 CLI 工作流需求添加的可选接口。

Claude Code 提供终端等开发工作流，具备文件编辑、命令执行和研究工具。可用界面与能力请查看官方概述。不能把所有 Claude Code 工作流描述为仅处理文本或不能研究网页。

Codex CLI + OpenAI 生态：完整技术栈

如果你正在使用 OpenAI 进行端到端开发：

# 1. Research (web-grounded)
anycap search --prompt "competitor features for project management SaaS 2026"

# 2. Plan + implement (Codex)
codex "Add the top 3 missing features identified in the research to our roadmap page"

# 3. Generate visuals (GPT Image 2, via AnyCap)
anycap image generate --prompt "roadmap hero, timeline graphic, product UI" --model gpt-image-2 -o roadmap-hero.png

# 4. Generate demo video (Sora 2 Pro, via AnyCap)
anycap video generate --prompt "product roadmap walkthrough" --model sora-2-pro --mode image-to-video --param images=./roadmap-hero.png -o demo.mp4

# 5. Store and share
anycap drive upload demo.mp4

原生工具与外部集成都可以支持完整工作流。需要特定模型、明确的 CLI 控制或交付操作时，再选择适合的 AnyCap 能力。

常见问题

Codex CLI 免费吗？

套餐与计费请查阅最新的 OpenAI 价格文档。费用取决于套餐、模型和用量；本文不承诺固定的单次会话成本或试用额度。

Codex CLI 和 Codex API 有什么区别？

Codex API（2021–2023 年可用）是代码补全模型——你发送提示，得到补全结果。Codex CLI（2025 年起）是一个智能系统：它读取你的代码库、规划实现方案、执行 Shell 命令，并端到端交付代码。两者是完全不同的范式。

Codex CLI 支持 Windows 吗？

沙盒权限与审批策略是不同的控制项。修改前先检查当前设置。配置和平台支持请参见 Codex 官方文档。

Codex: sandbox / approval policy

沙盒权限与审批策略是不同的控制项。修改前先检查当前设置。配置和平台支持请参见 Codex 官方文档。

Codex CLI 可以与 Claude Code 并行使用吗？

可以。它们是拥有各自配置的独立工具。一些团队用 Codex 处理主要实现循环（OpenAI 模型），用 Claude Code 处理较长的推理任务或并行子代理工作流。AnyCap 对两者的支持完全一致。

如何为 Codex CLI 添加视频生成能力？

安装 AnyCap（npm i -g anycap && anycap login），然后运行 anycap skill install --target ~/.codex/skills/anycap-cli/。之后，Codex 就能识别 anycap video generate 为可用命令。完整指南：Codex 视频生成。

总结

根据工作方式、可用工具、权限和项目实测结果选择编码环境。本文不提供未经验证的星级评分，也不认定某个工具在所有任务中最好。

原生工具与外部集成都可以支持完整工作流。需要特定模型、明确的 CLI 控制或交付操作时，再选择适合的 AnyCap 能力。

→ 为 Codex 添加完整能力——免费安装 AnyCap

📖 推荐延伸阅读

相关文章

原生工具与外部集成都可以支持完整工作流。需要特定模型、明确的 CLI 控制或交付操作时，再选择适合的 AnyCap 能力。 由 AnyCap 团队撰写。我们构建 Capability Runtime，通过一个 CLI 为 Codex、Claude Code 和 Cursor 提供视频、图片、搜索和存储能力。

使用 anycap drive upload <file> 上传一个现有文件，然后检查返回的节点 ID。分享是独立操作：运行 anycap drive share <node-id> 并检查返回的链接与有效期。已核对的 CLI 不提供 drive download，上传命令也没有 --name 或 --format url。参见 Drive 与 Page 文档。

使用 anycap page deploy <path> 从 HTML 文件或静态目录创建版本，并检查部署结果。准备好后，anycap page publish <page-id> 发布已验证的版本；明确需要发布时，也可使用 page deploy ... --publish 合并两个操作。请使用实际返回的站点 ID 与 URL。参见发布指南。