完整入门指南 · Windows 与 macOS

ChatGPT / Codex + Space Router

Q: Windows 上需要 WSL 吗？

不需要。本指南通过 PowerShell 在 Windows 原生安装 Codex CLI，Windows 的 config.toml 配置块包含 windows_wsl_setup_acknowledged = true。

Q: 为什么终端提示无法识别 codex？

Codex 安装文件夹不在 PATH 中。Windows 将 %USERPROFILE%\.local\bin 加入用户 PATH，macOS 通过 ~/.zshrc 加入 ~/.local/bin，然后重开终端。

Q: 401 Unauthorized 表示什么，如何修复？

401 表示 Space Router 没有收到可接受的有效凭据。请把有效、完整且无多余空格的 key 写入有效 auth.json 内的 "OPENAI_API_KEY"，如果 key 已泄露则轮换它。

Q: 模型名称被拒绝怎么办？

将 config.toml 中的 model 与 review_model 替换为 Space Router 控制台权威列表中的当前 model ID。此设置请保持 wire_api = "responses"。

Q: 如何切换回 OpenAI 官方端点？

从安装器打印的 direct-backup 文件夹（位于 %LOCALAPPDATA%\SpaceRouter）恢复 config.toml 与 auth.json，然后完全重启 Codex。

Windows 安装支持本地、域及 Microsoft Entra ID（Azure AD）账户。如曾遇到 SID 配置错误，请重新运行下方一键安装命令；无需为此升级 Windows 或编辑器。

一条命令安装 ChatGPT / Codex 应用，依次询问你的 Space Router GPT、Grok、Gemini 与 DeepSeek key，写入 Codex 配置并逐一用真实请求验证。之后 Codex 直接使用这些 Space Router 模型。

网关：https://space.stationine.com · 最后检查：2026-10-01

请妥善保管你的 API key。切勿在截图、聊天消息、代码仓库、项目文件或公开文档中分享真实 API key。如果 key 已经泄露，请立即在 Space Router 中撤销或轮换，并创建新的 key。所有示例都只使用字面占位符 YOUR_SPACE_API_KEY；仅在你自己的电脑上替换它。

一键安装

这会安装 ChatGPT / Codex 桌面应用（以及用于验证连接的 Codex 命令行工具），然后自动写入与 Space Router 控制台 Use Key 说明相同的配置，并用真实请求检查。不需要登录 ChatGPT，也不安装任何网关软件。Claude Code 请使用 Claude Code 指南里的独立命令，一次只装一个。如果你想自行设置或安装器运行失败，可使用下方手动步骤。

命令贴到哪里。下面这条一键安装命令要在一个文字窗口里运行——Windows 用 PowerShell，macOS 用 终端（Terminal）。除此之外不需要懂任何东西。

Windows：按 Windows 键，输入 powershell，按回车。会弹出一个蓝色或黑色窗口。在窗口里点右键即可粘贴命令，再按回车。
macOS：按 ⌘ Command + 空格，输入 terminal，按回车。会弹出一个白色或黑色窗口。按 ⌘ V 粘贴命令，再按回车。

安装器会依次询问你的 Space Router key：GPT，以及可选的 Grok、Gemini 与 DeepSeek。请只在自己的电脑上粘贴 sk- key 并按回车；未购买的分组直接按回车跳过。每个 key 都会先用真实请求验证再保存，写好的配置也会用一次真实的 Codex 请求确认。

Windows

irm https://stationine.com/setup-codex.ps1 | iex

macOS

curl -fsSL https://stationine.com/setup-codex.sh | bash

安装器会：

安装当前版本的 ChatGPT / Codex 桌面应用与 Codex CLI。
写入前先把现有 config.toml 与 auth.json 备份到私密文件夹。本地会话、skills、memories、plugins 以及 config.toml 里的其他设置都会保留。
如果尚未安装，会从 Microsoft Store 安装 ChatGPT / Codex 应用。
依次询问 GPT、Grok、Gemini 与 DeepSeek key，并在保存前逐一验证；直接按回车可跳过。
为每个 key 写入 Space Router provider 与模型列表，然后为每个模型家族通过 Space Router 发送一次真实的 Codex 请求，成功后才报告完成。

