Провайдеры

OpenCode поддерживает более 75 LLM-провайдеров через AI SDK и Models.dev, обеспечивая интеграцию с многочисленными сервисами языковых моделей и локальными моделями.

Процесс настройки

Добавьте API-ключи с помощью команды /connect
Настройте провайдера в конфигурации OpenCode
Учётные данные сохраняются в ~/.local/share/opencode/auth.json

Каталог

Краткий справочник поддерживаемых провайдеров:

Провайдер	Метод настройки	Основные возможности
Anthropic	OAuth или API-ключ	Поддержка Claude Pro/Max
OpenAI	ChatGPT Plus/Pro или API-ключ	Модели GPT-4o, o1
GitHub Copilot	Аутентификация по коду устройства	Модели подписки Pro+
Google Vertex AI	Сервисный аккаунт или аутентификация gcloud	40+ моделей
Amazon Bedrock	Учётные данные/профиль AWS	Поддержка VPC-эндпоинтов
Azure OpenAI	API-ключ + имя ресурса	Пользовательские развёртывания
Groq	API-ключ	Высокоскоростной инференс
DeepSeek	API-ключ	Модели рассуждений
OpenRouter	API-ключ	Мульти-провайдерная маршрутизация
GitLab Duo	API-ключ	Интеграция с GitLab
Ollama	Локальная настройка	Запуск моделей локально
LM Studio	Локальная настройка	Управление локальными моделями

Дополнительные провайдеры: 302.AI, Baseten, Cerebras, Cloudflare AI Gateway, Cortecs, Deep Infra, Firmware, Fireworks AI, Hugging Face, Helicone, IO.NET, Moonshot AI, MiniMax, Nebius Token Factory, OVHcloud AI Endpoints, SAP AI Core, Scaleway, Together AI, Venice AI, Vercel AI Gateway, xAI, Z.AI, ZenMux.

Настройка базового URL

Вы можете настроить базовый URL для любого провайдера, установив опцию baseURL. Это полезно при использовании прокси-сервисов или пользовательских эндпоинтов.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.anthropic.com/v1"
      }
    }
  }
}

OpenCode Zen

OpenCode Zen - это список моделей от команды OpenCode, которые были протестированы и проверены на хорошую работу.

Запустите /connect, выберите opencode
Посетите opencode.ai/auth для аутентификации
Скопируйте и вставьте ваш API-ключ
Используйте /models для просмотра рекомендуемых моделей

Популярные провайдеры

Anthropic

Запустите /connect и выберите Anthropic
Выберите Claude Pro/Max для аутентификации через браузер
Доступ к моделям через команду /models

OpenAI

Создайте API-ключ на platform.openai.com/api-keys
Запустите /connect и найдите OpenAI
Введите API-ключ
Выберите модель через /models

Groq

Groq обеспечивает высокоскоростной инференс для различных моделей.

Создайте API-ключ на console.groq.com
Запустите /connect и найдите Groq
Введите API-ключ
Выберите модель через /models

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "groq": {
      "options": {
        "apiKey": "{env:GROQ_API_KEY}"
      }
    }
  }
}

DeepSeek

DeepSeek предлагает мощные модели рассуждений.

Создайте API-ключ на platform.deepseek.com
Запустите /connect и найдите DeepSeek
Введите API-ключ
Выберите модель через /models

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "deepseek": {
      "options": {
        "apiKey": "{env:DEEPSEEK_API_KEY}"
      }
    }
  }
}

GitHub Copilot

Интеграция GitHub Copilot требует подписки Pro+.

Запустите /connect и выберите GitHub Copilot
Завершите аутентификацию по коду устройства
Доступ к моделям через команду /models

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "github-copilot": {
      "models": {
        "gpt-4o": {
          "name": "GPT-4o (Copilot)"
        }
      }
    }
  }
}

GitLab Duo

GitLab Duo предоставляет ИИ-функции, интегрированные с GitLab.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "gitlab-duo": {
      "options": {
        "apiKey": "{env:GITLAB_API_KEY}"
      }
    }
  }
}

OpenRouter

{
  "provider": {
    "openrouter": {
      "models": {
        "moonshotai/kimi-k2": {
          "options": {
            "provider": {
              "order": ["baseten"],
              "allow_fallbacks": false
            }
          }
        }
      }
    }
  }
}

Ollama (локально)

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

LM Studio (локально)

{
  "provider": {
    "lmstudio": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LM Studio (local)",
      "options": {
        "baseURL": "http://127.0.0.1:1234/v1"
      },
      "models": {
        "google/gemma-3n-e4b": {
          "name": "Gemma 3n-e4b (local)"
        }
      }
    }
  }
}

Amazon Bedrock

{
  "provider": {
    "amazon-bedrock": {
      "options": {
        "region": "us-east-1",
        "profile": "my-aws-profile"
      }
    }
  }
}

Приоритет аутентификации

При использовании Amazon Bedrock аутентификация следует этому порядку приоритета:

Bearer Token - Если установлен AWS_BEARER_TOKEN_BEDROCK (через /connect или переменную окружения), он имеет приоритет над всеми другими методами
Цепочка учётных данных AWS - Стандартное разрешение учётных данных AWS:
- Конфигурация профиля AWS
- Ключи доступа (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY)
- Роли IAM
- EKS IRSA (роли IAM для сервисных аккаунтов)

Azure OpenAI

Создайте ресурс Azure OpenAI в портале Azure
Разверните модель в Azure AI Foundry
Запустите /connect и найдите Azure
Установите переменную окружения AZURE_RESOURCE_NAME

Настройка пользовательского провайдера

Для OpenAI-совместимых провайдеров:

{
  "provider": {
    "myprovider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "My AI Provider",
      "options": {
        "baseURL": "https://api.myprovider.com/v1",
        "apiKey": "{env:MY_API_KEY}"
      },
      "models": {
        "my-model": {
          "name": "My Model",
          "limit": {
            "context": 200000,
            "output": 65536
          }
        }
      }
    }
  }
}

Синтаксис переменных окружения

Используйте синтаксис {env:VARIABLE_NAME} для ссылки на переменные окружения в вашей конфигурации:

{
  "provider": {
    "myprovider": {
      "options": {
        "apiKey": "{env:MY_PROVIDER_API_KEY}"
      }
    }
  }
}

Это позволяет хранить конфиденциальные учётные данные вне файлов конфигурации.

Лимиты модели

Поля limit помогают OpenCode понять контекстное окно и лимиты вывода ваших моделей:

{
  "provider": {
    "myprovider": {
      "models": {
        "my-model": {
          "name": "My Model",
          "limit": {
            "context": 200000,
            "output": 65536
          }
        }
      }
    }
  }
}

context: Максимальное количество входных токенов, которые модель может обработать
output: Максимальное количество выходных токенов, которые модель может сгенерировать

Пользовательские заголовки

Вы можете добавить пользовательские заголовки к API-запросам:

{
  "provider": {
    "myprovider": {
      "options": {
        "headers": {
          "Authorization": "Bearer custom-token",
          "X-Custom-Header": "value"
        }
      }
    }
  }
}

Устранение неполадок

Проверьте аутентификацию: Запустите opencode auth list для проверки учётных данных
Проблемы с пользовательским провайдером:
- Убедитесь, что ID провайдера совпадает между /connect и конфигурацией
- Подтвердите правильный npm-пакет
- Проверьте API-эндпоинт в options.baseURL

Конфигурация Сеть