OpenCode 接入指南
在 OpenCode 开源终端 AI 编程智能体中接入 疾旋Token，基于 AI SDK 规范实现多模型调度与 GitHub 深度协同。
OpenCode 是一款专为终端开发者打造的开源 AI 编程智能体（GitHub: opencode-ai/opencode）。
它基于现代 AI SDK 体系构建，原生支持 75+ 种模型接入，能够深入理解大型代码仓库、自动编写与执行单元测试、修复编译错误，甚至在 GitHub Issue / PR 评论中通过 /opencode 指令进行全自动代码审查与 Bug 修复。
📦 安装 OpenCode
您可以通过常用的包管理器快速全局安装 OpenCode：
npm install -g opencode-ai
# 或者无需安装直接运行：
# npx opencode-ai⚙️ 接入配置指南
OpenCode 支持 配置文件定制、交互式 /connect 连接 及 环境变量注入 三种方式。
方式一：编辑配置文件 opencode.json（官方推荐）
OpenCode 支持在项目根目录（./opencode.json）或全局用户目录（~/.config/opencode/opencode.json）中进行配置。
创建或编辑配置文件，添加以下内容：
{
"$schema": "https://opencode.ai/config.json",
"model": "jixuan/GPT-5.6-sol",
"providers": {
"jixuan": {
"npm": "@ai-sdk/openai-compatible",
"name": "疾旋Token 旗舰专线",
"settings": {
"baseURL": "https://token.astrumflow.com/v1",
"apiKey": "{env:OPENAI_API_KEY}"
},
"models": {
"GPT-5.6-sol": {
"name": "GPT-5.6-sol 旗舰推理"
},
"GPT-5.6-terra": {
"name": "GPT-5.6-terra 高性能主力"
},
"GPT-5.6-luna": {
"name": "GPT-5.6-luna 极速响应"
}
}
}
}
}密钥安全建议：配置文件中使用 "{env:OPENAI_API_KEY}" 引用环境变量，避免将明文密钥直接提交至公共 Git 仓库中。
方式二：通过终端交互命令 /connect 快速接入
- 在终端中输入
opencode进入交互会话。 - 输入内置命令：
/connect - 在弹出的交互菜单中选择 OpenAI Compatible (兼容服务商)。
- 依次填入：
- Base URL：
https://token.astrumflow.com/v1 - API Key：粘贴您的
sk-your-astrumflow-token-key
- Base URL：
- 完成后，凭据将安全加密存储于
~/.local/share/opencode/auth.json中。
方式三：环境变量直接启动
如果您希望在 CI/CD 流程或临时终端中快速运行，可直接导出环境变量：
export OPENAI_BASE_URL="https://token.astrumflow.com/v1"
export OPENAI_API_KEY="sk-your-astrumflow-token-key"
# 启动并直接指定模型
opencode --model openai/GPT-5.6-sol🚀 常用开发协同场景
终端交互式全栈重构
在终端中直接运行 opencode，让 AI 分析多文件调用关系并自动生成修改 Diff。
GitHub PR 与 Issue 联动
在 GitHub 评论区输入 /opencode 帮我重构这段逻辑，自动生成修复 PR。
CI 自动化测试用例补全
在 GitHub Actions 中集成 OpenCode，自动为新提交的代码补充缺失的单元测试覆盖。