Codex 一次只显示一个模型家族：按 GPT、Grok、Gemini、DeepSeek 的顺序默认使用你购买的第一个。其余已粘贴的家族也会保存，安装结束时会为每个家族打印一行切换命令，例如 node "…\SpaceRouter\direct-config.cjs" use gemini；粘贴运行后完全退出并重新打开应用即可。Claude 模型属于 Claude Code，它使用自己的 Claude 分组 key。

设置完成后请开新对话。安装前就已经打开的对话会沿用它创建时的连接，即使设置正确也会一直报 401（错误里的地址是 api.openai.com）。请完全退出并重开应用，然后点 New chat。原有对话不会被删除；你也可以把旧对话的链接复制到新对话里，让它继承上下文。

已经登录 ChatGPT？设置完成后，Codex 使用你的 Space Router key 而不是 ChatGPT 账户，所以账户区域会显示 Space Router 而不是你的邮箱。要换回 ChatGPT，请恢复安装器打印的备份并重新登录。

在 VS Code 里使用（Claude Code 与 Codex 一起）

如果你在 VS Code 里工作，请改用下面这条。它会安装 VS Code 以及 Claude Code 和 ChatGPT / Codex 两个扩展，分别询问 Claude、GPT、Grok、Gemini 与 DeepSeek key（都可跳过），并把两个扩展都接入 Space Router。

irm https://stationine.com/setup-vscode.ps1 | iex

curl -fsSL https://stationine.com/setup-vscode.sh | bash

之后打开 VS Code（如果已经开着，请关闭后重新打开），点击左侧栏的 Claude 或 Codex 图标。Claude key 不能用于 GPT，GPT key 也不能用于 Claude，中转站会直接拒绝。

下方其余手动步骤只适用于直连 provider 模式的 Codex CLI。它无法让官方 ChatGPT 订阅与多个 Space Router provider 同时生效。如果你已经使用登录账户的桌面应用，请使用上方一键网关；不要用下方手动示例覆盖自己的 auth.json。

Space Router 是什么？

Space Router 是由 Station Nine 运营的 AI API 中转服务。它的基础 URL 是 https://space.stationine.com。

它通过 POST /v1/messages 接收 Anthropic Messages 请求，通过 POST /v1/chat/completions 接收 OpenAI Chat Completions 请求，并通过 POST /v1/responses 接收 OpenAI Responses 请求。它提供 Anthropic Claude、OpenAI GPT、xAI Grok、Google Gemini 与 DeepSeek 模型系列；Space Router 控制台是当前模型列表的权威来源。

将 Codex CLI 指向 Space Router，会让其支持的 OpenAI Responses 格式模型请求经由该中转服务发送。服务与账户详情请参阅 Space Router 完整概览。

0. 获取 Space Router API Key

在 Space Router 使用邮箱注册并完成验证，或通过 GitHub 或 Google 登录。
添加额度，然后在控制台创建 API key。
后续步骤中的 YOUR_SPACE_API_KEY 都指这个私密 key；切勿公开或提交它。

1. 所需软件

通过 Space Router 运行 Codex CLI 的软件要求
软件	Windows	macOS	是否必需
Codex CLI	是	是	是
Git	推荐	推荐	强烈推荐
PowerShell	系统内置	否	仅 Windows
Node.js / npm	可选	可选	仅 npm 安装方式需要
Homebrew	否	可选	仅 Homebrew 安装方式需要
VS Code / Cursor	可选	可选	Codex CLI 不需要

2. 安装 Git

Windows

安装 Git for Windows。完成后关闭并重新打开 PowerShell，然后检查：

git --version

你应该会看到 Git 版本号。

macOS

git --version

如果 macOS 提示安装 Command Line Tools，请接受；也可以运行：

xcode-select --install
git --version

3. 安装 Codex CLI

Windows — 推荐

打开 PowerShell 并运行：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

安装后关闭 PowerShell，打开新窗口并检查：

codex --version

macOS — 推荐

curl -fsSL https://chatgpt.com/codex/install.sh | sh

关闭 Terminal，重新打开并检查：

codex --version

4. Codex 的其他安装方式

如果原生安装器已经成功，可以跳过本节。

