完整入门指南 · Windows 与 macOS

Claude Code + Space Router

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

Claude Code 安装文件夹不在 Windows PATH 中。先运行 & "$HOME\.local\bin\claude.exe"，再将 %USERPROFILE%\.local\bin 加入用户 PATH 并重开终端。

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

该模型名称无法通过网关使用。运行 /model，并从 Space Router 控制台的权威当前列表中选择模型。

Q: 可以与 VS Code 扩展一起使用吗？

可以。在 VS Code User Settings JSON 的 claudeCode.environmentVariables 中加入 ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY 与 ANTHROPIC_AUTH_TOKEN，两个身份验证变量使用相同的 key 值，并且切勿把 API key 提交到项目仓库。

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

从 Windows 的 %USERPROFILE%\.claude\settings.json 或 macOS 的 ~/.claude/settings.json 中移除 Space Router 环境变量。关闭所有 Claude Code 会话，再从新终端启动，使其不再使用 Space Router 基础 URL。

模型选择：Opus 对应 claude-opus-5，Sonnet 对应 claude-sonnet-5。当前目录没有 Haiku 路由，因此该选项会明确显示为 Sonnet（Haiku 回退）。修复旧配置后，请完全关闭 VS Code，再重新打开并新建对话。

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

安装 Claude Code，并使用 Space Router API key 将模型请求指向 Space Router。

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

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

一键安装

这只安装 Claude Code 并自动接入 Space Router；Codex 请使用 Codex 指南里的独立命令，一次只装一个。如果你想自行设置或安装器运行失败，可使用下方手动步骤。

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

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

安装程序会向你索取 API key：粘贴你创建的 sk- 开头的 key 并按回车。它会先验证 key 可用，再保存任何东西。

Windows

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

macOS

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

安装器会：

安装 Claude Code。
提示你粘贴 API key，并在保存前验证它是否可用。
在修改前备份任何现有配置。

请使用 Claude 分组的 key。Claude 与 GPT 需要不同的 key，因为各分组的价格不同。

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

如果你在 VS Code 里工作，请改用下面这条。它会按需安装 VS Code、两个工具、两个 VS Code 扩展（Claude Code 与 Codex），并分别询问 Claude key 与 GPT key；没有的那个直接按 Enter 跳过。电脑上的其他内容不会被改动。

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，中转站会直接拒绝。

如果这台电脑已有 Claude Code 对话，安装器只会把终端版指向 Space Router，并让桌面应用继续使用现有账户。

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 请求。它提供 OpenAI GPT 与 Anthropic Claude 模型系列；Space Router 控制台是当前模型列表的权威来源。

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

0. 获取 Space Router API Key

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

我们遇到的最常见 Windows 问题是：

claude : The term 'claude' is not recognized

这是 PATH 问题，不是 API key 问题。下文包含永久修复方法。

1. 所需软件

通过 Space Router 运行 Claude Code 的软件要求
软件	Windows	macOS	是否必需
Claude Code	是	是	是
Git	推荐	推荐	强烈推荐
PowerShell	系统内置	否	用于 Windows 安装
Node.js / npm	否	否	原生安装器不需要
Homebrew	否	可选	macOS 备用安装方式
VS Code	可选	可选	终端版 Claude Code 不需要
WSL	可选	否	Windows 原生版不需要

重要说明

目前推荐使用原生安装器。原生安装不需要 npm 或 Node.js。Anthropic 建议 Windows 原生环境安装 Git for Windows，以便 Claude Code 使用 Bash 工具；未安装时，Claude Code 也可以使用 PowerShell。

2. 安装 Git

Windows

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

git --version

macOS

检查 Git：

git --version

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

xcode-select --install
git --version

3. 安装 Claude Code

Windows PowerShell — 推荐

irm https://claude.ai/install.ps1 | iex
claude --version

Windows CMD 备用方式

此命令只能在 Command Prompt 中使用，不要在 PowerShell 中运行：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

macOS — 推荐

curl -fsSL https://claude.ai/install.sh | bash
claude --version

macOS Homebrew 备用方式

brew install --cask claude-code
claude --version

4. Windows 修复 — 无法识别 `claude`

我们测试时，Claude Code 已成功安装到 %USERPROFILE%\.local\bin\claude.exe，但该文件夹尚未加入 Windows PATH。

先确认 Claude 已安装

Test-Path "$HOME\.local\bin\claude.exe"

如果返回 True，Claude Code 已安装。你可以立即这样启动：

& "$HOME\.local\bin\claude.exe"

永久修复 PATH

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

claude --version
Get-Command claude
claude

现在无需输入完整 .exe 路径即可运行 claude。

5. macOS 修复 — `claude: command not found`

检查 Claude 是否存在：

ls -l ~/.local/bin/claude 2>/dev/null

