命令行工具

Codex CLI 安装教程:Windows、macOS、Linux

使用当前跨平台安装器完成 Codex CLI 安装,然后验证版本、检查运行环境并开始第一个项目。Windows 已支持原生安装,需要 Linux 工具链时再选择 WSL2。

维护:词元AI中转站更新:2026-10-06适用:当前稳定版 Codex CLI
Windows原生安装已支持
macOS / Linux独立安装器或 npm
诊断命令codex doctor --summary

安装按官方 CLI,模型走词元:Windows / macOS / Linux 装好后,把 provider 指到 https://www.gpt345.com/v1。不要在安装页展开成 Codex 百科。

1. 安装前准备

  • Node.js 18 或更新版本(node -v 确认),CLI 依赖 npm 分发。
  • 一个词元账户,先建一把试验 Key 并设小额上限,不要拿长期无限额 Key 练手。
  • 能访问 www.gpt345.com 的网络;国内网络建议直连,不要套代理。

2. Windows 安装

PowerShell 里用 npm 全局安装:

PowerShell
npm install -g @openai/codex
codex --version

装完 codex --version 有输出即二进制就绪。装不上优先查 Node 版本和 npm 源,不要先怀疑中转。

3. macOS / Linux 安装

同样走 npm;macOS 也可用 Homebrew 安装发行版。安装后确认 codex 在 PATH 里。Linux 服务器上注意以当前用户身份安装,不要混用 sudo 的 npm 目录。

4. 验证与诊断

  1. 发一条短请求,确认控制台有对应记录。
  2. 报错先看退出码和最后一条 HTTP 状态,而不是重装。
  3. 401/403/429 直接对照通用错误码表处理。

5. 登录并运行

词元走 API Key 方式,不需要 ChatGPT 账号登录态。官方登录和中转 Key 是两套凭证,混用是最常见的启动失败原因。把 Key 放进环境变量,交给下一步的 provider 配置引用。

6. 配置本站接口

编辑 ~/.codex/config.toml,把自定义 provider 指向词元(完整字段与写法见Codex 配置指南):Base URL 用 https://www.gpt345.com/v1,模型 ID 从模型广场原样复制。

装好 CLI 后若想让 AI 自动审查每次提交的 diff,可直接调用 Codex Auto Review 模型,按审查量计费,倍率以控制台为准。

7. 更新 Codex

升级用同一条 npm 命令重装即可。更新后第一件事是重查 base_url,避免被默认值改回官方入口;再发一条短请求验证,确认控制台有新记录。配置目录在升级时会保留,但重大版本升级后建议先跑短请求再回生产任务。

8. 常见问题

安装成功但 401?

安装只解决二进制。401 是 Key:检查是否完整复制、是否属于当前分组,看词元控制台而不是重装。

同一账户还能生图吗?

可以。同一账户可继续打 Grok/Gemini 0.01 元图;CLI 会话不要混视频任务,支付仍是微信支付宝。

还卡住?

客服 QQ 49098022 或 Telegram 群组,带上时间点、模型 ID 和状态码。