Codex Windows使用指南 --知识铺

Codex Windows 使用指南

(一) 安装 Node.js 环境

Codex 需要 Node.js 环境才能运行（版本要求 ≥18）。

Windows 安装方法

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

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

方法二：使用包管理器

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

1
2
3
4
5


# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs

Windows 注意事项

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

验证安装

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

1
2


node --version
npm --version

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

(二) 安装 Codex CLI

安装 Codex CLI

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

1
2


# 全局安装 Codex
npm i -g @openai/codex --registry=https://registry.npmmirror.com

这个命令会从 npm 镜像源下载并安装最新版本的 Codex。更新也使用这个命令。

验证安装

1

codex --version

提示

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

(三) 配置 Codex 环境变量

方法一：使用 cc switch 配置（强烈推荐⭐⭐⭐）

查看 cc switch 配置文档

方法二：配置文件方式（推荐⭐⭐）

步骤 1：创建配置目录

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

目录示例

步骤 2：创建 config.toml

在 .codex 文件夹下创建 config.toml 文件，用记事本打开，输入以下内容：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78


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://www.88code.org/openai/v1"
wire_api = "responses"
env_key = "key88"

[sandbox_workspace_write]
network_access = true

# 以下为可选的 MCP 服务器配置（已注释）
# 需要使用时去掉注释并添加你的 API Key

# [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 服务器配置已被注释，有需要的可以去掉注释并添加自己的 API Key。使用 MCP Router 的可以使用最后一个 mcpr 配置。

步骤 3：创建 auth.json

在 .codex 文件夹下创建 auth.json 文件，内容如下：

1
2
3


{
  "OPENAI_API_KEY": "88_xxx"
}

把 88_xxx 替换为你的 88code API 密钥。

方法三：环境变量方式

临时设置（当前 PowerShell 会话有效）

在 PowerShell 中运行以下命令：

1
2


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

注意：API 密钥格式如 88_xxxxxxxxxx

永久设置（用户级）

在 PowerShell 中运行以下命令：

1
2
3


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

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

验证环境变量

在 PowerShell 中验证：

1
2


echo $env:OPENAI_BASE_URL
echo $env:OPENAI_API_KEY

文章目录

Codex Windows使用指南 --知识铺