Codex Windows使用指南

(一) 安装Node.js环境

Windows安装方法

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

1. 打开浏览器访问 https://nodejs.org/
2. 点击 "LTS" 版本进行下载（版本号要大于18，推荐长期支持版本）
3. 下载完成后双击 .msi 文件
4. 按照安装向导完成安装，保持默认设置即可

方法二：使用包管理器

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

# 使用 Chocolatey
choco install nodejs
# 或使用 Scoop
scoop install nodejs

Windows 注意事项

• 建议使用 PowerShell 而不是 CMD
• 如果遇到权限问题，尝试以管理员身份运行
• 某些杀毒软件可能会误报，需要添加白名单

验证安装是否成功

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

node --version
npm --version

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

---

(二) 安装 Codex Cli

安装 Codex Cli

打开 PowerShell 或 CMD，运行以下命令：

全局安装 Codex

npm i -g @openai/codex --registry=https://registry.npmmirror.com

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

验证

codex --version

提示

• 建议使用 PowerShell 而不是 CMD，功能更强大
• 如果遇到权限问题，以管理员身份运行 PowerShell

---

配置 Codex 环境变量

使用使用教程网页右上角小白一键配置桌面端软件进行配置

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

• 打开文件资源管理器，找到 C:\Users\你的用户名\.codex 文件夹（如果没有则创建） 如图: 创建config.toml,用Notepad打开，输入以下内容：

experimental_use_rmcp_client = true
model_provider = "88code"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
sandbox_mode = "workspace-write" 

[model_providers.88code]
name = "88code"
base_url = "https://88code.org/openai/v1"
wire_api = "responses"
env_key = "key88"
requires_openai_auth = true

[sandbox_workspace_write]
network_access = true

# [mcp_servers.context7]
# command = "cmd"
# args = [
#     "/c",
#     "bunx",
#     "-y",
#     "@upstash/context7-mcp",
#     "--api-key",
#     "ctx7sk-xxx",
# ]
# env = { SystemRoot="C:\\Windows" }
# startup_timeout_ms = 20_000


# [mcp_servers.fetch]
# command = "cmd"
# args = [
#     "/c",
#     "uvx",
#     "mcp-server-fetch"
# ]
# env = { SystemRoot="C:\\Windows" }
# startup_timeout_ms = 20_000

# [mcp_servers.sequential-thinking-offical]
# command = "cmd"
# args = [
#     "/c",
#     "npx",
#     "-y",
#     "@modelcontextprotocol/server-sequential-thinking"
# ]
# env = { SystemRoot="C:\\Windows" }
# startup_timeout_ms = 20_000

# [mcp_servers.hyperbrowser]
# command = "cmd"
# args = [
#     "/c",
#     "npx",
#     "-y",
#     "hyperbrowser-mcp"
# ]
# env = { SystemRoot="C:\\Windows",HYPERBROWSER_API_KEY="Yhb_xxx" }
# startup_timeout_ms = 20_000


# [mcp_servers.memory]
# command = "cmd"
# args = [
#     "/c",
#     "npx",
#     "-y",
#     "@modelcontextprotocol/server-memory"
# ]
# env = { SystemRoot="C:\\Windows" }
# startup_timeout_ms = 20_000

# [mcp_servers.ast-grep]
# command = "cmd"
# args = [
#     "/c",
#     "uvx",
#     "--from",
# 	"git+https://github.com/ast-grep/ast-grep-mcp",
# 	"ast-grep-server"
# ]
# env = { SystemRoot="C:\\Windows" }
# startup_timeout_ms = 20_000

# [mcp_servers.everything-search]
# command = "cmd"
# args = [
#     "/c",
#     "uvx",
#     "mcp-server-everything-search",
# ]
# env = { SystemRoot="C:\\Windows",EVERYTHING_SDK_PATH="D:\\xxxx\\Everything-SDK\\dll\\Everything64.dll" }
# startup_timeout_ms = 20_000

# [mcp_servers.tavily-mcp]
# command = "cmd"
# args = [
#     "/c",
#     "npx",
#     "-y",
#     "tavily-mcp@0.2.4",
# ]
# env = { SystemRoot="C:\\Windows",TAVILY_API_KEY="ctx7sk-xxxx" }
# startup_timeout_ms = 20_000


# [mcp_servers.github]
# command = "cmd"
# args = [
#     "/c",
#     "npx",
#     "-y",
#     "@modelcontextprotocol/server-github",
# ]
# env = { SystemRoot="C:\\Windows",GITHUB_PERSONAL_ACCESS_TOKEN="github_pat_xxx" }
# startup_timeout_ms = 20_000

# [mcp_servers.mcpr]
# command = "D:\\FNM_DIR\\aliases\\default\\mcpr-cli.cmd"
# args = [
#     "connect"
# ]
# env = { SystemRoot="C:\\Windows",MCPR_TOKEN="mcpr_xxx" }
# startup_timeout_ms = 200000

上的mcp被我注释了,有需要的自己去掉注释加上自己的apikey就可以使用,有使用mcp router的可以使用最后一个被注释的mcp即可

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

{
  "OPENAI_API_KEY": "88_xxx"
}

把88_xxx替换为你的88code的key即可 设置环境变量

[System.Environment]::SetEnvironmentVariable("key88", "你的API密钥", [System.EnvironmentVariableTarget]::User)

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

PowerShell 设置方法

在 PowerShell 中运行以下命令：

$env:OPENAI_BASE_URL = "https://88code.org/openai/v1"
$env:OPENAI_API_KEY = "你的API密钥"

使用你的 88code API 密钥，格式如 88_xxxxxxxxxx, 使用与 Claude Code 相同的 API 密钥即可。

PowerShell 永久设置（用户级）

在 PowerShell 中运行以下命令：

# 设置用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://88code.org/openai/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

启动 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://88code.org/openai/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 仓库

---