💻 Windows 用户使用教程

Windows 用户建议使用 PowerShell。核心是安装 Codex CLI、写入 config.toml、设置 OPENAI_API_KEY。

1. 打开 PowerShell

在开始菜单搜索 PowerShell 并打开。

2. 检查 Node.js 和 npm

node -v
npm -v

能看到版本号后，安装 Codex CLI：

npm install -g @openai/codex
codex --version

3. 写入配置文件

Windows 配置文件位置：

%USERPROFILE%\.codex\config.toml

model_provider = "shiyu"
model = "gpt-5.3-codex"
review_model = "gpt-5.3-codex"
model_reasoning_effort = "high"

[model_providers.shiyu]
name = "像素群岛"
base_url = "https://api.shiyutv.cn/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"

4. 设置 API Key

当前 PowerShell 窗口临时生效：

$env:OPENAI_API_KEY="【你的 API Key】"

5. 测试

codex

进入后发送：

你好，请回复一句话确认 Codex CLI 已经接入成功。

排查清单

• base_url 是否是 https://api.shiyutv.cn/v1。
• OPENAI_API_KEY 是否在当前 PowerShell 生效。
• 模型名称是否在后台可用。
• 改完配置后是否重启终端。
• 账号是否还有余额。