SPACE ROUTER · Claude Desktop
Claude Desktop + Space Router
通过 Gateway 设置连接 Claude Desktop,选择 Claude 模型并确认请求计费去向。
开始之前
| 字段 | 填写内容 | 核对要点 |
|---|---|---|
| 适用环境 | Windows;macOS;须提供 Third-Party Inference 设置 | 按系统选择安装方式,保留原配置备份 |
| 账户 | Space Router 账户与对应分组余额/订阅 | 应用自身登录与中转 API 密钥互相独立 |
终端会显示下载阶段。直接下载显示进度条或已接收字节,包管理器显示自己的输出;部分下载无法提供百分比。请保持终端打开,直到出现最终安装和连接结果。
Space Router 一键脚本分别报告 INSTALLATION(安装)和 CONNECTION(连接)。DONE 表示已检查应用或命令;VERIFIED 表示所述回复测试通过。SKIPPED / NOT CONFIGURED 需要继续接入步骤,FAILED / INCOMPLETE 则需处理显示的错误。CLI 测试不等于桌面或编辑器面板已验证。
示例及占位模型须替换为自己密钥分组支持的 ID。可先安装应用,再在连接步骤前创建密钥。
Gateway 模式通过 Space Router Claude 密钥调用模型。此模式可以不登录 Anthropic 账户而使用已配置的供应商;原 Claude 账户/订阅属于另一条线路。Space Router 桌面接入仍需完成下方真实回复验证。
1 · 一键安装
Windows
打开 PowerShell 应用:按 Windows 键,搜索 PowerShell 并打开。复制下方命令,粘贴到 PowerShell,然后按 Enter 回车。
irm https://stationine.com/setup-claude-desktop.ps1 | iex打开 PowerShell 运行安装命令,会在缺失时安装 Claude、检查应用,并隐藏输入自己的 Claude 分组密钥;空密钥跳过接入配置。
从官方 Claude 下载页 获取 Windows 版,运行安装器后打开 Claude。
macOS
打开终端(Terminal)应用:按 Command + Space,搜索 Terminal 并打开。复制下方命令,粘贴到终端,然后按 Return 回车。
bash -c 'script=$(curl -fL --progress-bar https://stationine.com/setup-claude-desktop.sh) && test -n "$script" && bash -c "$script"'在 macOS 14 或更高版本打开终端,粘贴此命令并回车。无须事先下载 Claude。
下载官方通用应用,校验 SHA256、应用身份、代码签名及 macOS 审核,再安装到 ~/Applications/Claude.app 并打开。已有安装会保留,请查看最终 INSTALLATION 结果。
此 Mac 安装器保留现有账户及设置,CONNECTION 会明确显示本安装器未配置连接。继续完成下方 Gateway 设置,再验证真实回复。正常 macOS 提示可能需要亲自确认。官方手动下载。
找到网关配置
在登录界面打开 macOS 菜单栏或 Windows 应用菜单,进入 Help → Troubleshooting → Enable Developer Mode,再打开 Developer → Configure Third-Party Inference。确认当前版本允许本地配置
菜单缺失时,先通过官方渠道更新并核对官方应用内配置说明。组织管理的配置可能只读,应使用管理员批准的配置。
应用能正常打开说明已安装;下面还需单独配置网关。安装 Claude Code 或 CC Switch 不会自动配置此桌面面板。
2 · 创建 API 密钥
登录 Space Router
打开 space.stationine.com 并登录自己的账户。测试前确认账户有可用余额或适用订阅。创建专用 API 密钥
进入 API 密钥 → 创建密钥,用本工具名称命名。选择 Claude / Anthropic,以账户实际可用分组为准。不同模型家族的密钥不能混用。保存完整密钥和模型名
将完整密钥存入密码管理器,再从可用渠道复制该密钥分组支持的模型全名。按需设置限额和有效期;应用内的公共模型列表不代表你的密钥都有权限。妥善保管密钥
只在自己的应用或本地凭证存储中填写密钥。不要将它放进共享截图、项目文件、导入链接或客服消息。购买两个分组时,分别创建密钥。

