2.2 AI提供商配置

OpenCode支持75+个LLM提供商,通过AI SDK和Models.dev集成,让你可以选择最适合的模型进行开发。

配置流程

  1. 使用 /connect 命令添加API密钥
  2. opencode.json 中配置提供商选项
  3. 使用 /models 命令选择要使用的模型

认证信息存储在 ~/.local/share/opencode/auth.json 文件中。

主要提供商

商业平台

提供商 主要模型 说明
Anthropic Claude 4 Opus, Claude 4 Sonnet 推荐使用,代码能力强
OpenAI GPT-5, GPT-4o 通用能力强
Google Gemini 3 Pro 多模态支持好
Amazon Bedrock 多种模型 AWS集成
Azure OpenAI GPT系列 企业级支持

专业AI服务

  • Groq - 超快推理速度
  • DeepSeek - 高性价比
  • xAI - Grok系列模型
  • Together AI - 开源模型托管
  • Fireworks AI - 快速推理
  • OpenRouter - 统一API网关

本地模型

  • Ollama - 本地模型运行
  • LM Studio - 桌面模型管理
  • llama.cpp - 高性能本地推理

使用 /connect 命令

在OpenCode TUI中运行 /connect 命令,会显示提供商列表:

/connect

选择提供商后,根据提示输入API密钥。

推荐
新手推荐使用 OpenCode Zen,通过 opencode.ai/auth 认证即可使用,无需单独配置API密钥。

提供商配置示例

Anthropic配置

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-20250514",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.anthropic.com/v1"
      }
    }
  }
}

OpenAI配置

{
  "model": "openai/gpt-4o",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://api.openai.com/v1"
      }
    }
  }
}

Azure OpenAI配置

{
  "model": "azure/gpt-4o",
  "provider": {
    "azure": {
      "options": {
        "baseURL": "https://your-resource.openai.azure.com",
        "apiVersion": "2024-02-15-preview"
      }
    }
  }
}

Ollama本地配置

{
  "model": "ollama/llama3.2",
  "provider": {
    "ollama": {
      "options": {
        "baseURL": "http://localhost:11434"
      }
    }
  }
}

自定义提供商

OpenCode支持任何兼容OpenAI API的提供商:

{
  "provider": {
    "custom": {
      "id": "my-provider",
      "options": {
        "baseURL": "https://api.my-provider.com/v1",
        "apiKey": "{env:MY_PROVIDER_API_KEY}"
      },
      "models": {
        "my-model": {
          "id": "my-model-v1",
          "name": "My Custom Model"
        }
      }
    }
  }
}

认证方式

认证方式 适用提供商 说明
API密钥 大多数提供商 最常见的认证方式
OAuth GitHub Copilot, GitLab 浏览器授权
环境变量 AWS, Google Cloud 云服务认证
服务账户 Google Vertex AI JSON密钥文件

管理提供商

禁用提供商

{
  "disabled_providers": ["openai", "google"]
}

只启用特定提供商

{
  "enabled_providers": ["anthropic", "ollama"]
}

查看可用模型

使用CLI命令查看所有可用模型:

opencode models

或指定提供商:

opencode models anthropic
安全提示
不要将API密钥直接写入配置文件。使用环境变量或 /connect 命令管理密钥更安全。

下一步

配置好提供商后,接下来让我们了解如何选择和配置具体的模型。