Provider 概览

OpenCode 支持多种 LLM 提供商，分为以下几类：

类别Provider特点
官方精选OpenCode Zen预配置，开箱即用
Anthropic Claude官方推荐，性能优秀
云平台AWS Bedrock企业级，合规性好
Google Vertex AI与 GCP 集成
Azure OpenAI企业级 OpenAI
订阅制GitHub Copilot已有订阅可直接用
ChatGPT Plus/ProOpenAI 订阅用户
本地模型Ollama最简单的本地方案
LM Studio图形化界面管理

配置方法

Anthropic Claude（推荐）

1. 获取 API Key：访问 console.anthropic.com

2. 设置环境变量：

export ANTHROPIC_API_KEY=sk-ant-xxx

3. 或在 ~/.config/opencode/config.json 中配置：

{
  "provider": "anthropic",
  "model": "claude-sonnet-4-20250514"
}

OpenAI

export OPENAI_API_KEY=sk-xxx
# 配置
{
  "provider": "openai",
  "model": "gpt-4-turbo"
}

GitHub Copilot

如果你已有 Copilot 订阅，无需额外配置：

{
  "provider": "copilot"
}

首次使用时会引导你登录 GitHub 账号。

OpenCode Zen

OpenCode 官方提供的精选模型服务：

{
  "provider": "opencode-zen"
}

首次使用需要注册 OpenCode 账号。

AWS Bedrock

export AWS_REGION=us-west-2
export AWS_ACCESS_KEY_ID=xxx
export AWS_SECRET_ACCESS_KEY=xxx
# 配置
{
  "provider": "bedrock",
  "model": "anthropic.claude-3-sonnet-20240229-v1:0"
}

Google Vertex AI

export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
export GOOGLE_CLOUD_PROJECT=your-project
# 配置
{
  "provider": "vertex",
  "model": "claude-sonnet-4-20250514",
  "location": "us-east5"
}

Azure OpenAI

export AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com
export AZURE_OPENAI_API_KEY=xxx
# 配置
{
  "provider": "azure",
  "model": "gpt-4",
  "deployment": "your-deployment"
}

本地模型

Ollama

1. 安装 Ollama：curl -fsSL https://ollama.ai/install.sh | sh

2. 下载模型：

ollama pull llama3.1
ollama pull codellama

3. 配置 OpenCode：

{
  "provider": "ollama",
  "model": "llama3.1",
  "baseUrl": "http://localhost:11434"
}

LM Studio

1. 下载并安装 LM Studio

2. 下载模型并启动本地服务器

3. 配置 OpenCode：

{
  "provider": "openai",
  "baseUrl": "http://localhost:1234/v1",
  "model": "local-model"
}

运行时切换模型

在 OpenCode 中可以使用 /models 命令快速切换：

> /models

可用模型：
1. claude-sonnet-4-20250514 (anthropic)
2. gpt-4-turbo (openai)
3. llama3.1 (ollama)

选择 [1-3]:

API Key 管理

使用环境变量文件

创建 ~/.config/opencode/.env：

ANTHROPIC_API_KEY=sk-ant-xxx
OPENAI_API_KEY=sk-xxx
AWS_ACCESS_KEY_ID=xxx
AWS_SECRET_ACCESS_KEY=xxx

使用密钥管理工具

推荐使用 1Password、Bitwarden 等工具管理 API Key，通过 CLI 注入：

# 1Password CLI
eval $(op signin)
export ANTHROPIC_API_KEY=$(op read "op://Private/Anthropic/api-key")
opencode

成本优化建议

  1. 选择合适的模型：简单任务用小模型，复杂任务用大模型
  2. 使用 /compact：定期压缩对话历史，减少 token 消耗
  3. 本地模型：对于隐私敏感或频繁使用的场景，考虑本地模型
  4. 缓存：OpenCode 会自动缓存相同的请求

故障排查

问题解决方案
API Key 无效检查环境变量是否正确设置
连接超时检查网络，考虑使用代理
模型不可用确认模型名称正确，检查 Provider 状态
配额不足查看 Provider 控制台，充值或升级