Provider 配置完全指南

Provider 是 Opencode 连接 AI 模型的桥梁。正确配置 Provider 能让你充分发挥 Opencode 的能力，本指南将带你从零开始掌握各种 Provider 的配置方法。

什么是 Provider？

Provider 就是 AI 模型的"提供商"。Opencode 支持 75+ 种 Provider，包括：

  • 官方订阅服务：Claude Pro/Max、ChatGPT Plus/Pro
  • API 服务：DeepSeek、OpenRouter、Groq
  • 本地模型：Ollama、LM Studio
  • 企业级服务：AWS Bedrock、Azure OpenAI、Google Vertex AI

快速开始：Opencode Zen

如果你是新手，最简单的方式是使用 Opencode Zen —— 官方提供的托管服务：

  1. 在 Opencode 中运行 /connect 命令
  2. 选择 Opencode 作为 Provider
  3. 访问 https://opencode.ai/auth 创建 API Key
  4. 将 API Key 粘贴到 Opencode 中
  5. 运行 /models 查看可用模型

这种方式无需复杂配置，适合快速体验。

使用现有订阅：Claude Pro/Max

如果你已经订阅了 Claude Pro 或 Claude Max，可以直接使用订阅账号，无需额外购买 API：

配置步骤

  1. 运行命令：
opencode auth login

  1. 选择 Anthropic 作为 Provider

  2. 选择登录方式：Claude Pro/Max

  3. 在浏览器中完成 OAuth 认证

  4. 返回 Opencode，运行 /models 确认模型已加载

可用模型

  • anthropic/claude-sonnet-4-5 - 最新的 Sonnet 模型
  • anthropic/claude-opus-4-5 - 最强推理能力
  • anthropic/claude-haiku-4-5 - 快速响应

使用 ChatGPT Plus/Pro 订阅

ChatGPT Plus 或 Pro 用户也可以直接使用订阅：

前置要求

需要安装 Opencode 的 OpenAI 认证插件。编辑配置文件 ~/.config/opencode/opencode.json：

{
  "plugin": [
    "opencode-openai-codex-auth@latest"
  ]
}

配置步骤

  1. 重启 Opencode 让插件生效

  2. 运行：

opencode auth login

  1. 选择 OpenAI 作为 Provider

  2. 选择 ChatGPT Plus/Pro (Codex Subscription)

  3. 在浏览器中登录你的 OpenAI 账号

可用模型

  • openai/gpt-5.2 - 最新旗舰模型
  • openai/gpt-5.2-codex - 专为编程优化
  • openai/gpt-5.1-codex-max - 最大上下文窗口

本地模型：Ollama

想要完全免费且保护隐私？Ollama 是最佳选择。

安装 Ollama

访问 ollama.ai 下载并安装，然后启动服务：

ollama serve

下载模型

# 下载 Llama 3
ollama pull llama3

# 下载 DeepSeek Coder（推荐用于编程）
ollama pull deepseek-coder

# 下载 Qwen Coder
ollama pull qwen2.5-coder

配置 Opencode

编辑 ~/.config/opencode/opencode.json：

{
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (本地)",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      },
      "models": {
        "deepseek-coder": {
          "name": "DeepSeek Coder",
          "contextWindow": 16384
        },
        "llama3": {
          "name": "Llama 3",
          "contextWindow": 8192
        }
      }
    }
  }
}

重启 Opencode，运行 /models 即可看到本地模型。

性价比之选：DeepSeek API

DeepSeek 提供极具性价比的 API 服务，价格远低于 OpenAI。

获取 API Key

  1. 访问 platform.deepseek.com
  2. 注册并充值（最低 10 元）
  3. 创建 API Key

配置方法

在 Opencode 中运行 /connect：

  1. 选择 DeepSeek 作为 Provider
  2. 输入你的 API Key
  3. 完成配置

推荐模型

  • deepseek-chat - 通用对话模型
  • deepseek-coder - 专为编程优化

多 Provider 策略

生产环境推荐配置多个 Provider，实现分工协作：

角色Provider模型用途
主力Claude ProOpus 4.5复杂任务、架构设计
快手DeepSeekdeepseek-coder简单修改、代码补全
本地Ollamallama3隐私敏感任务

在 opencode.json 中配置：

{
  "model": "anthropic/claude-opus-4-5",
  "small_model": "deepseek/deepseek-coder",
  "enabled_providers": ["anthropic", "deepseek", "ollama"]
}

Opencode 会根据任务复杂度自动选择合适的模型。

常见问题

Q: 如何切换 Provider？

运行 /models 命令，选择想要使用的模型即可。

Q: 可以同时使用多个 Provider 吗？

可以。Opencode 支持配置多个 Provider，并可以为不同的 Agent 指定不同的模型。

Q: 本地模型性能如何？

对于简单任务，DeepSeek Coder 等本地模型表现出色。但复杂的架构设计任务，建议使用 Claude Opus 等大型模型。

Q: API 费用如何计算？

不同 Provider 计费方式不同：

  • Claude Pro/ChatGPT Plus：按月订阅，无额外费用
  • DeepSeek API：按 token 计费，约 ¥0.001/1K tokens
  • Ollama：完全免费

下一步

本文由 OpenCodex 社区整理，如有疑问欢迎在 GitHub 提 Issue。

最近更新: