OpenCode

OpenCode kieruje modele Anthropic i OpenAI przez dostawców podłączanych jak wtyczki. Wskaż blokiem anthropic OneProvider i gotowe.

Konfiguracja

Ścieżka konfiguracji: ~/.config/opencode/opencode.json (lub opencode.jsonc). Jeśli plik nie istnieje, utwórz go.

{
"provider": {
"anthropic": {
"options": {
"baseURL": "https://api.oneprovider.dev/v1",
"apiKey": "sk-your-key-here"
},
"npm": "@ai-sdk/anthropic"
}
},
"$schema": "https://opencode.ai/config.json"
}

Klucz API można wpisać bezpośrednio (jak wyżej) albo trzymać poza plikiem: polecenie /connect w OpenCode (lub opencode auth login w terminalu) zapisuje go osobno (w wersji 1.x to ~/.local/share/opencode/auth.json), a w konfiguracji zostaje tylko baseURL.

Prostsze sposoby

• Dla projektu. Umieść ten sam JSON w opencode.json w katalogu głównym projektu: obowiązuje tylko tam i jest scalany z plikiem globalnym.
• Klucz ze zmiennej środowiskowej. Wpisz "apiKey": "{env:ONEPROVIDER_KEY}" i wykonaj export ONEPROVIDER_KEY=sk-your-key-here. Plik nie zawiera sekretu i można go commitować. Jeśli zmienna nie jest ustawiona, podstawiany jest pusty ciąg.

Zdalna maszyna, CI, kontener

Nie trzeba kopiować ~/.config przez SSH. Trzymaj w repozytorium opencode.json z {env:ONEPROVIDER_KEY} i ustaw ONEPROVIDER_KEY na tej maszynie (sekret CI, docker run -e, export). W OpenCode 1.x można też przekazać całą konfigurację jedną zmienną, OPENCODE_CONFIG_CONTENT: JSON inline, stosowany po wszystkich plikach konfiguracji, nic nie jest zapisywane na dysku. OPENCODE_CONFIG=/path/to/config.json wskazuje plik konfiguracji w innym miejscu.

export OPENCODE_CONFIG_CONTENT='{"provider":{"anthropic":{"npm":"@ai-sdk/anthropic","options":{"baseURL":"https://api.oneprovider.dev/v1","apiKey":"sk-your-key-here"}}}}'
opencode

OpenCode 1.x i OpenCode 2

Sprawdź wersję poleceniem opencode --version: numer zaczyna się od 1 ( OpenCode 1.x , to instalator daje domyślnie) lub od 2 ( OpenCode 2 ). Konfiguracja na tej stronie jest w formacie 1.x (provider, npm, options), a OpenCode 2 odczytuje ją bez zmian z tych samych miejsc. Natywny format 2 jest opcjonalny; zapisuje te same ustawienia jako providers, package, settings:

{
"providers": {
"anthropic": {
"package": "aisdk:@ai-sdk/anthropic",
"settings": { "baseURL": "https://api.oneprovider.dev/v1", "apiKey": "sk-your-key-here" }
},
"openai": {
"package": "aisdk:@ai-sdk/openai",
"settings": { "baseURL": "https://api.oneprovider.dev/v1", "apiKey": "sk-your-key-here" }
}
}
}

Nie wskazuj OpenCode 1.x pliku przepisanego do formatu 2: obie wersje czytają te same pliki. OPENCODE_CONFIG i OPENCODE_CONFIG_CONTENT są udokumentowane dla 1.x; w OpenCode 2 użyj opencode.json w projekcie i zmiennej ONEPROVIDER_KEY na zdalnej maszynie.

Kierowanie także modeli gpt-*

Ten sam klucz działa też z modelami GPT — dodaj drugi blok dostawcy. Oba są w tym samym pliku; model wybierasz jako provider/model-id.

{
"provider": {
"anthropic": { "options": { "baseURL": "https://api.oneprovider.dev/v1", "apiKey": "sk-your-key-here" }, "npm": "@ai-sdk/anthropic" },
"openai": { "options": { "baseURL": "https://api.oneprovider.dev/v1", "apiKey": "sk-your-key-here" }, "npm": "@ai-sdk/openai" }
}
}

Jaki model wybrać

Użyj anthropic/claude-sonnet-5-5 jako modelu na co dzień: zrównoważona cena i jakość. Przełącz na anthropic/claude-opus-5-5 przy pracy nad architekturą i dużych refaktoryzacjach, a anthropic/claude-haiku-5-5 tam, gdzie szybkość jest ważniejsza niż głębia. Dla modeli GPT użyj bloku openai: openai/gpt-6.1-terra to zrównoważony wybór domyślny, openai/gpt-6.1-sol to poziom frontier. Otwórz /models, żeby wybrać model; tani model pasuje też do ustawienia small_model w OpenCode, używanego do tytułów i krótkich zadań. ID są na stronie modeli , stawki na stronie cennika .

