返回首页

codex

OpenAI 官方编码代理 · 终端原生 · 多模型路由

Codex CLI 是 OpenAI 推出的终端编码代理，基于 o3 / GPT-4o / codex-1 系列模型。把自然语言变成可执行命令、补丁、测试和文档。

完全本地运行，仓库不离开你的机器
支持云端与本地模型路由（gpt-4o、o3、o4-mini、codex-1）
原生 git、shell、文件工具，无需额外胶水
快速安装部署
30 分钟内把 Codex CLI 装到 macOS / Linux / WSL，并在 IDE 中启用。

Codex CLI 提供 npm、brew、官方安装脚本三条路径，macOS 用户推荐 Homebrew，Linux 走 npm 最省心。

前置依赖

  • Node.js ≥ 18.17（建议 20 LTS）
  • OpenAI Platform API Key（推荐绑定组织项目，便于限额）
  • Git 2.30+（用于差异/提交集成）

方式一：npm 全局安装（推荐）

bash
npm i -g @openai/codex
export OPENAI_API_KEY="sk-..."
codex --version

方式二：macOS Homebrew

bash
brew install --cask openai-codex  # macOS 桌面端
brew install openai/tap/codex        # CLI

方式三：官方一键脚本（Linux / WSL）

bash
curl -fsSL https://pkg.openai.com/codex/install.sh | sh

首次登录与项目授权

  1. cd 进入你的项目根目录
  2. codex login，按提示选择 ChatGPT 账号或 API Key
  3. 首次运行会生成 ~/.codex/config.toml，可在此设置默认模型、审批模式（suggest / auto-edit / full-auto）
  4. codex "列出所有 TODO" 验证链路

VS Code / JetBrains 集成

  • VS Code：搜索插件 OpenAI Codex，安装后命令面板执行 Codex: Open Panel
  • JetBrains IDE：在 Settings → Plugins 安装 OpenAI Codex，启动时关联 CLI
  • Codex 会自动读取 IDE 当前文件，无需手动同步上下文
零摩擦配方
在 ~/.codex/config.toml 设置 default_model = "gpt-4.1" 和 approval_mode = "auto-edit"，日常开发几乎不用再确认。
官方资源
点击跳转到原始来源
常见问题
新手问得最多的几个
Codex CLI 收费吗？
CLI 本身免费，调用 OpenAI 模型按 token 计费，绑定 ChatGPT Pro 订阅有优惠额度。
能否完全离线？
可以，配合 Ollama、LM Studio 等本地推理服务，并在 config.toml 配置自定义 provider。
与 Cursor、Copilot 的区别？
Cursor / Copilot 偏向 IDE 内辅助；Codex CLI 是终端原生、可脚本化、可自托管的代理。

查看这个板块的提示词

配套提示词已按板块分组，复制即用。

浏览提示词