安装指南

一条命令完成 · Windows 与 macOS

OpenCode + Space Router

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

一条命令安装开源终端编程助手 OpenCode,并接入 Space Router 的 GPT、Claude 与可选 Fable、Grok 模型。

网关:https://space.stationine.com · 最近核对:

请妥善保管你的 API key。 不要在截图、聊天、仓库、项目文件或任何公开文档中泄露真实 key。若已泄露,请在 Space Router 吊销或轮换并重新创建。

一键安装

此安装器安装或更新 OpenCode V1 终端版 1.18.34,并备份后合并 Space Router 配置。跳过的 key、其它供应商、项目和历史记录会保留;不会清除登录或缓存。已安装 Desktop V2 或检测到原生 V2 配置时会停止,避免降级覆盖。Windows 已完成隔离验证;macOS 尚待真实设备验收。

命令贴到哪里。下面这条一键安装命令要在一个文字窗口里运行——Windows 用 PowerShell,macOS 用 终端(Terminal)。除此之外不需要懂任何东西。 安装程序会分别索取 GPT、Claude 与可选 Fable、Grok API key。粘贴已购买分组的 sk- key;未购买的分组直接按 Enter 跳过。只有已填写线路通过真实请求后,安装器才会显示准备完成。

Windows

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

macOS

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

该粘贴哪些 key

安装器会分别询问 GPT、Claude 与可选的 Claude Fable 5、Grok key。购买了哪个分组就填写哪个;未购买的直接按 Enter 跳过。各分组权限与价格不同,不能用一个分组的 key 替代另一个。

在 Space Router 后台的 Tokens → Create 中按对应分组创建 key。

启动 OpenCode

打开一个新的终端窗口,进入你要处理的项目文件夹,输入 opencode。在 OpenCode 里输入 /models,即可在 Space Router (GPT)、Space Router (Claude) 与已购买时的 Space Router (Claude Fable 5) 之间切换。Fable 的准确选项是 space-router-fable/claude-fable-5。默认顺序为 GPT、Claude、Fable、Grok;已有的其它默认模型会保留。

如果终端提示 opencode 不是可识别的命令,请关闭所有终端窗口再打开一个新的;Windows Terminal 在全部窗口关闭前会一直沿用旧的 PATH。

模型或线路不可用?请确认所选模型 ID、key 分组和余额。HTTP 404、余额不足、模型无可用账号与下载失败需要分别诊断;不要通过清除工作区或登录状态处理。

设置保存在哪里

配置位于 ~/.config/opencode/opencode.json,或现有的 opencode.jsonc;设置了 XDG_CONFIG_HOME 时使用该目录。安装器只更新本次填写 key 的 Space Router 供应商,保留其它设置;原文件会私密备份。JSONC 的注释和排版可能改变,设置值会保留。两种配置文件同时存在或设置了配置覆盖变量时会停止,要求先确认实际生效文件。

Desktop V2 自定义供应商错误

若保存供应商时出现 Custom Providers are unavailable on this server,上游有相同的 Desktop V2 已知问题。仅给网址追加 /v1 或重装 V1 CLI 不能证明修复了 Desktop 界面。V2 的 providers / package / settings 是有效配置;不要用 V1 的 provider / npm / options 覆盖。先确认版本,再按 官方 V2 配置说明备份并配置文件。供应商 key、协议和模型必须相互匹配;尚未验收的 V2 不应显示“已修复”。

Space Router 是什么?

Space Router 是由 Station Nine 运营的 AI API 中转服务,基础 URL 为 https://space.stationine.com。它支持 Anthropic Messages(POST /v1/messages)、OpenAI Chat Completions(POST /v1/chat/completions)与 OpenAI Responses(POST /v1/responses)格式,并提供 OpenAI GPT 与 Anthropic Claude 两个模型家族。更多服务与账户细节见 Space Router 概览。