OpenCode 配置指南
开源 AI 编程助手,终端中的智能编码伙伴
📋 简介
OpenCode 是一款开源的 AI 编程助手,可在终端、IDE 或桌面环境中辅助编写、调试和改进代码。支持原生终端 TUI 界面、多会话并行、75+ 模型提供商接入,是命令行开发者的理想工具。
🔗 相关链接
https://github.com/opencode-ai/opencode
✨ 功能特点
- ✅ 原生终端 TUI:专为命令行开发者设计,高效流畅
- ✅ 智能 LSP 加载:自动加载正确的语言服务器,提升上下文理解
- ✅ 多会话并行:支持多个会话同时运行,互不干扰
- ✅ 会话链接共享:可分享会话链接给他人协作
- ✅ 75+ 模型支持:支持多种模型提供商,包括本地模型
- ✅ 多平台支持:终端 CLI、桌面应用(Beta)、IDE 扩展

🛠️ 安装与配置
第一步:安装 OpenCode
打开终端,运行以下命令全局安装 OpenCode:
bash
npm install -g opencode-ai安装完成后,在终端输入 opencode 命令,若出现 TUI 界面则安装成功。
bash
opencode第二步:安装 CC-Switch
查看 CC-Switch 配置工具 文档,下载并安装 CC-Switch 到本地。
第三步:添加 LancerRouter 供应商
1. 选择配置项
打开 CC-Switch,上方配置项选择 OpenCode,然后点击「添加供应商」按钮。
2. 填写供应商信息
按以下说明配置各项参数:
- 供应商名称:自定义名称(如"LancerRouter")
- 供应商类型:Anthropic / OpenAI / Google (Gemini) 根据模型选择
- API Key:从 LancerRouter 控制台 创建对应分组的令牌
- Extra Body:
{"setCacheKey":true}

💡 支持的分组
根据你需要的模型类型,选择正确分组的 API Key:
- Claude 系列:只允许逆向分组
- GPT 系列:Codex 分组
- Gemini 系列:Gemini 分组
请在创建专属 Key 时选择对应分组。
✅ 验证配置
- 重新打开终端,输入
opencode运行
bash
opencode- 输入
/models命令,检查配置的渠道是否出现在模型列表中
bash
/models- 如果能看到你添加的模型,说明配置成功
开始愉快地编码吧!🎉
常见问题
安装时提示 npm 未找到?
请先安装 Node.js 环境,参考 Node.js 环境安装 文档。
模型列表中看不到配置的渠道?
- 确认 CC-Switch 中已正确保存配置
- 重启终端后再次运行
opencode - 检查 API Key 是否填写正确
更多问题
请查看 FAQ 或联系售后支持。