如果存在，将其文件夹加入 PATH：

文件：~/.zshrc（macOS）

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

6. 临时测试 Space Router

在永久保存配置前，先在单个终端会话中测试网关。只替换 API key。

Windows PowerShell

目标：当前 Windows PowerShell 会话；此临时测试不会保存文件。

$env:ANTHROPIC_BASE_URL = "https://space.stationine.com"
$env:ANTHROPIC_API_KEY = "YOUR_SPACE_API_KEY"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_SPACE_API_KEY"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"
$env:CLAUDE_CODE_ATTRIBUTION_HEADER = "0"

claude

如果尚未修复 PATH：

& "$HOME\.local\bin\claude.exe"

macOS

目标：当前 macOS 终端会话；此临时测试不会保存文件。

export ANTHROPIC_BASE_URL="https://space.stationine.com"
export ANTHROPIC_API_KEY="YOUR_SPACE_API_KEY"
export ANTHROPIC_AUTH_TOKEN="YOUR_SPACE_API_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
export CLAUDE_CODE_ATTRIBUTION_HEADER=0

claude

7. 确认 Claude Code 正在使用 Space Router

在 Claude Code 内运行：

/status

找到 Anthropic base URL，它应指向 https://space.stationine.com。身份验证来源应使用 ANTHROPIC_API_KEY，同时让 ANTHROPIC_AUTH_TOKEN 保持相同值以兼容旧版本，或显示等效的有效 key 提示。

然后发送简单测试：

Reply with exactly: Space Router connection works.

如果 Claude 正常回复，基础连接就已成功。

8. 推荐的永久配置

对于网关，Claude Code 用户设置文件比只使用终端环境变量更可靠。它能跨终端会话生效，也适合需要继承网关配置的后台 Claude Code 进程。

Windows

文件：%USERPROFILE%\.claude\settings.json

New-Item -ItemType Directory -Force "$HOME\.claude" | Out-Null
notepad "$HOME\.claude\settings.json"

macOS

文件：~/.claude/settings.json

mkdir -p ~/.claude
nano ~/.claude/settings.json

9. 将以下内容写入 `settings.json`

文件：%USERPROFILE%\.claude\settings.json（Windows）/ ~/.claude/settings.json（macOS）

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://space.stationine.com",
    "ANTHROPIC_API_KEY": "YOUR_SPACE_API_KEY",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_SPACE_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

ANTHROPIC_API_KEY 是 Claude Code 用于身份验证的 key 名称；保留 ANTHROPIC_AUTH_TOKEN 是为了兼容旧版本，因此两者应填写相同值。

仅在你自己的电脑上，用 Space Router key 替换 YOUR_SPACE_API_KEY。不要在 JSON 中加入注释，也不要在最后一项后留下逗号。

macOS 文件权限

因为文件内含 API key，请运行：

chmod 600 ~/.claude/settings.json

10. 两个额外的 Space Router 变量

我们当前的 Space Router 设置指引包含以下设置。

文件：%USERPROFILE%\.claude\settings.json（Windows）/ ~/.claude/settings.json（macOS）

ANTHROPIC_API_KEY=YOUR_SPACE_API_KEY
ANTHROPIC_AUTH_TOKEN=YOUR_SPACE_API_KEY
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
CLAUDE_CODE_ATTRIBUTION_HEADER=0

`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1`

Anthropic 文档中有此变量。它会停止网关路径之外的非必要后台流量，重要副作用包括：

Claude Code 原生版自动更新会被禁用。
网关模型发现会被禁用。
部分后台可用性检查会被禁用。

因为自动更新被禁用，请定期手动更新 Claude Code。

`CLAUDE_CODE_ATTRIBUTION_HEADER=0`

该变量出现在我们当前的 Space Router 指引中。Anthropic 当前的公开网关文档未将它列为标准要求。Space Router 当前指引仍包含它时请保留；如果以后移除，它可能就不再需要。

11. 保存设置后重启 Claude Code

关闭所有正在运行的 Claude Code 会话，再打开一个新终端。

Windows

claude --version
claude

macOS

claude --version
claude

在 Claude Code 内运行 /status，再次确认：

Anthropic base URL = https://space.stationine.com

12. 在项目中启动 Claude Code

Claude Code 会处理启动命令所在的目录。

Windows 示例

cd "C:\Users\YourName\Documents\MyProject"
claude

macOS 示例

cd ~/Documents/MyProject
claude

如果从错误目录启动，Claude 会检查并编辑错误的文件夹。在要求它修改内容前，你可以先询问：

Tell me your current working directory and list the top-level files. Do not modify anything.

13. 大型工作前初始化 Git

如果这是新项目：

git init
git status

适合初学者的安全做法是先建立检查点：

git add .
git commit -m "checkpoint before Claude changes"
claude

