Codex CLI 安装及配置卸载教程

Codex CLI 安装与配置教程

本教程适用于 Windows、macOS 和 Linux，包含 Codex CLI 的安装、API 配置、启动、升级以及卸载方法。

一、环境要求

安装 Codex CLI 前，请确保电脑满足以下要求：

Windows 10 / Windows 11、macOS 或主流 Linux 系统

Node.js 22+

npm 10+

正常的网络连接

检查 Node.js 和 npm：

如果能够正常显示版本号，即可继续安装。

二、安装 Node.js

Windows

访问：Node.js 官网

下载最新 LTS 长期支持版本并完成安装。

Windows 用户同时建议安装 Git：Git 官网

安装完成后重新打开 CMD 或 PowerShell。

macOS

推荐直接从官网下载：Node.js 官网

也可以使用 Homebrew：

Linux

Ubuntu / Debian：

Fedora：

CentOS / RHEL：

Arch Linux：

如果 Linux 系统软件源提供的 Node.js 版本低于要求，请使用 NodeSource、nvm 等方式安装较新的 Node.js。

安装完成后统一检查：

三、安装 Codex CLI

Windows、macOS 和 Linux 安装命令相同：

安装完成后检查：

能够正常显示 Codex 版本号，即代表安装成功。

macOS / Linux 如果出现 EACCES 或 permission denied，通常是 npm 全局目录权限问题，建议检查 Node.js/npm 的安装方式以及全局目录权限。

四、获取 API Token

访问：DeepRouter 依次进入：控制台 → API密钥 → 创建API密钥

创建 API密钥时设置：

分组建议选择 Codex 分组

令牌名称可以自行填写

额度根据自己的需求设置

其他选项保持默认

创建完成后复制 API Key，例如：

sk-xxxxxxxxxxxxxxxx

请妥善保存 API Key，不要公开分享。如果 API Key 已经泄露，请立即删除旧 Token 并重新生成。

五、创建 Codex 配置文件

Codex 的配置文件保存在当前用户目录下的 .codex 文件夹中，手动编辑目录下的（config.toml 和 auth.json）这两个文件

不同系统的文件路径如下：

系统	`config.toml`	`auth.json`
Windows	`C:\Users\<USERNAME>\.codex\config.toml`	`C:\Users\<USERNAME>\.codex\auth.json`
macOS / Linux	`~/.codex/config.toml`	`~/.codex/auth.json`

找不到的话可自行在 .codex 目录下创建这两个文件，Windows 用户请注意文件扩展名，确保文件不是 auth.json.txt 或 config.toml.txt。

macOS / Linux 可运行以下代码创建：

六、修改 Codex 配置文件

三个系统需要填写的配置内容完全相同。

1. 配置 auth.json

打开 .codex 目录中的：

auth.json

填写：

{
  "OPENAI_API_KEY": "sk-xxx"
}

将：

sk-xxx

替换成你在 DeepRouter 创建的真实 API Key。

macOS / Linux 可以直接编辑：

2. 配置 config.toml

打开：

config.toml

填写：

model_provider = "deeprouter"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.deeprouter]
name = "deeprouter"
base_url = "https://deeprouter.top/v1"
wire_api = "responses"
requires_openai_auth = true

macOS / Linux 可以直接编辑：

配置参数说明

参数	说明	可选值
`model_provider`	模型提供商标识	自定义名称
`model`	使用的模型	见下方模型列表
`model_reasoning_effort`	推理深度	`low` / `medium` / `high`
`disable_response_storage`	禁用响应存储	`true`（推荐）
`wire_api`	API 协议	`responses`

支持的模型

模型	说明
`gpt-5.6-sol`	GPT-5.6 模型，推荐
`gpt-5.6-terra`	GPT-5.6 系列
`gpt-5.6-luna`	GPT-5.6 模型
`gpt-5.5`	上一代版本
`gpt-5.4`	稳定版本
`gpt-5.4-mini`	轻量版，响应更快、成本更低
`gpt-5.3-codex-spark`	Codex 代码优化版

