快速上手

从安装到第一条任务。

只保留真正需要操作的步骤。先安装官方 Codex,再从本站控制台获取配置,最后用一个小任务验证整条链路。

预计 10-15 分钟 · 密钥不截图、不发群、不写进代码
配置路径

三步完成基础配置

10-15 分钟
01

安装官方 Codex

按系统执行官方命令,确认终端能识别 Codex。

02

复制本站配置

登录控制台创建密钥,并按客户端说明填写。

03

运行小任务验证

先只读分析一个项目,再核对控制台用量记录。

配置流程

先验证一步,再进入下一步

不要一开始复制大量配置。逐步确认安装、登录和请求记录,出现问题时才能快速定位。

01

安装并确认版本

执行官方安装命令,然后重新打开终端,运行 codex --version

选择安装方式 →
02

进入控制台配置

创建密钥并复制客户端配置。不要在群聊或代码仓库中暴露真实密钥。

进入控制台 ↗
03

检查请求与消耗

运行一个只读任务,再到用量查询中核对时间、模型和消耗记录。

查看用量 ↗

官方安装命令

选择系统,一键复制

命令来自 openai/codex 官方仓库 ↗

Windows PowerShell

打开 PowerShell 执行官方安装脚本,完成后重新打开终端。

POWERSHELL / OFFICIAL
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
执行前确认域名是 chatgpt.com;安装后运行 codex --version

macOS / Linux

在终端执行官方 Shell 安装器;macOS 用户也可以使用 Homebrew。

SHELL / OFFICIAL
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Homebrew 安装命令:brew install --cask codex

使用 npm 安装

适合电脑上已经安装 Node.js 与 npm 的用户。

NPM / GLOBAL PACKAGE
npm install -g @openai/codex
若提示找不到命令,请重新打开终端并检查 npm 全局路径。

第一次运行

用小任务验证整条链路

第一次不要让 Codex 直接重构整个项目。先确认目录、权限、上下文和用量记录都正常。

01

在项目根目录启动

先进入需要处理的项目目录,再运行 Codex。

cd 你的项目目录
codex
02

先问项目是什么

要求只读说明技术栈、入口文件和运行方式,不修改文件。

请只读分析当前项目,告诉我技术栈、入口文件和本地运行命令。
03

再做一个小修改

选择可快速验证的小任务,并要求完成后运行检查。

修改首页一处文案,完成后运行最小验证,不改动其他模块。
04

回控制台核对

检查请求、模型、消耗和余额是否符合预期。

控制台 → 用量查询 → 核对时间、模型与消耗

常见问题

先排除最常见的配置问题

反馈问题时请提供时间、系统、版本和脱敏后的错误文本,不要发送完整密钥。

先重新打开终端,再运行 codex --version。使用 npm 安装时还要确认 npm 全局目录已经加入 PATH。
登录本站控制台后创建密钥,并按控制台中的客户端说明操作。公开页面不会展示真实密钥。
模型、上下文长度、文件数量和任务复杂度都会影响消耗,套餐展示的是额度边界,不代表每条任务消耗固定。

下一步

装好工具,再用一套方法把它用稳。

进入 Codex 宝库查看项目工作流、优质仓库和可以直接复用的实践方法。