如果 AI 的修改不符合预期，你就有可以返回的检查点。

14. 常用 Claude Code 命令

用于检查和管理 Space Router 会话的 Claude Code 命令
命令	运行位置	用途
`/help`	Claude Code 内	显示帮助。
`/status`	Claude Code 内	检查网关、身份验证和会话配置。
`/model`	Claude Code 内	选择或检查模型。
`/clear`	Claude Code 内	清除当前对话上下文。
`/exit`	Claude Code 内	退出 Claude Code。
`claude`	终端	启动交互模式。
`claude -c`	终端	继续当前目录最近的对话。
`claude -r`	终端	选择以前的会话继续。
`claude doctor`	终端	检查安装和环境。

15. 故障排除

Claude Code 与 Space Router 故障解决方法
问题	首先检查	解决
无法识别 `claude`	`PATH` 与安装路径	运行 `& "$HOME\.local\bin\claude.exe"`，再将 `%USERPROFILE%\.local\bin` 加入用户 `PATH` 并重开终端。
出现登录页面	`settings.json`、`ANTHROPIC_API_KEY` 与 `ANTHROPIC_AUTH_TOKEN`	创建用户 `settings.json`，把同一个 key 赋给两个身份验证变量，重启 Claude Code 并检查 `/status`。
`/status` 未显示 Space Router	`ANTHROPIC_BASE_URL`	将 `ANTHROPIC_BASE_URL` 设为 `https://space.stationine.com`，然后彻底重启 Claude Code。
401 Unauthorized	key 状态、两个变量名称与 JSON 语法	把同一个有效、完整且前后无空格的 key 写入 `ANTHROPIC_API_KEY` 与 `ANTHROPIC_AUTH_TOKEN`，再保存为有效 JSON。
找不到模型	Space Router 当前支持的模型	运行 `/model`，并从 Space Router 控制台的当前模型列表中选择模型。
Git 工具异常	Git for Windows	安装 Git for Windows，重开终端并运行 `git --version`。
VS Code 扩展要求登录	扩展专用的环境变量设置	在 VS Code User Settings JSON 的 `claudeCode.environmentVariables` 中加入 `ANTHROPIC_BASE_URL`、`ANTHROPIC_API_KEY` 与 `ANTHROPIC_AUTH_TOKEN`。

问题 A — 无法识别 `claude`

症状是 Windows 提示无法识别 claude。原因是 Claude Code 安装文件夹不在 PATH 中；先直接运行可执行文件，再将 %USERPROFILE%\.local\bin 加入用户 PATH 并重开终端。

& "$HOME\.local\bin\claude.exe"

症状是出现意外的 Claude 登录页面。原因是 Claude Code 未读到 Space Router key：用户设置文件缺失、某个身份验证变量缺失，或进程尚未重启。

确认 settings.json 存在。
确认同一个 key 已赋给 ANTHROPIC_API_KEY 与 ANTHROPIC_AUTH_TOKEN。
彻底关闭 Claude，打开新终端，重新运行并检查 /status。

Windows 文件：%USERPROFILE%\.claude\settings.json

Test-Path "$HOME\.claude\settings.json"

macOS 文件：~/.claude/settings.json

ls -l ~/.claude/settings.json

问题 C — `/status` 未显示 Space Router

症状是 /status 未显示 Space Router。原因是 Claude Code 没有读取到配置的基础 URL；请确认设置完全一致：

文件：%USERPROFILE%\.claude\settings.json（Windows）/ ~/.claude/settings.json（macOS）

"ANTHROPIC_BASE_URL": "https://space.stationine.com"

然后彻底重启 Claude Code。如果使用临时 PowerShell 变量，必须在设置变量的同一个 PowerShell 窗口中启动 Claude。

问题 D — 401 Unauthorized

症状是收到 401 Unauthorized，这表示 Space Router 没有收到可接受的有效凭据。请把同一个有效、未过期或撤销、完整且前后无空格的 key 写入 ANTHROPIC_API_KEY 与 ANTHROPIC_AUTH_TOKEN，并确保 settings.json 是有效 JSON。

ANTHROPIC_API_KEY 是 Claude Code 从 settings.json 读取并用于身份验证的名称；让 ANTHROPIC_AUTH_TOKEN 保持相同值，可以兼容旧版本。

问题 E — 找不到模型

症状是 Claude Code 报告找不到模型或拒绝模型名称。原因是该名称无法通过网关使用；运行 /model，并从 Space Router 控制台的权威当前列表中选择模型。

问题 F — Claude 能回答，但无法正确使用 Git

git --version

症状是 Claude 可以回答，但 Git 工具失败。原因是缺少 Git for Windows 或终端无法访问它；请安装 Git for Windows，重开终端并运行上面的命令验证。