npm — Windows 或 macOS

只有这种方式需要 Node.js 与 npm。

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

Homebrew — macOS

brew install --cask codex
codex --version

5. 如果 `codex` 提示 “command not found” 或 “not recognized”

先完全关闭终端并重新打开。

Windows

Get-Command codex -ErrorAction SilentlyContinue
where.exe codex
Test-Path "$HOME\.local\bin\codex.exe"

如果最后一条命令返回 True，请将 C:\Users\<YOUR_WINDOWS_USERNAME>\.local\bin 加入 User PATH：

按下 Windows 开始按钮，搜索 Environment Variables。
打开 Edit environment variables for your account。
选择 Path，依次点击 Edit 和 New。
添加 %USERPROFILE%\.local\bin。
确认所有窗口，关闭全部 PowerShell 窗口，再重新打开 PowerShell。

codex --version

macOS

command -v codex
ls -l ~/.local/bin/codex 2>/dev/null

如果 ~/.local/bin/codex 存在但仍找不到命令：

文件：~/.zshrc（macOS）

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
codex --version

6. 创建 Codex 配置文件夹

Windows

Codex 用户配置存放在 %USERPROFILE%\.codex\。

New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null

macOS

Codex 用户配置存放在 ~/.codex/。

mkdir -p ~/.codex

7. 在 `config.toml` 中配置 Space Router

Windows

文件：%USERPROFILE%\.codex\config.toml

notepad "$HOME\.codex\config.toml"

macOS

文件：~/.codex/config.toml

nano ~/.codex/config.toml

8. 重要 — 不要覆盖整个现有 `config.toml`

如果 config.toml 已包含你的设置、MCP servers、plugins、profiles、notifications 或其他配置，不要删除整个文件。只替换顶部的 model/provider 配置块。除非你明确要删除，否则保留现有 provider 块以下的所有内容。

同时移除旧的测试设置

不要添加：

文件：%USERPROFILE%\.codex\config.toml（Windows）/ ~/.codex/config.toml（macOS）

[features]
goals = true

如果它仅用于旧测试，请移除这两行。下面的配置有意排除了 goals = true。

9. Windows `config.toml` 顶部配置块

将以下内容放在 config.toml 开头：

文件：%USERPROFILE%\.codex\config.toml（Windows）

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://space.stationine.com"
wire_api = "responses"
requires_openai_auth = true

将现有 config.toml 的其余部分保留在下面。例如：

文件：%USERPROFILE%\.codex\config.toml（Windows）

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://space.stationine.com"
wire_api = "responses"
requires_openai_auth = true

# KEEP YOUR EXISTING CONFIGURATION BELOW THIS LINE.
# Example only:
#
# [mcp_servers.example]
# ...

10. macOS `config.toml` 顶部配置块

文件：~/.codex/config.toml（macOS）

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://space.stationine.com"
wire_api = "responses"
requires_openai_auth = true

macOS 不需要 windows_wsl_setup_acknowledged。同样，请将现有配置保留在这个配置块下方。

11. 创建 `auth.json`

API key 单独存放。

Windows

文件：%USERPROFILE%\.codex\auth.json

notepad "$HOME\.codex\auth.json"

macOS

文件：~/.codex/auth.json

nano ~/.codex/auth.json

写入：

文件：%USERPROFILE%\.codex\auth.json（Windows）/ ~/.codex/auth.json（macOS）

{
  "OPENAI_API_KEY": "YOUR_SPACE_API_KEY"
}

仅在你自己的电脑上，用新的 Space Router API key 替换 YOUR_SPACE_API_KEY。不要添加多余逗号。

macOS 安全权限

文件：~/.codex/auth.json（macOS）

chmod 600 ~/.codex/auth.json

12. 启动 Codex

打开你希望 Codex 处理的文件夹。

Windows 示例

cd "C:\path\to\your\project"
codex

macOS 示例

cd ~/path/to/your/project
codex

13. 首次测试

在 Codex 内尝试：

Tell me what folder you are currently working in and list the top-level files. Do not change anything.

然后运行 /status，确认 model/provider 信息正确。还可以运行 /model 检查或更换模型。

14. Git 初学者工作流程

