OpenCode 接入指南：配置 OpenStarry 替代 Claude Code 旗舰开源方案

OpenCode（opencode.ai）是由 SST（sst.dev）团队开发的开源 AI 编程终端，原生支持 Claude、GPT、Gemini、GLM、DeepSeek、Kimi 等 75+ 模型，并通过 AI SDK（Vercel 出品）实现 OpenAI 兼容端点的「即插即用」。

OpenCode 拥有与 Claude Code 几乎一致的 TUI 体验（同样的 `/init`、斜杠命令、文件读写、Shell 执行），但所有代码以 MIT 协议开源，且通过 opencode.json 一行配置即可切换底层模型。对于希望摆脱单一厂商绑定、又不愿牺牲 Claude Code 级生产力的开发者，OpenCode 是当下最务实的选择。

本文将系统讲解如何把 OpenCode 接入 OpenStarry，并使用 GLM-5.1、DeepSeek V4、Kimi K2.6 等国产旗舰模型。完整官方文档可参考 OpenStarry Docs · OpenCode 章节。

---

一、为什么选择 OpenCode + OpenStarry

1.1 OpenCode vs Claude Code

1.2 为什么要通过 OpenStarry 接入

虽然 OpenCode 本身支持 75+ 模型，但如果你主要使用国产旗舰（GLM-5.1、DeepSeek V4、Kimi K2.6），直接接入会遇到 3 个问题：

1. 国内外多家账号管理麻烦：每家厂商单独计费、单独充值、单独对账；切换模型时要在多个 Dashboard 间反复横跳。
2. 支付链路不便：DeepSeek / Kimi / GLM 等国内厂商的官方渠道不一定支持外卡或企业付款；OpenStarry 支持支付宝、微信、对公转账、Stripe 全部方式。
3. 成本不透明：按次计费的 Coding Plan（星途版 ¥99/月 · 20000 次/月，计费规则）把复杂模型成本打包成「调用次数」，无需关注 token 用量，对个人/小团队特别友好。

通过 OpenStarry，一个 API Key + 一行 base_url 切换，即可使用所有模型，所有调用统一计费、统一定额、统一定期对账。

推荐套餐：每日深度编程推荐 星途版 ¥99/月 · 20000 次/月（约每天 660 次调用），成本可控；探索期先用 星序版 ¥9.9/周 · 1000 次/周 即可。详细计费见 计费说明。

---

二、环境准备

2.1 安装 Node.js 18+

OpenCode 通过 npm 分发，需要 Node.js 18 或更高版本（推荐 20 LTS）。

# macOS（推荐使用 fnm / nvm 装多版本）
brew install node@20

# Ubuntu / Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# Windows
winget install OpenJS.NodeJS.LTS

2.2 安装 OpenCode

# 全局安装 OpenCode CLI
npm install -g opencode-ai

# 验证安装
opencode --version
# 期望输出：opencode 0.x.y 或更新

如果 npm install 慢，可使用国内镜像：

npm config set registry https://registry.npmmirror.com
npm install -g opencode-ai

2.3 注册 OpenStarry 并获取 API Key

1. 访问 openstarry.com 注册账号
2. 登录后进入 Dashboard → API Keys
3. 点击「创建新 Key」，复制（格式为 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxx）
4. 首次注册会赠送 星痕版 200 次免费调用，可立即体验

完整步骤参见 OpenStarry Docs · 快速开始。

---

三、配置 OpenStarry 接入（3 种方式）

方式 1：项目级 opencode.json（推荐）

在你想要使用 OpenCode 的项目根目录创建 opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openstarry": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OpenStarry",
      "options": {
        "baseURL": "https://api.openstarry.com/v1",
        "apiKey": "sk-your-key-here"
      },
      "models": {
        "glm-5.1":          { "name": "GLM-5.1" },
        "glm-5-turbo":      { "name": "GLM-5 Turbo" },
        "deepseek-v4-pro":  { "name": "DeepSeek V4 Pro" },
        "deepseek-v4-flash":{ "name": "DeepSeek V4 Flash" },
        "kimi-k2.6":        { "name": "Kimi K2.6" },
        "MiniMax-m2.7":     { "name": "MiniMax M2.7" },
        "qwen3.6-plus":     { "name": "Qwen3.6 Plus" },
        "gpt-4o":           { "name": "GPT-4o" },
        "claude-sonnet-4-6":{ "name": "Claude Sonnet 4.6" }
      }
    }
  }
}

