Codex Windows使用教程

（一）安装Node.js环境

Windows安装方法

方法一：官网下载（推荐）

1.下载地址：node.js官网

2.点击 Windows installer (.msi)进行下载

3..node版本要求至少是v18.x的版本

4.下载完成之后双击.msi文件

5.按照安装向导完成安装，保持默认设置即可

方法二：使用包管理器

如果你安装了 Chocolatey 或 Scoop，可以使用命令行安装：

Windows 注意事项

建议使用 PowerShell 而不是 CMD

如果遇到权限问题，尝试以管理员身份运行

某些杀毒软件可能会误报，需要添加白名单

验证安装是否成功

安装完成后，打开 PowerShell 或 CMD，输入以下命令：

node --version
npm --version

如果显示版本号，说明安装成功了！

（二）安装Codex Cli

打开命令提示符（以管理员身份运行）或 PowerShell，执行以下命令：

验证安装：

注意：如果遇到权限问题，请确保以管理员身份运行命令提示符。

这个命令会从 npm 官方仓库下载并安装最新版本的 Codex。更新也使用这个命令

提示

建议使用 PowerShell 而不是 CMD，功能更强大

如果遇到权限问题，以管理员身份运行 PowerShell

配置Codex环境变量

方法一：（推荐）

使用编辑配置文件方式配置 Codex 环境变量

打开文件资源管理器，找到 `C:\Users\你的用户名\.codex` 文件夹（如果没有则创建）如图:

创建`config.toml`，使用记事本或您喜欢的文本编辑器编辑 config.toml 文件

并输入一下内容

model_provider = "aicanapi"
model = "gpt-5.2"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true

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

创建 `auth.json` 文件，在文件添加以下内容：

方法二

如果你使用支持 OpenAI API 的工具（如 Codex），需要设置以下环境变量：

PowerShell 设置方法

在 PowerShell 中运行以下命令：

PowerShell 永久设置（用户级）

在 PowerShell 中运行以下命令：

# 设置用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://aicanapi.com/v1", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "你的API密钥", [System.EnvironmentVariableTarget]::User)

设置后需要重新打开 PowerShell 窗口才能生效。

验证 Codex 环境变量

在 PowerShell 中验证：

echo $env:OPENAI_BASE_URL
echo $env:OPENAI_API_KEY

（三）开始使用Codex

配置完成后，在 PowerShell 或 CMD 中输入以下命令启动 Codex：

codex

首次启动时，Codex 会进行初始化配置。

基本使用

交互模式：直接输入 codex 进入交互式对话

指定项目：在项目目录下运行 codex，Codex 会自动识别项目上下文

退出程序：输入 exit 或按 Ctrl+C 退出

（四）常见问题解决

1.命令未找到错误

问题：运行 `codex` 时提示 "不是内部或外部命令"

解决办法：

# 检查 npm 全局安装路径
npm config get prefix

# 确保该路径在 PATH 中
$env:Path

# 如果不在，添加到系统环境变量
# 打开系统环境变量设置，将 npm 全局路径添加到 Path 中
# 默认路径通常是：C:\Users\你的用户名\AppData\Roaming\npm

2.权限问题

问题：安装时提示权限不足

解决办法：

# 以管理员身份运行 PowerShell
# 右键点击 PowerShell 图标，选择"以管理员身份运行"

# 然后重新安装
npm install -g @openai/codex

3.API链接失败

问题：Codex无法连接到API服务

解决办法：

# 检查环境变量是否正确设置
echo $env:OPENAI_BASE_URL
echo $env:OPENAI_API_KEY

# 测试网络连接
Test-NetConnection -ComputerName 88code.org -Port 443

# 重新设置环境变量
$env:OPENAI_BASE_URL = "https://aicanapi/v1"
$env:OPENAI_API_KEY = "你的API密钥"

4.更新Codex

问题：如何更新到最新版本

解决办法：

# 更新 Codex（推荐使用国内镜像）
npm i -g @openai/codex --registry=https://registry.npmmirror.com

# 或者重新安装
npm install -g @openai/codex

5.Node.js版本过低

问题：提示Node.js版本不兼容

解决办法：

# 检查当前版本
node --version

