OpenCode 配置指南

终端原生的开源 AI 编程助手，可替代 Claude Code / Cursor Agent。

🔗 相关链接

• 官方网站：https://opencode.ai/
• GitHub：https://github.com/sst/opencode

✨ 功能特点

• ✅ 终端原生 TUI：丰富的文本用户界面
• ✅ 多 Provider 支持：Anthropic / OpenAI / Google 三家一套统一
• ✅ 开源透明：MIT 许可，可自由审阅
• ✅ CC-Switch 集成：与 CC-Switch 完美配合
• ✅ 跨平台：macOS / Linux / Windows 三端通用

🛠️ 安装与配置

第一步：安装 OpenCode

打开终端，运行以下命令全局安装 OpenCode：

npm install -g opencode-ai

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

第二步：安装 CC-Switch

参考 CC-Switch 配置工具 文档，下载并安装 CC-Switch 到本地。

第三步：添加供应商

1. 选择配置项

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

2. 填写供应商信息

字段	值
供应商名称	my-proxy（或 my-proxy-Claude 等区分）
Provider 类型	Anthropic / OpenAI / Google (Gemini)（按需选择）
Base URL	https://api.nassaapi.xyz
API Key	本站对应分组的 Key
扩展选项	{"setCacheKey": true}（开启 Prompt 缓存）

💡 提示

请确保在控制台创建令牌时，额度设置正确。带 plan 后缀的是身份组，请勿直接调用。请在 创建专属 Key 时选择对应分组。

⌨️ 手动配置示例 (opencode.json)

如果您不使用 CC-Switch，可以手动编辑或创建 ~/.config/opencode/opencode.json：

{
  "provider": {
    "anthropic": {
      "models": {
        "claude-3-5-sonnet": { "id": "claude-3-5-sonnet-20241022" },
        "claude-3-opus":     { "id": "claude-3-opus-20240229" }
      },
      "options": {
        "baseURL": "https://api.nassaapi.xyz"
      }
    }
  }
}

然后通过环境变量设置 API Key：

export ANTHROPIC_API_KEY="sk-xxxx"

✅ 验证配置

opencode
# 输入 /help 查看所有指令
# 输入 /model 查看当前配置的模型

常见问题

安装时提示 npm 未找到？

你需要先安装 Node.js。参考 Node.js 环境安装。

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

• 检查 CC-Switch 是否正确选中当前配置为「当前使用」
• 重启 OpenCode（Ctrl+C 退出后重新 opencode）
• 检查 ~/.config/opencode/opencode.json 配置是否正确

更多问题

请查阅 疑难杂症 或 常见问题 (FAQ)。