3 · 连接 Space Router
设置 Gateway 连接
在 Configure Third-Party Inference 中填写以下值,应用更改前保留当前配置备份。
| 字段 | 填写内容 | 核对要点 |
|---|---|---|
| 连接方式 | Gateway | 自定义推理网关 |
| Gateway 基础地址 | https://space.stationine.com | 填写根地址,应用会添加 /v1/messages |
| Gateway API 密钥 | YOUR_CLAUDE_GROUP_KEY | 自己的 Claude 分组密钥 |
| Gateway 认证方式 | bearer | Authorization: Bearer |
| 凭证类型 | Static API key | 此方式不填写 SSO/OIDC 字段 |
添加 Claude 模型
模型发现为空时,在 Models / Identity & models 中添加 Space Router 密钥支持的精确 Claude 模型 ID;要求时填写显示名。只有已确认模型及分组支持时才启用扩展上下文。
桌面网关要求 Anthropic Messages、流式及工具调用支持。发现模型不能证明 Chat、Cowork 或 Code 均兼容,应分别测试自己需要的模式。
测试并在本机应用
提供 Test connection 时先测试,再点 Apply Changes / Apply locally 在本机保存;不要导出或分享含真实密钥的配置。以 Gateway 模式重开
完全退出并重开 Claude,出现 Continue with Gateway / Local configuration 时选择该入口,选中刚添加的 Claude 模型并新建对话。普通 claude.ai 会话仍可能使用自身账户线路。
继续之前的聊天
导入会把历史复制到 Gateway 模式,后续回复使用已配置的供应商。它不会与 claude.ai 实时同步,原始记录仍保留。
先启用导入向导
部署配置须包含claudeAiImport,并设置enabled: true。默认关闭,请让部署管理员将其合并到现有配置,勿覆盖 Gateway 设置。打开 Settings → Import & export → Import…
选择 Sign in to claude.ai,亲自授权导出,再点 Fetch export;也可从 claude.ai Settings → Privacy 导出数据,在向导选择下载的 ZIP。请私下保管该文件。检查、导入并继续
选择所需聊天及本机 Cowork & Code 会话,检查后导入。在侧栏打开导入的聊天,审阅后选择 Trust and resume / Continue。选中 Gateway 时,新回复使用 Space Router。
需要后续云端历史时再次导入,已导入项目会跳过。Team/Enterprise 导出可能需要工作区所有者启用;功能取决于安装版本及部署策略。
4 · 验证真实回复
先选择 Gateway 模式,再在 Chat 进行回复测试。需要 Cowork/Code 时,分别验证对应模式及无害文件读取。实际客户端完整回复加对应用量记录才是 Space Router 桌面接入验收证据。
重新打开客户端
保存设置,完全退出并重开应用,开始一个新会话。选择 Space Router 供应商及密钥支持的模型,不要继续使用上一个供应商。发送一个小请求
发送17 加 25 是多少?只回复数字。,预期收到完整的42。该请求按所选模型正常费率消耗账户额度;测速通过或 HTTP 200 本身不能代表完整回复。核对用量记录
打开 Space Router 用量记录,核对本次测试的时间、模型和 API 密钥。客户端完整回复加上对应记录,比“已安装”或“已连接”标签更能说明接入成功。
常见问题
| 现象 | 检查与处理 |
|---|---|
| 401 / 403 | 检查密钥是否完整、启用、过期、受 IP 限制,以及分组权限。只在本机重新填写,不要公开密钥。 |
| 404 / 找不到模型 | 核对 API 格式、基础地址和模型全名。不要重复添加 /v1,也不要把完整请求路径填进基础地址字段。 |
| 429 / 余额或限额错误 | 检查账户余额、密钥限额及速率/并发限制。反复重试不会增加余额或解除限制。 |
| 超时 / 回复不完整 | 检查网络和渠道状态,保留时间与请求 ID 供排查。收到部分内容不代表本次测试成功。 |
| 仍在使用原供应商 | 重开客户端和新会话,核对所选供应商及环境变量/配置覆盖。需要恢复时用备份,不要删除整个配置。 |
需要帮助时,请向 Space Router 客服 提供应用版本、系统、模型全名、时间和请求 ID,并对密钥及私人项目内容打码。
| 字段 | 填写内容 | 核对要点 |
|---|---|---|
| 没有 Gateway 入口 | 核对官方版本、Developer 菜单及是否受管理配置控制;本地应用更改后完全重开。 | Claude Code 环境变量不配置此面板 |
| 模型列表为空 | 在 Models 输入精确 Claude ID 并核对密钥分组。自动发现只显示可识别的 Claude ID。 | 模型列表不等于回复验证 |
| Chat 可用但 Cowork/Code 失败 | 检查流式/工具支持及该模式网络或工作区限制,保留错误与请求时间供排查。 | 不要关闭 TLS 校验或沙箱隔离 |
备份、更新与恢复
修改已有设置前,将 Claude Desktop 本地第三方推理配置及本地数据 复制到私人备份位置,记下原供应商和模型,方便切回。不要将含凭证的备份放进项目仓库。
需要恢复时,关闭客户端,恢复对应文件或切回原供应商后重开。保留会话和其他无关设置。只有密钥确实泄露时,才在 Space Router 吊销并创建替代密钥。
使用应用正常更新方式,更新后重新核对供应商选择和一次真实回复。一个安装器仍运行时,不要同时再启动多份。
恢复时通过第三方配置界面还原已保存连接,或回到正常登录流程。网关会话与云账户历史应分别看待,切换模式前备份本地数据。