OpenCode 配置

OpenCode 是一个开源的终端 AI 编程助手，支持多种模型后端。

前置条件

1. 已安装 Go 1.23+
2. 已创建 通用分组 的令牌

安装 OpenCode

go install github.com/opencode-ai/opencode@latest

或通过 Homebrew（macOS）：

brew install opencode-ai/tap/opencode

配置方法

在项目根目录创建 opencode.json：

{
  "providers": {
    "huiliu": {
      "apiKey": "sk-你的令牌",
      "baseURL": "https://www.huiliuapi.com/v1"
    }
  },
  "agents": {
    "coder": {
      "model": "huiliu/claude-sonnet-4-20250514",
      "maxTokens": 16384
    },
    "task": {
      "model": "huiliu/claude-sonnet-4-20250514",
      "maxTokens": 16384
    }
  }
}

也可以通过环境变量配置：

Linux / macOS

export OPENCODE_API_KEY="sk-你的令牌"
export OPENCODE_BASE_URL="https://www.huiliuapi.com/v1"

Windows PowerShell

$env:OPENCODE_API_KEY = "sk-你的令牌"
$env:OPENCODE_BASE_URL = "https://www.huiliuapi.com/v1"

启动

cd your-project
opencode

推荐模型

模型	适用场景
claude-sonnet-4-20250514	通用编程，性价比高
claude-opus-4	复杂架构设计
gpt-4o	多模态任务
deepseek-chat	低成本日常开发

常见问题

报 401 Unauthorized

• 检查 apiKey 是否正确
• 确认令牌属于 通用分组（OpenCode 走 OpenAI 兼容接口）

报 model not found

确认模型名称拼写正确，以控制台"模型广场"中显示的名称为准。