Skip to content

OpenCode 配置指南

开源 AI 编程助手,终端中的智能编码伙伴

📋 简介

OpenCode 是一款开源的 AI 编程助手,可在终端、IDE 或桌面环境中辅助编写、调试和改进代码。支持原生终端 TUI 界面、多会话并行、75+ 模型提供商接入,是命令行开发者的理想工具。

🔗 相关链接

资源地址
OpenCode 项目https://github.com/opencode-ai/opencode

✨ 功能特点

  • 原生终端 TUI:专为命令行开发者设计,高效流畅
  • 智能 LSP 加载:自动加载正确的语言服务器,提升上下文理解
  • 多会话并行:支持多个会话同时运行,互不干扰
  • 会话链接共享:可分享会话链接给他人协作
  • 75+ 模型支持:支持多种模型提供商,包括本地模型
  • 多平台支持:终端 CLI、桌面应用(Beta)、IDE 扩展

🛠️ 安装与配置

第一步:安装 OpenCode

打开终端,运行以下命令全局安装 OpenCode:

bash

npm install -g opencode-ai

安装完成后,在终端输入 opencode 命令,若出现 TUI 界面则安装成功。

安装成功界面

第二步:安装 CC-Switch

查看 CC-Switch 配置工具 文档,下载并安装 CC-Switch 到本地。

第三步:添加 FlashAPI 供应商

1. 选择配置项

打开 CC-Switch,上方配置项选择 OpenCode,然后点击 添加供应商 按钮。

添加供应商界面

2. 填写供应商信息

按以下说明配置各项参数:

配置项说明
预设供应商选择 FlashAPI
供应商标识自定义名称,如 FlashAPI-Claude
接口格式Claude 模型选 Anthropic;GPT 模型选 OpenAI;Gemini 模型选 Google (Gemini)
API Key填入你在 FlashAPI 控制台 创建的 Key
额外选项填写 {"setCacheKey":true}

💡 支持的分组

根据你需要的模型类型,选择正确分组的 API Key:

只允许逆向分组

  • Claude 系列:只允许逆向分组
  • GPT 系列:Codex 分组
  • Gemini 系列:Gemini 分组

请在 创建专属 Key 时选择对应分组。

✅ 验证配置

  • 重新打开终端,输入 opencode 运行
  • 输入 /models 命令,检查配置的渠道是否出现在模型列表中
  • 如果能看到你添加的模型,说明配置成功

模型列表验证

开始愉快地编码吧!🎉

使用中的对话界面

常见问题

安装时提示 npm 未找到?

请先安装 Node.js 环境,参考 Node.js 环境安装 文档。

模型列表中看不到配置的渠道?

  • 确认 CC-Switch 中已正确保存配置
  • 重启终端后再次运行 opencode
  • 检查 API Key 是否填写正确

更多问题

请查看 FAQ 或联系售后支持