OpenCode 配置指南 工具

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

📋 简介

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

• OpenCode 项目：https://github.com/opencode-ai/opencode

功能特点

• ✅ 原生终端 TUI：专为命令行开发者设计，高效流畅
• ✅ 智能 LSP 加载：自动加载正确的语言服务器，提升上下文理解
• ✅ 多会话并行：支持多个会话同时运行，互不干扰
• ✅ 75+ 模型支持：支持多种模型提供商，包括本地模型
• ✅ 多平台支持：终端 CLI、桌面应用（Beta）、IDE 扩展

安装与配置

第一步：安装 OpenCode

npm install -g opencode-ai

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

第二步：添加 CC Code 供应商

打开配置文件（通常位于 ~/.opencode/config.json），添加 CC Code 供应商：

Claude 系列配置：

{
  "providers": {
    "cc-code-claude": {
      "type": "anthropic",
      "apiKey": "您的CC Code Claude API Key",
      "baseUrl": "https://ai.cccode.org"
    }
  }
}

Gemini 系列配置：

{
  "providers": {
    "cc-code-gemini": {
      "type": "google",
      "apiKey": "您的CC Code Gemini API Key",
      "baseUrl": "https://ai.cccode.org"
    }
  }
}

💡 支持的分组

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

• Claude 系列：只允许逆向分组
• Gemini 系列：Gemini 分组

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

验证配置

重新打开终端，输入 opencode 运行，输入 /models 命令，检查配置的渠道是否出现在模型列表中。

常见问题

安装时提示 npm 未找到？

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

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

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

更多问题请查看 FAQ 或联系售后支持。