dokumentacja
Agenci w terminalu

opencode

Markdown

Agent w terminalu · OpenAI Chat

Pełny przewodnik
FormatGdzie skonfigurować
OpenAI Chatopencode.json (w projekcie lub ~/.config/opencode/opencode.json) → provider.<id>; klucz — przez /connect lub "apiKey": "{env:VAR}"

Konfiguracja

Skopiuj konfigurację i zastąp sk-... własnym kluczem z panelu Ailoot. Najlepiej przechowywać klucz w zmiennej środowiskowej AILOOT_API_KEY, jeśli aplikacja to obsługuje.

Przed uruchomieniem wywołaj GET /v1/models ze swoim kluczem Ailoot. Wybierz dokładny identyfikator modelu, którego metody obejmują POST /v1/chat/completions, i użyj go w konfiguracji. Dla agentów sprawdź także obsługę narzędzi i funkcje wymagane przez twoją wersję klienta.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "ailoot/claude-sonnet-5-5",
  "provider": {
    "ailoot": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ailoot",
      "options": {
        "baseURL": "https://api.ailoot.ai/v1",
        "apiKey": "{env:AILOOT_API_KEY}"
      },
      "models": {
        "claude-sonnet-5-5": {
          "name": "Claude Sonnet 5.5"
        },
        "gpt-6.1-sol": {
          "name": "GPT-6.1 Sol"
        },
        "deepseek-v4-pro": {
          "name": "DeepSeek V4 Pro"
        }
      }
    }
  }
}

Ta konfiguracja odczytuje klucz ze zmiennej AILOOT_API_KEY. Ustaw ją przed uruchomieniem aplikacji:

export AILOOT_API_KEY="sk-..."   # dodaj do ~/.zshrc lub ~/.bashrc

Przykładowy model: claude-sonnet-5-5. Inne modele wybieraj z katalogu — sprawdź, czy model obsługuje wymagany format.

Warto wiedzieć

Sprawdzenie

  • Adres dla formatu OpenAI — https://api.ailoot.ai/v1 (lub pełna ścieżka, jeśli aplikacja wymaga pełnego adresu).
  • Zadaj krótkie pytanie. Jeśli otrzymasz błąd, sprawdź kod i Request ID, a następnie zajrzyj na stronę Błędy i limity.
  • 404 bezpośrednio po konfiguracji niemal zawsze oznacza błędny adres: nadmiarowe lub brakujące /v1.
  • 402 — saldo nie wystarcza na rezerwę. Agenci rezerwują więcej niż czat: dlaczego.

Dokumentacja aplikacji: https://opencode.ai/docs/providers/

Dodatkowe pytania? Prześlij Request ID i opis — pomożemy wyjaśnić sprawę.Napisz do wsparcia