症状是终端版 Claude Code 可用，但 VS Code 扩展要求登录。原因是扩展使用独立的环境变量配置；请把以下内容加入通过 Preferences: Open User Settings (JSON) 打开的文件：

{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://space.stationine.com"
    },
    {
      "name": "ANTHROPIC_API_KEY",
      "value": "YOUR_SPACE_API_KEY"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "YOUR_SPACE_API_KEY"
    }
  ]
}

打开 Preferences: Open User Settings (JSON) 并加入该设置。不要将此 API key 提交到项目仓库。

16. 禁用非必要流量后的手动更新

如果保留 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1，自动更新会被禁用。

Windows 原生安装器

irm https://claude.ai/install.ps1 | iex
claude --version

macOS 原生安装器

curl -fsSL https://claude.ai/install.sh | bash
claude --version

Homebrew

brew upgrade claude-code

常见问题

通过 Space Router 使用 Claude Code 需要 Node.js 吗？

不需要。推荐的 Claude Code 原生安装器不依赖 Node.js 或 npm，Space Router 配置保存在 Claude Code 用户设置文件中。

Windows 上需要 WSL 吗？

不需要。Claude Code 可以在 Windows 原生运行，因此 WSL 是可选项；建议安装 Git for Windows 以支持 Bash 工具，同时也可以使用 PowerShell。

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

Claude Code 安装文件夹不在 Windows PATH 中。先运行 & "$HOME\.local\bin\claude.exe"，再将 %USERPROFILE%\.local\bin 加入用户 PATH 并重开终端。

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

401 表示 Space Router 没有收到可接受的有效凭据。请把有效、完整且前后无空格的 key 同时写入 Claude Code 用户设置文件中的 ANTHROPIC_API_KEY 与 ANTHROPIC_AUTH_TOKEN，两者使用相同值，保存有效 JSON，然后重启 Claude Code。

模型名称被拒绝怎么办？

该模型名称无法通过网关使用。运行 /model，并从 Space Router 控制台的权威当前列表中选择模型。

可以与 VS Code 扩展一起使用吗？

可以。在 VS Code User Settings JSON 的 claudeCode.environmentVariables 中加入 ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY 与 ANTHROPIC_AUTH_TOKEN，两个身份验证变量使用相同的 key 值，并且切勿把 API key 提交到项目仓库。

如何切换回 Anthropic 官方端点？

从 Windows 的 %USERPROFILE%\.claude\settings.json 或 macOS 的 ~/.claude/settings.json 中移除 Space Router 环境变量。关闭所有 Claude Code 会话，再从新终端启动，使其不再使用 Space Router 基础 URL。

在哪里获得 Space Router 支持？

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

17. 参考资料

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

Claude Code + Space Router

一键安装

Windows

macOS

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

Space Router 是什么？

0. 获取 Space Router API Key

1. 所需软件

重要说明

2. 安装 Git

Windows

macOS

3. 安装 Claude Code

Windows PowerShell — 推荐

Windows CMD 备用方式

macOS — 推荐

macOS Homebrew 备用方式

4. Windows 修复 — 无法识别 claude

先确认 Claude 已安装

永久修复 PATH

5. macOS 修复 — claude: command not found

6. 临时测试 Space Router

Windows PowerShell

macOS

7. 确认 Claude Code 正在使用 Space Router

8. 推荐的永久配置

Windows

macOS

9. 将以下内容写入 settings.json

macOS 文件权限

10. 两个额外的 Space Router 变量

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

CLAUDE_CODE_ATTRIBUTION_HEADER=0

11. 保存设置后重启 Claude Code

Windows

macOS

12. 在项目中启动 Claude Code

Windows 示例

macOS 示例

13. 大型工作前初始化 Git

14. 常用 Claude Code 命令

15. 故障排除

问题 A — 无法识别 claude

问题 B — Claude 显示登录页面

问题 C — /status 未显示 Space Router

问题 D — 401 Unauthorized

问题 E — 找不到模型

问题 F — Claude 能回答，但无法正确使用 Git

问题 G — 终端可用，但 VS Code 扩展要求登录

16. 禁用非必要流量后的手动更新

Windows 原生安装器

macOS 原生安装器

Homebrew

常见问题

通过 Space Router 使用 Claude Code 需要 Node.js 吗？

Windows 上需要 WSL 吗？

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

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

模型名称被拒绝怎么办？

可以与 VS Code 扩展一起使用吗？

如何切换回 Anthropic 官方端点？

在哪里获得 Space Router 支持？

17. 参考资料

4. Windows 修复 — 无法识别 `claude`

5. macOS 修复 — `claude: command not found`

9. 将以下内容写入 `settings.json`

`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1`

`CLAUDE_CODE_ATTRIBUTION_HEADER=0`

问题 A — 无法识别 `claude`

问题 C — `/status` 未显示 Space Router

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