设置环境变量（推荐写入 ~/.zshrc / ~/.bashrc）：

export OPENSTARRY_API_KEY=sk-your-key-here
# 可选：默认模型
export OPENCODE_MODEL=openstarry/glm-5.1

运行 OpenCode：

cd your-project
opencode

进入 TUI 后输入 /models 可在已配置的 9 个模型间切换，输入 /init 初始化项目上下文。

方式 2：环境变量方式（最快）

适合不想维护配置文件的临时场景：

export OPENAI_API_KEY=sk-your-key-here
export OPENAI_BASE_URL=https://api.openstarry.com/v1
export OPENCODE_MODEL=glm-5.1

opencode

方式 3：全局 ~/.config/opencode/config.json

适合所有项目统一接入，配置一次即可。文件位置：

• macOS / Linux: ~/.config/opencode/config.json
• Windows: %USERPROFILE%\.config\opencode\config.json

配置内容与方式 1 一致，但 apiKey 推荐引用环境变量：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openstarry": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OpenStarry",
      "options": {
        "baseURL": "https://api.openstarry.com/v1",
        "apiKey": "{env:OPENSTARRY_API_KEY}"
      },
      "models": {
        "glm-5.1": { "name": "GLM-5.1" }
      }
    }
  }
}

{env:VAR_NAME} 语法让 OpenCode 启动时从环境变量读取，配置文件本身可以安全提交到 Git。

---

四、模型选择策略

OpenStarry 提供 40+ 模型，按使用场景推荐如下：

完整模型列表与实时价格见 OpenStarry Docs · 模型列表。

---

五、常见问题

Q1：OpenCode 与 Claude Code 命令一样吗？

几乎完全一样。OpenCode 早期 fork 自 Claude Code 0.2.x 之后持续独立演进，核心快捷键、/ 斜杠命令、!bash、@file 语法都保留。如果你已经熟悉 Claude Code，零成本切换。

Q2：报错 401 invalid api key

检查 apiKey 是否以 sk- 开头，以及环境变量是否生效（终端执行 echo $OPENSTARRY_API_KEY）。如果是项目级配置，注意 apiKey 字段在 options 内部，不要写在最外层。

Q3：报错 404 model not found

模型 ID 必须与 OpenStarry 后端完全一致（区分大小写）。查看准确列表：OpenStarry Docs · 模型列表。常见的拼写错误：GLM-5.1（应小写 glm-5.1）、Claude-Sonnet-4-6（应全小写 claude-sonnet-4-6）。

Q4：能否同时使用 OpenAI / Anthropic 直连 + OpenStarry？

可以。OpenCode 支持多 provider 并存，编辑 opencode.json 添多个 provider 条目即可，调用时通过 provider/model 格式选择，例如 openstarry/glm-5.1。

Q5：调用次数是怎么计的？

Coding Plan（按次计费）下，每次完整的 Agent 任务（无论内部调用了 1 次还是 10 次模型）算 1 次。Token Plan（按量计费）按实际 token 用量计费。详见 计费说明。

---

总结

OpenCode 是当前最接近 Claude Code 体验、但完全开源、可切换任意 LLM 的 AI 编程终端。通过 OpenStarry，一个 base_url + 一个 sk- 开头的 API Key，就能让 OpenCode 用上 GLM-5.1、DeepSeek V4、Kimi K2.6 等国产旗舰模型，按 星途版 ¥99/月 · 20000 次/月 走 Coding Plan 套餐，成本可控，无需关注 token 细节。

快速回顾：npm i -g opencode-ai → 创建 opencode.json → export OPENSTARRY_API_KEY=sk-... → opencode → 在 TUI 中用 /models 切换模型。整个过程不超过 5 分钟。