# 从官网下载最新的 LTS 版本（需要 18 或更高版本）
# 访问 https://nodejs.org/ 下载安装

6.防火墙或杀毒软件拦截

问题：安装或者使用时被防火墙拦截

解决办法：

将 Node.js 和 npm 添加到防火墙白名单

临时关闭杀毒软件进行安装

检查企业网络策略是否允许访问 npm 仓库

WIndows

Codex Windows使用教程#

（一）安装Node.js环境#

Windows安装方法#

方法一：官网下载（推荐）#

方法二：使用包管理器#

如果你安装了 Chocolatey 或 Scoop，可以使用命令行安装：#

Windows 注意事项#

验证安装是否成功#

安装完成后，打开 PowerShell 或 CMD，输入以下命令：#

如果显示版本号，说明安装成功了！#

（二）安装Codex Cli#

这个命令会从 npm 官方仓库下载并安装最新版本的 Codex。更新也使用这个命令#

配置Codex环境变量#

方法一：（推荐）#

使用编辑配置文件方式配置 Codex 环境变量#

打开文件资源管理器，找到 C:\Users\你的用户名\.codex 文件夹（如果没有则创建） 如图:#

创建config.toml，使用记事本或您喜欢的文本编辑器编辑 config.toml 文件#

并输入一下内容#

创建 auth.json 文件，在文件添加以下内容：#

方法二#

如果你使用支持 OpenAI API 的工具（如 Codex），需要设置以下环境变量：#

PowerShell 设置方法#

在 PowerShell 中运行以下命令：#

PowerShell 永久设置（用户级）#

在 PowerShell 中运行以下命令：#

验证 Codex 环境变量#

在 PowerShell 中验证：#

（三）开始使用Codex#

配置完成后，在 PowerShell 或 CMD 中输入以下命令启动 Codex：#

基本使用#

（四）常见问题解决#

1.命令未找到错误#

问题：运行 codex 时提示 "不是内部或外部命令"#

解决办法：#

2.权限问题#

问题：安装时提示权限不足#

解决办法：#

3.API链接失败#

问题：Codex无法连接到API服务#

解决办法：#

4.更新Codex#

问题：如何更新到最新版本#

解决办法：#

5.Node.js版本过低#

问题：提示Node.js版本不兼容#

解决办法：#

6.防火墙或杀毒软件拦截#

问题：安装或者使用时被防火墙拦截#

解决办法：#

Codex Windows使用教程

（一）安装Node.js环境

Windows安装方法

方法一：官网下载（推荐）

方法二：使用包管理器

如果你安装了 Chocolatey 或 Scoop，可以使用命令行安装：

Windows 注意事项

验证安装是否成功

安装完成后，打开 PowerShell 或 CMD，输入以下命令：

如果显示版本号，说明安装成功了！

（二）安装Codex Cli

这个命令会从 npm 官方仓库下载并安装最新版本的 Codex。更新也使用这个命令

配置Codex环境变量

方法一：（推荐）

使用编辑配置文件方式配置 Codex 环境变量

打开文件资源管理器，找到 `C:\Users\你的用户名\.codex` 文件夹（如果没有则创建）如图:

创建`config.toml`，使用记事本或您喜欢的文本编辑器编辑 config.toml 文件

并输入一下内容

创建 `auth.json` 文件，在文件添加以下内容：

方法二

如果你使用支持 OpenAI API 的工具（如 Codex），需要设置以下环境变量：

PowerShell 设置方法

在 PowerShell 中运行以下命令：

PowerShell 永久设置（用户级）

在 PowerShell 中运行以下命令：

验证 Codex 环境变量

在 PowerShell 中验证：

（三）开始使用Codex

配置完成后，在 PowerShell 或 CMD 中输入以下命令启动 Codex：

基本使用

（四）常见问题解决

1.命令未找到错误

问题：运行 `codex` 时提示 "不是内部或外部命令"

解决办法：

2.权限问题

问题：安装时提示权限不足

解决办法：

3.API链接失败

问题：Codex无法连接到API服务

解决办法：

4.更新Codex

问题：如何更新到最新版本

解决办法：

5.Node.js版本过低

问题：提示Node.js版本不兼容

解决办法：

6.防火墙或杀毒软件拦截

问题：安装或者使用时被防火墙拦截

解决办法：