如果这是新项目：

git init
git status

适合初学者的安全习惯，是在要求 Codex 大幅修改前先建立 Git 检查点：

git add .
git commit -m "checkpoint before Codex changes"
codex

15. 常见问题

Codex CLI 与 Space Router 故障解决方法
问题	首先检查	解决
无法识别 `codex`	安装文件夹是否在 `PATH` 中	Windows 将 `%USERPROFILE%\.local\bin` 加入用户 `PATH`，macOS 通过 `~/.zshrc` 加入 `~/.local/bin`，然后重开终端。
Codex 要求登录	`config.toml`、`auth.json` 与 `requires_openai_auth`	创建两个用户文件，设置 `requires_openai_auth = true`，然后彻底重启 Codex。
401 / Unauthorized	key 有效性与 `auth.json` 语法	把有效、完整且无多余空格的 key 写入 `"OPENAI_API_KEY"`，保存有效 JSON，并轮换任何已泄露的 key。
找不到模型	Space Router 当前支持的模型 ID	将 `model` 与 `review_model` 替换为 Space Router 控制台中的当前 model ID；保持 `wire_api = "responses"`。
现有设置消失	恢复 provider 配置块下方的配置	在新 provider 配置块下恢复 MCP、plugin 与 profile 配置，并移除过时的 `goals = true` 测试设置。

问题 A — 无法识别 `codex`

症状是终端无法识别 codex。原因是安装文件夹不在 PATH 中；Windows 将 %USERPROFILE%\.local\bin 加入用户 PATH，macOS 通过 ~/.zshrc 加入 ~/.local/bin，然后重开终端并运行 codex --version。

症状是出现意外的 Codex 登录提示。原因是某个用户配置文件缺失，或 provider 配置块没有启用 OpenAI 身份验证。

Windows 文件：%USERPROFILE%\.codex\config.toml 与 %USERPROFILE%\.codex\auth.json

Test-Path "$HOME\.codex\config.toml"
Test-Path "$HOME\.codex\auth.json"

macOS 文件：~/.codex/config.toml 与 ~/.codex/auth.json

ls -l ~/.codex/config.toml
ls -l ~/.codex/auth.json

在 Windows 上，两条命令都应返回 True。彻底关闭并重启 Codex。还要确保 [model_providers.OpenAI] 下存在：

文件：%USERPROFILE%\.codex\config.toml（Windows）/ ~/.codex/config.toml（macOS）

requires_openai_auth = true

问题 C — 401 / Unauthorized

症状是收到 401 或 Unauthorized，这表示 Space Router 没有收到可接受的有效凭据。请按以下步骤修复 auth.json：

确认 Space Router API key 仍然有效。
确认完整复制了 key，且没有多余空格。
确认 auth.json 是有效 JSON。
确认 key 位于 "OPENAI_API_KEY" 中。

如果 key 曾出现在截图中或被公开分享，请立即轮换。

问题 D — 找不到模型

症状是 Codex 报告找不到模型。原因是配置的 model ID 无法通过网关使用；本指南当前使用：

文件：%USERPROFILE%\.codex\config.toml（Windows）/ ~/.codex/config.toml（macOS）

model = "gpt-5.5"
review_model = "gpt-5.5"

这些值与我们当前的 Space Router 设置配置一致。如果名称被拒绝，请将两项都替换为 Space Router 控制台权威当前列表中的 model ID。不要随意更改 wire_api；此设置必须保持：

文件：%USERPROFILE%\.codex\config.toml（Windows）/ ~/.codex/config.toml（macOS）

wire_api = "responses"

问题 E — 现有 Codex 设置消失

症状是 MCP、plugin、profile 或其他 Codex 设置消失。原因是替换了整个 config.toml；请在新 provider 配置块下恢复这些配置，并移除过时的 goals = true 测试设置。

文件：%USERPROFILE%\.codex\config.toml（Windows）/ ~/.codex/config.toml（macOS）

Replace only the top model/provider block
↓
Keep the rest of config.toml
↓
Do not add [features] goals = true

将 MCP、plugin 与 profile 配置恢复到新的 provider 配置块下方。

常见问题

通过 Space Router 使用 Codex CLI 需要 Node.js 吗？

