Codex CLI

终端推荐

Codex CLI 适合已经熟悉命令行的用户。它可以直接在当前项目目录中启动，也方便配合终端、脚本和现有开发流程使用。

开始前准备

开始前请确认已经：

• 完成充值
• 创建 ApiKey，并为密钥选择可用分组

1. 检查 Node.js

打开终端并运行：

node -v

如果能看到版本号，说明 Node.js 已经安装。没有版本号时，先从 Node.js 官网 下载并安装当前 LTS 版本，然后重新打开终端。

2. 安装 Codex CLI

在终端中运行：

npm i -g @openai/codex@latest

安装完成后检查版本：

codex --version

如果终端提示找不到 codex，请先关闭当前终端窗口，再打开一个新终端重试。

3. 导入 Codex 配置

Codex CLI 与桌面版共用配置，推荐使用 CC-Switch 导入：

1. 下载并安装 CC-Switch。
2. 安装完成后打开一次 CC-Switch。
3. 回到后台的 API 密钥 页面，点击目标密钥旁的 导入到 CCS。
4. 确认应用类型为 Codex，完成导入并启用该配置。

无法使用 CC-Switch 时，可以参考 Codex 手动配置。

4. 在项目中启动 Codex

先在终端进入你的项目目录，再运行：

codex

进入会话后可以发送一条简单指令：

请先阅读当前项目的目录结构，并告诉我它使用了哪些主要技术。

能够正常收到回复，就说明 Codex CLI 已经配置完成。

配置修改后如何生效

修改或重新导入配置后，先按 Ctrl + C 退出当前 Codex 会话，再重新运行 codex。已经启动的会话不会自动重新加载配置文件。

常见问题

npm 提示权限不足

Windows 可以尝试以管理员身份打开终端；macOS 或 Linux 建议使用 Node.js 版本管理工具安装 Node.js，避免全局 npm 目录权限问题。

启动后提示认证、模型或余额错误

回到后台确认 ApiKey 没有被禁用、已经选择可用分组，并且账户余额或套餐仍然可用。配置内容应以后台当前生成的内容为准。

其他使用方式

希望用图形界面管理项目和任务时，可以继续安装 Codex 桌面版。两种方式可以同时使用。