opencode
Skonfiguruj własnego dostawcę Chat Completions.
Test zaliczony
2026-10-10. test tekstowy w Windows przez lokalną bramkę z odpowiedziami syntetycznymi. opencode 1.18.35.
opencode to agent programistyczny z konfigurowalnym katalogiem dostawców. Pakiet @ai-sdk/openai-compatible obsługuje POST /v1/chat/completions.
Zanim zaczniesz
Przejdź szybki start: dodaj kredyty, utwórz klucz i skopiuj identyfikator modelu z Marketplace. Do pracy agenta wybierz model obsługujący narzędzia. Przykładowy identyfikator to claude-sonnet-5-5; zastąp go wybranym modelem. Zainstaluj opencode i przejdź do katalogu projektu.
Skonfiguruj narzędzie
Ustaw klucz w terminalu.
export UNUSED_API_KEY='sk-unused-...'
export UNUSED_MODEL='claude-sonnet-5-5'Utwórz opencode.json w katalogu projektu na macOS, Linux lub Windows. Zmień jednocześnie klucz w mapie modeli i wybrany model.
{
"$schema": "https://opencode.ai/config.json",
"model": "unused/claude-sonnet-5-5",
"provider": {
"unused": {
"npm": "@ai-sdk/openai-compatible",
"name": "unused.market",
"options": {
"baseURL": "https://unused.market/v1",
"apiKey": "{env:UNUSED_API_KEY}"
},
"models": {
"claude-sonnet-5-5": {
"name": "claude-sonnet-5-5",
"limit": { "context": 32000, "output": 4096 }
}
}
}
}
}Prefiks unused/ jest lokalną nazwą dostawcy. Żądanie używa kanonicznego identyfikatora modelu po tym prefiksie. Uruchom opencode, a następnie wybierz model poleceniem /models.
Przykład wybiera budżet 32000 tokenów kontekstu i 4096 tokenów odpowiedzi. Dopasuj je do oferty; nie określają maksymalnych możliwości modelu.
Sprawdź połączenie
Poproś: „Say hello in one sentence without using tools.” Następnie otwórz Analytics → Requests. Znajdź nowe żądanie po czasie i modelu. Odpowiedź oraz pasujący wpis potwierdzają, że ruch trafił na Twoje konto. To test połączenia, a nie jakości zmian w repozytorium.
Ograniczenia i rozwiązywanie problemów
Zachowaj @ai-sdk/openai-compatible: dostawca @ai-sdk/openai może używać Responses, którego bramka nie udostępnia. Zanim zwiększysz przykładowy budżet kontekstu, sprawdź kontekst modelu widoczny w Marketplace. Obecny panel nie pokazuje limitu wyjścia każdej oferty; zmniejsz przykładowy budżet 4096, jeśli brama zwróci błąd limitu wyjścia.
| Objaw | Rozwiązanie |
|---|---|
| Błąd uwierzytelniania | Wprowadź ponownie klucz unused.market. |
| Brak dostępnej oferty | Sprawdź Marketplace, Routing i modele dozwolone dla klucza. |
| Błąd kredytów lub budżetu | Sprawdź Credits i miesięczny limit klucza; w razie potrzeby zmniejsz budżet odpowiedzi. |
| Strumień urywa się po rozpoczęciu odpowiedzi | Znajdź przyczynę w Requests. Rozpoczęty strumień nie jest ponawiany na innej ofercie. |
Źródła i weryfikacja
Sprawdzona wersja: 1.18.35, 2026-10-10. Oficjalne źródła: własny dostawca, konfiguracja.