OpenCode 配置指南：接入 75+ LLM 提供商

OpenCode 是一款开源的 AI 编码代理工具，支持 75+ LLM 提供商以及本地模型。本文基于 OpenCode 官方文档，详细介绍其提供商配置体系，涵盖从 Anthropic、OpenAI 到 Z.AI、本地模型等各类接入方式。

核心概念

OpenCode 使用 AI SDK 和 Models.dev 作为底层框架，支持通过 /connect 命令添加 API 密钥，凭据存储在 ~/.local/share/opencode/auth.json 中。你可以在 opencode.json 配置文件中自定义提供商设置，包括 Base URL、请求头等。

主流提供商配置

Anthropic

注册 Claude 后执行 /connect 选择 Anthropic，支持 Claude Pro/Max 订阅或手动输入 API 密钥两种认证方式。执行 /models 即可看到所有 Anthropic 模型。

OpenAI

同样通过 /connect 选择 OpenAI，支持 ChatGPT Plus/Pro 订阅认证或手动输入 API 密钥。

自定义 Base URL

通过设置 baseURL 选项可自定义任何提供商的端点，这对使用代理服务或自定义端点非常有用：

{
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.anthropic.com/v1"
      }
    }
  }
}

Z.AI 接入

前往 Z.AI API 控制台创建 API 密钥。如果订阅了 GLM Coding Plan，选择 Z.AI Coding Plan 选项，输入 API 密钥后执行 /models 选择模型如 GLM-4.7。

本地模型支持

OpenCode 支持通过多种方式运行本地模型：

Ollama：

{
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": { "baseURL": "http://localhost:11434/v1" },
      "models": { "llama2": { "name": "Llama 2" } }
    }
  }
}

LM Studio： 配置 baseURL 为 http://127.0.0.1:1234/v1。

llama.cpp： 通过 llama-server 工具配置，设置 baseURL 为 http://127.0.0.1:8080/v1。

自定义提供商

对于 /connect 命令中未列出的任何 OpenAI 兼容提供商，可以通过以下步骤添加：

1. 执行 /connect，选择 Other
2. 输入唯一提供商 ID
3. 输入 API 密钥
4. 在 opencode.json 中配置：

{
  "provider": {
    "myprovider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "My Provider",
      "options": { "baseURL": "https://api.myprovider.com/v1" },
      "models": { "my-model": { "name": "My Model" } }
    }
  }
}

认证与安全

OpenCode Zen 是由 OpenCode 团队提供的经过测试验证的模型列表，登录 opencode.ai/auth 即可获取 API 密钥。对于需要环境变量认证的提供商（如 Amazon Bedrock），可通过 AWS 配置文件或环境变量设置。

高级配置

支持自定义请求头、模型上下文窗口限制、输出 Token 限制等高级选项。例如启用 Helicone 缓存或设置 Vercel AI Gateway 的路由策略。

完整提供商目录

OpenCode 支持 75+ 提供商，包括：Anthropic、OpenAI、Google Vertex AI、Azure OpenAI、DeepSeek、Groq、xAI、Z.AI、Together AI、Fireworks AI、Ollama、LM Studio 等。每个提供商的具体配置方式均可通过官方文档查阅。

项目链接

• GitHub 仓库：OpenCode
• 官方文档：https://opencode.ai