八、启动 Codex

配置完成后，建议完全关闭终端并重新打开。

然后进入需要使用 Codex 的项目目录：

启动 Codex：

如果能够正常进入 Codex CLI，即代表安装和配置完成。

九、常用命令

启动 Codex：

查看版本：

查看帮助：

升级 Codex：

十、常见问题

1. 401 / Invalid token

如果出现：

401 Unauthorized
Invalid token

通常代表 API Key 无效、过期或配置错误。

检查：

.codex/auth.json

确认：

{
  "OPENAI_API_KEY": "sk-xxx"
}

中的 API Key 是当前有效的 Token。

如果仍然出现 401，可以重新创建 API Token 并替换旧 Token。

2. model not found

如果出现：

model not found

检查：

model = "gpt-5.5"

模型名称必须与 API 服务商当前提供的模型 ID 完全一致。

3. 找不到 codex 命令

Windows PowerShell：

Get-Command codex

macOS / Linux：

如果已经安装 Codex，但仍然找不到命令，通常需要检查 npm 全局安装目录和 PATH 环境变量。

4. 检查是否安装了多个 Codex

Windows PowerShell：

Get-Command codex -All

macOS / Linux：

如果出现多个安装路径，说明系统中可能存在多套 Codex，建议只保留一套正常工作的版本。

十一、卸载 Codex CLI

npm 安装

Windows、macOS、Linux 通用：

Homebrew 安装（macOS）

独立安装（macOS / Linux）

十二、彻底清理 Codex 配置

**注意：**删除 .codex 目录会同时清除登录凭证、API 配置、第三方 Provider 配置、历史记录和缓存。如果只是普通升级或重新安装 CLI，不需要执行这一步。

Windows PowerShell

Remove-Item -Recurse -Force "$env:USERPROFILE\.codex"

macOS / Linux

十三、验证是否卸载成功

Windows PowerShell

Get-Command codex -All -ErrorAction SilentlyContinue
codex --version

macOS / Linux

如果提示：

command not found

或者 Windows 出现：

The term 'codex' is not recognized

说明 Codex CLI 已经卸载完成。

如果需要重新安装：

建议先确认：

能够正常运行，再重新配置 auth.json 和 config.toml。

Codex CLI 安装及配置卸载教程

Codex CLI 安装与配置教程#

一、环境要求#

二、安装 Node.js#

Windows#

macOS#

Linux#

三、安装 Codex CLI#

四、获取 API Token#

五、创建 Codex 配置文件#

macOS / Linux 可运行以下代码创建：#

六、修改 Codex 配置文件#

1. 配置 auth.json#

2. 配置 config.toml#

配置参数说明#

支持的模型#

八、启动 Codex#

九、常用命令#

十、常见问题#

1. 401 / Invalid token#

2. model not found#

3. 找不到 codex 命令#

4. 检查是否安装了多个 Codex#

十一、卸载 Codex CLI#

npm 安装#

Homebrew 安装（macOS）#

独立安装（macOS / Linux）#

十二、彻底清理 Codex 配置#

Windows PowerShell#

macOS / Linux#

十三、验证是否卸载成功#

Windows PowerShell#

macOS / Linux#

Codex CLI 安装与配置教程

一、环境要求

二、安装 Node.js

Windows

macOS

Linux

三、安装 Codex CLI

四、获取 API Token

五、创建 Codex 配置文件

macOS / Linux 可运行以下代码创建：

六、修改 Codex 配置文件

1. 配置 auth.json

2. 配置 config.toml

配置参数说明

支持的模型

八、启动 Codex

九、常用命令

十、常见问题

1. 401 / Invalid token

2. model not found

3. 找不到 codex 命令

4. 检查是否安装了多个 Codex

十一、卸载 Codex CLI

npm 安装

Homebrew 安装（macOS）

独立安装（macOS / Linux）

十二、彻底清理 Codex 配置

Windows PowerShell

macOS / Linux

十三、验证是否卸载成功

Windows PowerShell

macOS / Linux