Codex Windows 使用指南

一、安装 Codex CLI

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

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

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

验证安装

codex --version

提示

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

二、配置 Codex

方法一（推荐）：通过配置文件设置

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

创建 config.toml 文件，添加以下内容：

disable_response_storage = true
model = "gpt-5.2"
model_reasoning_effort = "high"
model_provider = "opentoken"
sandbox_mode="danger-full-access"
windows_wsl_setup_acknowledged = true
base_instructions = "Always prefer built-in tools (read_file, list_dir, grep_files) over shell commands for file operations."
[experimental]
use_freeform_apply_patch = true
use_unified_exec_tool = true
[features]
apply_patch_freeform = true
ghost_commit = true
plan_tool = true
rmcp_client = true
streamable_shell = false
unified_exec = false
view_image_tool = true
web_search_request = true
enable_experimental_windows_sandbox = true
experimental_sandbox_command_assessment = true
parallel = true
[model_providers.opentoken]
base_url = "https://opentk.ai/v1"
name = "opentoken"
requires_openai_auth = true
wire_api = "responses"
[sandbox_workspace_write]
network_access = true

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

{
  "OPENAI_API_KEY": "你的API密钥"
}

方法二：通过环境变量设置

PowerShell 临时设置（当前会话）

$env:OPENAI_BASE_URL = "https://opentk.ai/v1"
$env:OPENAI_API_KEY = "你的API密钥"

PowerShell 永久设置（用户级）

[System.Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://opentk.ai/v1", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "你的API密钥", [System.EnvironmentVariableTarget]::User)

设置后需要重新打开 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 config get prefix
$env:Path
# 默认路径通常是：C:\Users\你的用户名\AppData\Roaming\npm

2. 权限问题

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

解决方法：

npm install -g @openai/codex

3. API 连接失败

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

解决方法：

echo $env:OPENAI_BASE_URL
echo $env:OPENAI_API_KEY
Test-NetConnection -ComputerName opentk.ai -Port 443
$env:OPENAI_BASE_URL = "https://opentk.ai/v1"
$env:OPENAI_API_KEY = "你的API密钥"

4. 更新 Codex

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

解决方法：

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

5. Node.js 版本过低

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

解决方法：

node --version

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

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

问题：安装或运行时被防火墙拦截

解决方法：

将 Node.js 和 npm 添加到防火墙白名单
临时关闭杀毒软件进行安装
检查企业网络策略是否允许访问 npm 仓库