Codex CLI下载
终端里的 AI 编码智能体，一条命令装好
Codex CLI 是 OpenAI Codex 的命令行形态：在终端里用自然语言下达任务，它会自动读写代码、执行命令、运行测试，交出可验收的结果。本页整理 CLI 安装命令、Windows/Mac/Linux 安装步骤与常见报错解决方法。
npm i -g @openai/codex
Codex CLI 下载地址
推荐优先使用官方渠道；高速下载地址由本站人工维护，转存后即可下载。
Codex CLI 是什么？
Codex CLI 是 OpenAI Codex 的命令行形态（AI coding agent）：跑在终端里，用自然语言下达编码任务，它会自动理解项目结构、修改多个文件、执行终端命令、运行测试，最后给出可以直接验收甚至提交 PR 的结果。
与需要图形界面的桌面工具不同，CLI 更适合终端工作流：本地开发、服务器、容器、CI 环境都能运行，也方便写进脚本和自动化流程。安装方式也最简单——一条 npm 命令即可完成，前置条件只有 Node.js 20 或更高版本。
本页持续维护 Codex CLI 的安装命令与教程：Windows、macOS、Linux 三套安装步骤，npm 国内镜像加速方法，以及「不是内部命令」「找不到平台二进制」等常见报错的排查方法。遇到新版变化可先查看本页更新说明。
功能特点
npm install -g @openai/codex 即装即用，无需图形界面，装完直接在终端调用 codex 命令。
本地开发、服务器、容器与 CI 环境同样可用，方便把编码任务写进脚本与自动化流程。
命令在受限沙箱环境中运行，敏感操作需人工确认，提供只读、自动等多种审批模式。
Apache 2.0 协议开源，支持 AGENTS.md 项目约定文件，可无缝接入现有工程规范与工作流。
Codex CLI 安装教程
🪟Windows 安装步骤
- 安装 Node.js 运行环境
打开 nodejs.org，下载 LTS 版安装包（需 20 或更高版本），双击安装、一路下一步即可。
- 执行 CLI 安装命令
按 Win 键打开 PowerShell，执行 npm install -g @openai/codex（可直接复制本页顶部的安装命令），看到 added 1 package 即为成功。
- 验证安装
执行 codex --version，能正常输出版本号说明安装完成。若提示「不是内部命令」，先关闭并重新打开 PowerShell 让 PATH 生效。
- 登录账号
进入你的项目目录，运行 codex。首次启动会引导使用 ChatGPT 账号登录（需 Plus / Pro / Team 订阅），也可按提示配置 API Key。
- 开始使用
用自然语言描述任务，例如「修复登录接口的报错并补上单元测试」，Codex CLI 会自动执行并在关键操作前请求确认。
- npm 安装缓慢或失败：可切换国内镜像 npm config set registry https://registry.npmmirror.com 后重试。
- 提示找不到平台二进制：Codex CLI 已改为 Rust 原生二进制分发，可重装 npm 包，或到 GitHub Releases 手动下载对应平台的压缩包。
- 登录时网络超时：登录与调用 OpenAI 服务需要可连通的网络环境，请自行确认网络配置。
🍎Mac 安装步骤
- 安装 Node.js 运行环境
推荐用 Homebrew 执行 brew install node，或到 nodejs.org 下载 macOS 安装包（需 20 或更高版本）。
- 执行 CLI 安装命令
打开终端执行 npm install -g @openai/codex，也可按官方文档使用 Homebrew 等其他方式安装。
- 验证安装
执行 codex --version，能输出版本号即为安装成功。
- 登录并使用
在项目目录运行 codex，按引导完成 ChatGPT 账号登录或 API Key 配置，然后直接下达编码任务。
- Apple Silicon 与 Intel 芯片均有对应二进制，npm 会自动匹配，无需手动选择。
版本与更新
Codex CLI 由 OpenAI 持续迭代，更新较为频繁，最新版本以 npm 源与 GitHub Releases 为准；本页教程随版本变化同步修订，建议收藏本页获取最新安装说明。
- 2026-11-03页面首版上线：整理 CLI 安装命令、Windows/Mac/Linux 三平台安装步骤与常见报错排查。