Częste błędy i rozwiązania

404 „The requested API endpoint does not exist”

W OpenCode dostawca @ai-sdk/anthropic oczekuje baseURL z /v1: https://api.oneprovider.dev/v1. Nie dopisuj /messages samodzielnie i nie używaj tu samego hosta.

401 Invalid API key

Klucz w konfiguracji jest obcięty lub ujęty w cudzysłowy. Możesz też wykonać /connect i wkleić go tam (OpenCode 1.x trzyma go w ~/.local/share/opencode/auth.json); wtedy usuń apiKey z konfiguracji.

Konfiguracja się nie ładuje

„Drukarskie” cudzysłowy z komunikatora lub Notion psują JSON. Sprawdź plik poleceniem jq . ~/.config/opencode/opencode.json albo użyj opencode.jsonc, jeśli chcesz komentarze.

Modelu nie ma na liście

Wybierz go dokładnie jako provider/model-id, na przykład anthropic/claude-sonnet-5-5, i upewnij się, że odpowiedni blok dostawcy istnieje w pliku.

429 „Insufficient balance”

Saldo lub limit wydatków klucza został wyczerpany. Doładuj saldo w Panelu; ponawianie nie pomoże.

Strumienie się urywają

Wyłącz VPN lub proxy VLESS: buforują SSE i psują HTTP/2.

FAQ

Gdzie jest plik konfiguracji?

~/.config/opencode/opencode.json (lub opencode.jsonc). Projekt może mieć też własny opencode.json.

Jak trzymać klucz poza plikiem?

OpenCode podstawia zmienne środowiskowe: wpisz "apiKey": "{env:ONEPROVIDER_KEY}" i wyeksportuj zmienną w powłoce.

Jak użyć tego na zdalnej maszynie lub w CI?

Bez kopiowania plików przez SSH: trzymaj w repozytorium opencode.json z {env:ONEPROVIDER_KEY} i ustaw ONEPROVIDER_KEY na tej maszynie albo (OpenCode 1.x) przekaż całą konfigurację w zmiennej OPENCODE_CONFIG_CONTENT. Zobacz „Zdalna maszyna, CI, kontener” powyżej.

Czy mogę używać jednocześnie Claude i GPT?

Tak. Dodaj blok openai z tej strony obok bloku anthropic; jeden klucz działa z obydwoma.

Czy potrzebuję konta Claude lub OpenAI?

Nie, jedynym poświadczeniem jest klucz OneProvider.

Szybkie odpowiedzi

Jakiego base URL użyć?

Claude Code i SDK Anthropic używają https://api.oneprovider.dev. SDK OpenAI i klienty zgodne z OpenAI używają https://api.oneprovider.dev/v1. Jeden klucz działa przy obu; lista modeli jest na stronie modeli , a stawki na stronie cennika .

Jak się uwierzytelnić?

Wyślij surowy klucz sk-… w x-api-key albo Authorization: Bearer: w jednym z nich, nigdy w obu. Trzymaj klucz w zmiennej środowiskowej, a nie w pliku, który trafia do repozytorium. Więcej o uwierzytelnianiu .

Skąd wziąć klucz?

Otwórz swój Panel w bocie Telegram @oneprovider_robot lub na app.oneprovider.dev, doładuj saldo i naciśnij „Utwórz klucz”. Każdy klucz może mieć własny limit wydatków. Panel i klucze API .

Co oznaczają 401, 404 i 429?

401: klucza brakuje, jest błędnie wpisany albo wysłany w złym nagłówku; wklej cały klucz bez cudzysłowów i spacji. 404: zwykle zły base URL, na przykład brakujące lub podwojone /v1. 429 z komunikatem „Insufficient balance”: saldo Panelu lub limit wydatków klucza się wyczerpał, więc doładuj zamiast ponawiać; każde inne 429 to limit zapytań, więc poczekaj zgodnie z Retry-After. Szczegóły: kody błędów i rozwiązywanie problemów .

Dlaczego strumienie się urywają lub resetują?

VPN i proxy VLESS często buforują SSE albo zrywają negocjację HTTP/2. OneProvider nie ma ograniczeń regionalnych i nie buforuje strumieni, więc wyłącz proxy i spróbuj ponownie.

Gdzie pytać, jeśli to nie wystarcza?

Napisz do @Oneproviderhelpbot w Telegramie albo otwórz „Wsparcie” w Panelu w przeglądarce, podając kod statusu HTTP i dokładny komunikat błędu. Jak działa wsparcie .