你不需要自行安装 Node.js。一键桌面网关会自动安装所需运行环境；手动原生 Codex CLI 安装不依赖 Node.js。下方 npm 备用方式才需要你自己准备。

Windows 上需要 WSL 吗？

不需要。本指南通过 PowerShell 在 Windows 原生安装 Codex CLI，Windows 的 config.toml 配置块包含 windows_wsl_setup_acknowledged = true。

为什么终端提示无法识别 `codex`？

Codex 安装文件夹不在 PATH 中。Windows 将 %USERPROFILE%\.local\bin 加入用户 PATH，macOS 通过 ~/.zshrc 加入 ~/.local/bin，然后重开终端。

401 Unauthorized 表示什么，如何修复？

401 表示 Space Router 没有收到可接受的有效凭据。请把有效、完整且无多余空格的 key 写入有效 auth.json 内的 "OPENAI_API_KEY"，如果 key 已泄露则轮换它。

模型名称被拒绝怎么办？

将 config.toml 中的 model 与 review_model 替换为 Space Router 控制台权威列表中的当前 model ID。此设置请保持 wire_api = "responses"。

可以与编辑器或 IDE 扩展一起使用吗？

VS Code 与 Cursor 是可选项，Codex CLI 不需要它们。本指南配置的是 CLI，因此请从项目目录启动 codex，不要假设编辑器扩展会继承这些用户文件。

如何切换回 OpenAI 官方端点？

从安装器打印的 direct-backup-* 文件夹（位于 %LOCALAPPDATA%\SpaceRouter）恢复 config.toml 与 auth.json，完全重启 Codex；如需换回 ChatGPT 账户，再重新登录。

在哪里获得 Space Router 支持？

可发送邮件至 apisupport@stationine.com，或在 Space Router Telegram 群组中联系支持。Space Router 由 Station Nine 运营。

16. 参考资料

Space Router 由 Station Nine（stationine.com）运营。相对于 OpenAI，它属于第三方网关：OpenAI 不维护、审核或支持第三方网关，因此厂商相关问题应报告给 Space Router，而不是 OpenAI。

ChatGPT / Codex + Space Router

一键安装

Windows

macOS

在 VS Code 里使用（Claude Code 与 Codex 一起）

Space Router 是什么？

0. 获取 Space Router API Key

1. 所需软件

推荐的入门设置

2. 安装 Git

Windows

macOS

3. 安装 Codex CLI

Windows — 推荐

macOS — 推荐

4. Codex 的其他安装方式

npm — Windows 或 macOS

Homebrew — macOS

5. 如果 codex 提示 “command not found” 或 “not recognized”

Windows

macOS

6. 创建 Codex 配置文件夹

Windows

macOS

7. 在 config.toml 中配置 Space Router

Windows

macOS

8. 重要 — 不要覆盖整个现有 config.toml

同时移除旧的测试设置

9. Windows config.toml 顶部配置块

10. macOS config.toml 顶部配置块

11. 创建 auth.json

Windows

macOS

macOS 安全权限

12. 启动 Codex

Windows 示例

macOS 示例

13. 首次测试

14. Git 初学者工作流程

15. 常见问题

问题 A — 无法识别 codex

问题 B — Codex 要求登录

问题 C — 401 / Unauthorized

问题 D — 找不到模型

问题 E — 现有 Codex 设置消失

常见问题

通过 Space Router 使用 Codex CLI 需要 Node.js 吗？

Windows 上需要 WSL 吗？

为什么终端提示无法识别 codex？

401 Unauthorized 表示什么，如何修复？

模型名称被拒绝怎么办？

可以与编辑器或 IDE 扩展一起使用吗？

如何切换回 OpenAI 官方端点？

在哪里获得 Space Router 支持？

16. 参考资料

5. 如果 `codex` 提示 “command not found” 或 “not recognized”

7. 在 `config.toml` 中配置 Space Router

8. 重要 — 不要覆盖整个现有 `config.toml`

9. Windows `config.toml` 顶部配置块

10. macOS `config.toml` 顶部配置块

11. 创建 `auth.json`

问题 A — 无法识别 `codex`

为什么终端提示无法识别 `codex`？