Skip to content

Provajderi

Korištenje bilo kojeg LLM provajdera u OpenCode.

OpenCode koristi AI SDK i Models.dev za podršku 75+ LLM provajdera i podržava pokretanje lokalnih modela.

Za dodavanje provajdera potrebno je:

  1. Dodajte API ključeve za provajdera koristeći naredbu /connect.
  2. Konfigurirajte dobavljača u vašoj OpenCode konfiguraciji.

Akreditacije

Kada dodate API ključeve dobavljača sa naredbom /connect, oni se pohranjuju u ~/.local/share/opencode/auth.json.


Config

Možete prilagoditi dobavljače putem odjeljka provider u vašem OpenCode config.


Osnovni URL

Možete prilagoditi osnovni URL za bilo kojeg provajdera postavljanjem opcije baseURL. Ovo je korisno kada koristite proxy usluge ili prilagođene krajnje tačke.

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

OpenCode Zen

OpenCode Zen je lista modela koje je obezbedio OpenCode tim koji su bili testirano i potvrđeno da dobro radi sa OpenCode. Saznajte više.

  1. Pokrenite naredbu /connect u TUI-u, odaberite opencode i idite na opencode.ai/auth.
/connect
  1. Prijavite se, dodajte svoje detalje naplate i kopirajte svoj API ključ.

  2. Zalijepite svoj API ključ.

┌ API key
└ enter
  1. Pokrenite /models u TUI da vidite listu modela koje preporučujemo.
/models

Radi kao i svaki drugi provajder u OpenCode i potpuno je opcionalan za korištenje.


Directory

Pogledajmo neke od provajdera detaljno. Ako želite dodati provajdera na listu, slobodno otvori PR.


302.AI

  1. Idite na 302.AI konzolu, kreirajte račun i generirajte API ključ.

  2. Pokrenite naredbu /connect i potražite 302.AI.

/connect
  1. Unesite svoj 302.AI API ključ.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete model.
/models

Amazon Bedrock

Da biste koristili Amazon Bedrock s OpenCode:

  1. Idite na Katalog modela na Amazon Bedrock konzoli i zatražite pristup modelima koje želite.

  2. Konfigurirajte autentifikaciju koristeći jedan od sljedećih metoda:

    Varijable okruženja (brzi početak)

    Postavite jednu od ovih varijabli okruženja dok pokrećete opencode:

Terminal window
# Option 1: Using AWS access keys
AWS_ACCESS_KEY_ID=XXX AWS_SECRET_ACCESS_KEY=YYY opencode
# Option 2: Using named AWS profile
AWS_PROFILE=my-profile opencode
# Option 3: Using Bedrock bearer token
AWS_BEARER_TOKEN_BEDROCK=XXX opencode

Ili ih dodajte na svoj bash profil:

~/.bash_profile
export AWS_PROFILE=my-dev-profile
export AWS_REGION=us-east-1

Konfiguracijski fajl (preporučeno)

Za konfiguraciju specifičnu za projekat ili trajnu konfiguraciju, koristite opencode.json:

opencode.json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"amazon-bedrock": {
"options": {
"region": "us-east-1",
"profile": "my-aws-profile"
}
}
}
}

Dostupne opcije:

  • region - ​​AWS regija (npr. us-east-1, eu-west-1)
  • profile - ​​AWS je imenovao profil od ~/.aws/credentials
  • endpoint - ​​URL prilagođene krajnje tačke za VPC krajnje tačke (pseudonim za generičku opciju baseURL)

Napredno: VPC krajnje tačke

Ako koristite VPC krajnje tačke za Bedrock:

opencode.json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"amazon-bedrock": {
"options": {
"region": "us-east-1",
"profile": "production",
"endpoint": "https://bedrock-runtime.us-east-1.vpce-xxxxx.amazonaws.com"
}
}
}
}

Metode provjere autentičnosti

  • AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY: Kreirajte IAM korisnika i generirajte pristupne ključeve u AWS konzoli
  • AWS_PROFILE: Koristite imenovane profile od ~/.aws/credentials. Prvo konfigurirajte sa aws configure --profile my-profile ili aws sso login
  • AWS_BEARER_TOKEN_BEDROCK: Generirajte dugoročne API ključeve sa Amazon Bedrock konzole
  • AWS_WEB_IDENTITY_TOKEN_FILE / AWS_ROLE_ARN: Za EKS IRSA (IAM uloge za servisne naloge) ili druga Kubernetes okruženja sa OIDC federacijom. Kubernetes automatski ubacuje ove varijable okruženja kada se koriste napomene naloga usluge.

Prioritet autentifikacije

Amazon Bedrock koristi sljedeći prioritet autentifikacije:

  1. Token nosioca - AWS_BEARER_TOKEN_BEDROCK varijabla okruženja ili token iz naredbe /connect
  2. AWS lanac vjerodajnica - profil, pristupni ključevi, dijeljeni vjerodajnici, IAM uloge, tokeni web identiteta (EKS IRSA), metapodaci instance
  1. Pokrenite naredbu /models da odaberete model koji želite.
/models

Anthropic

  1. Nakon što ste se prijavili, pokrenite naredbu /connect i odaberite Anthropic.
/connect
  1. Ovdje možete odabrati opciju Claude Pro/Max i ona će otvoriti vaš pretraživač i traži od vas da se autentifikujete.
┌ Select auth method
│ Claude Pro/Max
│ Create an API Key
│ Manually enter API Key
  1. Sada bi svi Anthropic modeli trebali biti dostupni kada koristite naredbu /models.
/models

[Anthropic] (https://anthropic.com) službeno ne podržava korištenje vaše Claude Pro/Max pretplate u OpenCode.

Korištenje API ključeva

Također možete odabrati Kreiraj API ključ ako nemate Pro/Max pretplatu. Također će otvoriti vaš pretraživač i zatražiti od vas da se prijavite na Anthropic i dati vam kod koji možete zalijepiti u svoj terminal.

Ili ako već imate API ključ, možete odabrati Ručno unesite API ključ i zalijepite ga u svoj terminal.


Azure OpenAI

  1. Idite na Azure portal i kreirajte Azure OpenAI resurs. trebat će vam:

    • Naziv resursa: Ovo postaje dio vaše krajnje tačke API-ja (https://RESOURCE_NAME.openai.azure.com/)
    • API ključ: Ili KEY 1 ili KEY 2 sa vašeg izvora
  2. Idite na Azure AI Foundry i implementirajte model.

  3. Pokrenite naredbu /connect i potražite Azure.

/connect
  1. Unesite svoj API ključ.
┌ API key
└ enter
  1. Postavite ime vašeg resursa kao varijablu okruženja:
Terminal window
AZURE_RESOURCE_NAME=XXX opencode

Ili ga dodajte na svoj bash profil:

~/.bash_profile
export AZURE_RESOURCE_NAME=XXX
  1. Pokrenite naredbu /models da odaberete svoj raspoređeni model.
/models

Azure Cognitive Services

  1. Idite na Azure portal i kreirajte Azure OpenAI resurs. trebat će vam:

    • Naziv resursa: Ovo postaje dio vaše krajnje tačke API-ja (https://AZURE_COGNITIVE_SERVICES_RESOURCE_NAME.cognitiveservices.azure.com/)
    • API ključ: Ili KEY 1 ili KEY 2 sa vašeg izvora
  2. Idite na Azure AI Foundry i implementirajte model.

  3. Pokrenite naredbu /connect i potražite Azure kognitivne usluge.

/connect
  1. Unesite svoj API ključ.
┌ API key
└ enter
  1. Postavite ime vašeg resursa kao varijablu okruženja:
Terminal window
AZURE_COGNITIVE_SERVICES_RESOURCE_NAME=XXX opencode

Ili ga dodajte na svoj bash profil:

~/.bash_profile
export AZURE_COGNITIVE_SERVICES_RESOURCE_NAME=XXX
  1. Pokrenite naredbu /models da odaberete svoj raspoređeni model.
/models

Baseten

  1. Idite na Baseten, kreirajte račun i generirajte API ključ.

  2. Pokrenite naredbu /connect i potražite Baseten.

/connect
  1. Unesite svoj Baseten API ključ.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete model.
/models

Cerebras

  1. Idite na Cerebras konzolu, kreirajte račun i generirajte API ključ.

  2. Pokrenite naredbu /connect i potražite Cerebras.

/connect
  1. Unesite svoj Cerebras API ključ.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete model kao što je Qwen 3 Coder 480B.
/models

Cloudflare AI Gateway

Cloudflare AI Gateway vam omogućava da pristupite modelima iz OpenAI, Anthropic, Workers AI i više preko objedinjene krajnje tačke. Sa Unified Billing nisu vam potrebni posebni API ključevi za svakog provajdera.

  1. Idite na Cloudflare kontrolnu tablu, idite na AI > AI Gateway i kreirajte novi pristupnik.

  2. Postavite svoj ID naloga i ID pristupnika kao varijable okruženja.

~/.bash_profile
export CLOUDFLARE_ACCOUNT_ID=your-32-character-account-id
export CLOUDFLARE_GATEWAY_ID=your-gateway-id
  1. Pokrenite naredbu /connect i potražite Cloudflare AI Gateway.
/connect
  1. Unesite svoj Cloudflare API token.
┌ API key
└ enter

Ili ga postavite kao varijablu okruženja.

~/.bash_profile
export CLOUDFLARE_API_TOKEN=your-api-token
  1. Pokrenite naredbu /models da odaberete model.
/models

Također možete dodati modele kroz svoju opencode konfiguraciju.

opencode.json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"cloudflare-ai-gateway": {
"models": {
"openai/gpt-4o": {},
"anthropic/claude-sonnet-4": {}
}
}
}
}

Cortecs

  1. Idite na Cortecs konzolu, kreirajte račun i generirajte API ključ.

  2. Pokrenite naredbu /connect i potražite Cortecs.

/connect
  1. Unesite svoj Cortecs API ključ.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete model kao što je Kimi K2 Instruct.
/models

DeepSeek

  1. Idite na DeepSeek konzolu, kreirajte nalog i kliknite na Kreiraj novi API ključ.

  2. Pokrenite naredbu /connect i potražite DeepSeek.

/connect
  1. Unesite svoj DeepSeek API ključ.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete DeepSeek model kao što je DeepSeek Reasoner.
/models

Deep Infra

  1. Idite na Deep Infra kontrolnu tablu, kreirajte nalog i generišite API ključ.

  2. Pokrenite naredbu /connect i potražite Deep Infra.

/connect
  1. Unesite svoj Deep Infra API ključ.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete model.
/models

Firmware

  1. Idite na kontrolnu tablu firmvera, kreirajte nalog i generišite API ključ.

  2. Pokrenite naredbu /connect i potražite Firmware.

/connect
  1. Unesite svoj Firmware API ključ.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete model.
/models

Fireworks AI

  1. Idite na Fireworks AI konzolu, kreirajte račun i kliknite na Kreiraj API ključ.

  2. Pokrenite naredbu /connect i potražite Fireworks AI.

/connect
  1. Unesite svoj Fireworks AI API ključ.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete model kao što je Kimi K2 Instruct.
/models

GitLab Duo

GitLab Duo pruža agentsko ćaskanje sa AI-om sa izvornim mogućnostima pozivanja alata preko GitLab-ovog Anthropic proxyja.

  1. Pokrenite naredbu /connect i odaberite GitLab.
/connect
  1. Odaberite svoj način autentifikacije:
┌ Select auth method
│ OAuth (Recommended)
│ Personal Access Token

Korištenje OAuth-a (preporučeno)

Odaberite OAuth i vaš pretraživač će se otvoriti za autorizaciju.

Korištenje tokena ličnog pristupa

  1. Idite na GitLab korisničke postavke > Pristupni tokeni

  2. Kliknite Dodaj novi token

  3. Naziv: OpenCode, opseg: api

  4. Kopirajte token (počinje sa glpat-)

  5. Unesite ga u terminal

  6. Pokrenite naredbu /models da vidite dostupne modele.

/models

Dostupna su tri modela bazirana na Claudeu:

  • duo-chat-haiku-4-5 (zadano) - Brzi odgovori za brze zadatke
  • duo-chat-sonnet-4-5 - Uravnotežene performanse za većinu tokova posla
  • duo-chat-opus-4-5 - Najsposobniji za kompleksnu analizu
Samostalni GitLab

Za GitLab instance koje hostuju sami:

Terminal window
export GITLAB_INSTANCE_URL=https://gitlab.company.com
export GITLAB_TOKEN=glpat-...

Ako vaša instanca pokreće prilagođeni AI Gateway:

Terminal window
GITLAB_AI_GATEWAY_URL=https://ai-gateway.company.com

Ili dodajte na svoj bash profil:

~/.bash_profile
export GITLAB_INSTANCE_URL=https://gitlab.company.com
export GITLAB_AI_GATEWAY_URL=https://ai-gateway.company.com
export GITLAB_TOKEN=glpat-...
OAuth za self-hosted instance

Da bi Oauth radio za vašu instancu koju sami hostujete, morate kreirati novu aplikaciju (Podešavanja → Aplikacije) sa URL povratnog poziva http://127.0.0.1:8080/callback i sljedeći opseg:

  • api (pristupite API-ju u svoje ime)
  • read_user (Pročitajte svoje lične podatke)
  • read_repository (omogućava pristup spremištu samo za čitanje)

Zatim izložite ID aplikacije kao varijablu okruženja:

Terminal window
export GITLAB_OAUTH_CLIENT_ID=your_application_id_here

Više dokumentacije na početnoj stranici opencode-gitlab-auth.

Konfiguracija

Prilagodite putem opencode.json:

opencode.json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"gitlab": {
"options": {
"instanceUrl": "https://gitlab.com",
"featureFlags": {
"duo_agent_platform_agentic_chat": true,
"duo_agent_platform": true
}
}
}
}
}
GitLab API alati (opciono, ali se preporučuje)

Za pristup GitLab alatima (zahtjevi za spajanje, problemi, cjevovodi, CI/CD, itd.):

opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["@gitlab/opencode-gitlab-plugin"]
}

Ovaj dodatak pruža sveobuhvatne mogućnosti upravljanja GitLab repozitorijumom, uključujući MR preglede, praćenje problema, praćenje procesa i još mnogo toga.


GitHub Copilot

Da biste koristili svoju GitHub Copilot pretplatu s opencode:

  1. Pokrenite naredbu /connect i potražite GitHub Copilot.
/connect
  1. Idite na github.com/login/device i unesite kod.
┌ Login with GitHub Copilot
│ https://github.com/login/device
│ Enter code: 8F43-6FCF
└ Waiting for authorization...
  1. Sada pokrenite naredbu /models da odaberete model koji želite.
/models

Google Vertex AI

Za korištenje Google Vertex AI s OpenCode:

  1. Idite do Model Garden u Google Cloud Console i provjerite modeli dostupni u vašoj regiji.

  2. Postavite potrebne varijable okruženja:

    • GOOGLE_CLOUD_PROJECT: ID vašeg Google Cloud projekta
    • VERTEX_LOCATION (opciono): Region za Vertex AI (podrazumevano na global)
    • Autentifikacija (odaberite jednu):
      • GOOGLE_APPLICATION_CREDENTIALS: Put do JSON ključnog fajla vašeg naloga usluge
      • Autentifikacija koristeći gcloud CLI: gcloud auth application-default login

    Postavite ih dok se pokreće opencode.

Terminal window
GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json GOOGLE_CLOUD_PROJECT=your-project-id opencode

Ili ih dodajte svom bash profilu.

~/.bash_profile
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
export GOOGLE_CLOUD_PROJECT=your-project-id
export VERTEX_LOCATION=global
  1. Pokrenite naredbu /models da odaberete model koji želite.
/models

Groq

  1. Idite na Groq konzolu, kliknite Kreiraj API ključ i kopirajte ključ.

  2. Pokrenite naredbu /connect i potražite Groq.

/connect
  1. Unesite API ključ za provajdera.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete onu koju želite.
/models

Hugging Face

Hugging Face Inference Providers omogućava pristup otvorenim modelima koje podržava 17+ provajdera.

  1. Idite na Postavke zagrljaja da kreirate token s dozvolom za upućivanje poziva dobavljačima inference.

  2. Pokrenite naredbu /connect i potražite Hugging Face.

/connect
  1. Unesite svoj token Hugging Face.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete model kao što je Kimi-K2-Instruct ili GLM-4.6.
/models

Helicone

Helicone je platforma za praćenje LLM koja pruža evidenciju, praćenje i analitiku za vaše AI aplikacije. Helicone AI Gateway automatski usmjerava vaše zahtjeve do odgovarajućeg provajdera na osnovu modela.

  1. Idite na Helicone, kreirajte račun i generirajte API ključ sa svoje kontrolne table.

  2. Pokrenite naredbu /connect i potražite Helicone.

/connect
  1. Unesite svoj Helicone API ključ.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete model.
/models

Za više provajdera i napredne funkcije kao što su keširanje i ograničavanje brzine, provjerite Helicone dokumentaciju.

Opcione konfiguracije

U slučaju da vidite funkciju ili model iz Helicone-a koji nije automatski konfiguriran putem opencodea, uvijek ga možete sami konfigurirati.

Evo Heliconeov katalog modela, ovo će vam trebati da preuzmete ID-ove modela koje želite dodati.

~/.config/opencode/opencode.jsonc
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"helicone": {
"npm": "@ai-sdk/openai-compatible",
"name": "Helicone",
"options": {
"baseURL": "https://ai-gateway.helicone.ai",
},
"models": {
"gpt-4o": {
// Model ID (from Helicone's model directory page)
"name": "GPT-4o", // Your own custom name for the model
},
"claude-sonnet-4-20250514": {
"name": "Claude Sonnet 4",
},
},
},
},
}

Prilagođena zaglavlja

Helicone podržava prilagođena zaglavlja za funkcije kao što su keširanje, praćenje korisnika i upravljanje sesijom. Dodajte ih u konfiguraciju svog provajdera koristeći options.headers:

~/.config/opencode/opencode.jsonc
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"helicone": {
"npm": "@ai-sdk/openai-compatible",
"name": "Helicone",
"options": {
"baseURL": "https://ai-gateway.helicone.ai",
"headers": {
"Helicone-Cache-Enabled": "true",
"Helicone-User-Id": "opencode",
},
},
},
},
}
Praćenje sesije

Heliconeova funkcija Sessions vam omogućava da grupišete povezane LLM zahtjeve zajedno. Koristite dodatak opencode-helicone-session da automatski prijavite svaki OpenCode razgovor kao sesiju u Helicone-u.

Terminal window
npm install -g opencode-helicone-session

Dodajte ga u svoju konfiguraciju.

opencode.json
{
"plugin": ["opencode-helicone-session"]
}

Dodatak ubacuje zaglavlja Helicone-Session-Id i Helicone-Session-Name u vaše zahtjeve. Na stranici Helicone Sessions, vidjet ćete svaki OpenCode razgovor naveden kao zasebna sesija.

Uobičajena Helicone zaglavlja
HeaderOpis
Helicone-Cache-EnabledOmogući keširanje odgovora (true/false)
Helicone-User-IdPratite metriku po korisniku
Helicone-Property-[Name]Dodajte prilagođena svojstva (npr. Helicone-Property-Environment)
Helicone-Prompt-IdPovezivanje zahtjeva sa brzim verzijama

Pogledajte Helicone Header Directory za sva dostupna zaglavlja.


llama.cpp

Možete konfigurirati opencode za korištenje lokalnih modela putem llama.cpp’s uslužnog programa llama-server

opencode.json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"llama.cpp": {
"npm": "@ai-sdk/openai-compatible",
"name": "llama-server (local)",
"options": {
"baseURL": "http://127.0.0.1:8080/v1"
},
"models": {
"qwen3-coder:a3b": {
"name": "Qwen3-Coder: a3b-30b (local)",
"limit": {
"context": 128000,
"output": 65536
}
}
}
}
}
}

U ovom primjeru:

  • llama.cpp je ID prilagođenog provajdera. Ovo može biti bilo koji niz koji želite.
  • npm specificira paket koji će se koristiti za ovog provajdera. Ovdje se @ai-sdk/openai-compatible koristi za bilo koji OpenAI kompatibilan API.
  • name je ime za prikaz za provajdera u korisničkom sučelju.
  • options.baseURL je krajnja tačka za lokalni server.
  • models je mapa ID-ova modela prema njihovim konfiguracijama. Naziv modela će biti prikazan na listi za odabir modela.

IO.NET

IO.NET nudi 17 modela optimiziranih za različite slučajeve upotrebe:

  1. Idite na IO.NET konzolu, kreirajte račun i generirajte API ključ.

  2. Pokrenite naredbu /connect i potražite IO.NET.

/connect
  1. Unesite svoj IO.NET API ključ.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete model.
/models

LM Studio

Možete konfigurirati opencode za korištenje lokalnih modela preko LM Studio.

opencode.json
{
"$schema": "https://opencode.ai/config.json",
"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)"
}
}
}
}
}

U ovom primjeru:

  • lmstudio je ID prilagođenog provajdera. Ovo može biti bilo koji niz koji želite.
  • npm specificira paket koji će se koristiti za ovog provajdera. Ovdje se @ai-sdk/openai-compatible koristi za bilo koji OpenAI kompatibilan API.
  • name je ime za prikaz za provajdera u korisničkom sučelju.
  • options.baseURL je krajnja tačka za lokalni server.
  • models je mapa ID-ova modela prema njihovim konfiguracijama. Naziv modela će biti prikazan na listi za odabir modela.

Moonshot AI

Da biste koristili Kimi K2 iz Moonshot AI:

  1. Idite na Moonshot AI konzolu, kreirajte nalog i kliknite na Kreiraj API ključ.

  2. Pokrenite naredbu /connect i potražite Moonshot AI.

/connect
  1. Unesite svoj Moonshot API ključ.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete Kimi K2.
/models

MiniMax

  1. Prijeđite na MiniMax API konzolu, kreirajte račun i generirajte API ključ.

  2. Pokrenite naredbu /connect i potražite MiniMax.

/connect
  1. Unesite svoj MiniMax API ključ.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete model kao što je M2.1.
/models

Nebius Token Factory

  1. Idite na Nebius Token Factory konzolu, kreirajte nalog i kliknite na Dodaj ključ.

  2. Pokrenite naredbu /connect i potražite Nebius Token Factory.

/connect
  1. Unesite svoj Nebius Token Factory API ključ.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete model kao što je Kimi K2 Instruct.
/models

Ollama

Možete konfigurirati opencode za korištenje lokalnih modela putem Ollame.

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

U ovom primjeru:

  • ollama je ID prilagođenog provajdera. Ovo može biti bilo koji niz koji želite.
  • npm specificira paket koji će se koristiti za ovog provajdera. Ovdje se @ai-sdk/openai-compatible koristi za bilo koji OpenAI kompatibilan API.
  • name je ime za prikaz za provajdera u korisničkom sučelju.
  • options.baseURL je krajnja tačka za lokalni server.
  • models je mapa ID-ova modela prema njihovim konfiguracijama. Naziv modela će biti prikazan na listi za odabir modela.

Ollama Cloud

Da biste koristili Ollama Cloud s OpenCode:

  1. Idite na https://ollama.com/ i prijavite se ili kreirajte račun.

  2. Idite na Postavke > Ključevi i kliknite na Dodaj API ključ da generišete novi API ključ.

  3. Kopirajte API ključ za korištenje u OpenCode.

  4. Pokrenite naredbu /connect i potražite Ollama Cloud.

/connect
  1. Unesite svoj Ollama Cloud API ključ.
┌ API key
└ enter
  1. Važno: Prije upotrebe modela oblaka u OpenCode, morate lokalno povući informacije o modelu:
Terminal window
ollama pull gpt-oss:20b-cloud
  1. Pokrenite naredbu /models da odaberete svoj model Ollama Cloud.
/models

OpenAI

Preporučujemo da se prijavite za ChatGPT Plus ili Pro.

  1. Nakon što ste se prijavili, pokrenite naredbu /connect i odaberite OpenAI.
/connect
  1. Ovdje možete odabrati opciju ChatGPT Plus/Pro i ona će otvoriti vaš pretraživač i traži od vas da se autentifikujete.
┌ Select auth method
│ ChatGPT Plus/Pro
│ Manually enter API Key
  1. Sada bi svi OpenAI modeli trebali biti dostupni kada koristite naredbu /models.
/models
Korištenje API ključeva

Ako već imate API ključ, možete odabrati Ručno unesite API ključ i zalijepite ga u svoj terminal.


OpenCode Zen

OpenCode Zen je lista testiranih i verifikovanih modela koju je obezbedio OpenCode tim. Saznajte više.

  1. Prijavite se na OpenCode Zen i kliknite na Kreiraj API ključ.

  2. Pokrenite naredbu /connect i potražite OpenCode Zen.

/connect
  1. Unesite svoj OpenCode API ključ.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete model kao što je Qwen 3 Coder 480B.
/models

OpenRouter

  1. Idite na OpenRouter nadzornu ploču, kliknite na Kreiraj API ključ i kopirajte ključ.

  2. Pokrenite naredbu /connect i potražite OpenRouter.

/connect
  1. Unesite API ključ za provajdera.
┌ API key
└ enter
  1. Mnogi OpenRouter modeli su unapred učitani po defaultu, pokrenite naredbu /models da odaberete onaj koji želite.
/models

Također možete dodati dodatne modele putem vaše opencode konfiguracije.

opencode.json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"openrouter": {
"models": {
"somecoolnewmodel": {}
}
}
}
}
  1. Također ih možete prilagoditi putem vaše opencode konfiguracije. Evo primjera navođenja provajdera
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"openrouter": {
"models": {
"moonshotai/kimi-k2": {
"options": {
"provider": {
"order": ["baseten"],
"allow_fallbacks": false
}
}
}
}
}
}
}

SAP AI Core

SAP AI Core omogućava pristup preko 40+ modela iz OpenAI, Anthropic, Google, Amazon, Meta, Mistral i AI21 putem objedinjene platforme.

  1. Idite na vaš SAP BTP Cockpit, idite na instancu usluge SAP AI Core i kreirajte servisni ključ.

  2. Pokrenite naredbu /connect i potražite SAP AI Core.

/connect
  1. Unesite JSON svoj servisni ključ.
┌ Service key
└ enter

Ili postavite varijablu okruženja AICORE_SERVICE_KEY:

Terminal window
AICORE_SERVICE_KEY='{"clientid":"...","clientsecret":"...","url":"...","serviceurls":{"AI_API_URL":"..."}}' opencode

Ili ga dodajte na svoj bash profil:

~/.bash_profile
export AICORE_SERVICE_KEY='{"clientid":"...","clientsecret":"...","url":"...","serviceurls":{"AI_API_URL":"..."}}'
  1. Opciono postavite ID implementacije i grupu resursa:
Terminal window
AICORE_DEPLOYMENT_ID=your-deployment-id AICORE_RESOURCE_GROUP=your-resource-group opencode
  1. Pokrenite naredbu /models da odaberete između 40+ dostupnih modela.
/models

OVHcloud AI krajnje tačke

  1. Idite na OVHcloud panel. Idite do odjeljka Public Cloud, AI & Machine Learning > AI Endpoints i na kartici API Keys kliknite na Kreiraj novi API ključ.

  2. Pokrenite naredbu /connect i potražite OVHcloud AI krajnje točke.

/connect
  1. Unesite svoj OVHcloud AI Endpoints API ključ.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete model kao što je gpt-oss-120b.
/models

Scaleway

Da biste koristili Scaleway Generative APIs sa Opencodeom:

  1. Prijeđite na Scaleway Console IAM postavke da generišete novi API ključ.

  2. Pokrenite naredbu /connect i potražite Scaleway.

/connect
  1. Unesite svoj Scaleway API ključ.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete model kao što je devstral-2-123b-instruct-2512 ili gpt-oss-120b.
/models

Together AI

  1. Idite na Together AI console, kreirajte nalog i kliknite na Dodaj ključ.

  2. Pokrenite naredbu /connect i potražite Together AI.

/connect
  1. Unesite svoj Together AI API ključ.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete model kao što je Kimi K2 Instruct.
/models

Venice AI

  1. Idite na Venice AI konzolu, kreirajte račun i generirajte API ključ.

  2. Pokrenite naredbu /connect i potražite Venice AI.

/connect
  1. Unesite svoj Venice AI API ključ.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete model kao što je Llama 3.3 70B.
/models

Vercel AI Gateway

Vercel AI Gateway vam omogućava da pristupite modelima iz OpenAI, Anthropic, Google, xAI i drugih putem objedinjene krajnje tačke. Modeli se nude po kataloškim cijenama bez maraka.

  1. Idite na Vercel kontrolnu tablu, idite na karticu AI Gateway i kliknite na API ključevi da kreirate novi API ključ.

  2. Pokrenite naredbu /connect i potražite Vercel AI Gateway.

/connect
  1. Unesite svoj Vercel AI Gateway API ključ.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete model.
/models

Također možete prilagoditi modele kroz svoju opencode konfiguraciju. Evo primjera specificiranja redoslijeda usmjeravanja dobavljača.

opencode.json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"vercel": {
"models": {
"anthropic/claude-sonnet-4": {
"options": {
"order": ["anthropic", "vertex"]
}
}
}
}
}
}

Neke korisne opcije rutiranja:

OpcijaOpis
orderRedoslijed dobavljača za pokušaj
onlyOgraničiti na određene provajdere
zeroDataRetentionKoristite samo provajdere sa nultom politikom zadržavanja podataka

xAI

  1. Prijeđite na xAI konzolu, kreirajte račun i generirajte API ključ.

  2. Pokrenite naredbu /connect i potražite xAI.

/connect
  1. Unesite svoj xAI API ključ.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete model kao što je Grok Beta.
/models

Z.AI

  1. Idite na Z.AI API konzolu, kreirajte nalog i kliknite na Kreiraj novi API ključ.

  2. Pokrenite naredbu /connect i potražite Z.AI.

/connect

Ako ste pretplaćeni na GLM plan kodiranja, odaberite Z.AI plan kodiranja.

  1. Unesite svoj Z.AI API ključ.
┌ API key
└ enter
  1. Pokrenite naredbu /models da odaberete model kao što je GLM-4.7.
/models

ZenMux

  1. Idite na ZenMux kontrolnu tablu, kliknite na Kreiraj API ključ i kopirajte ključ.

  2. Pokrenite naredbu /connect i potražite ZenMux.

/connect
  1. Unesite API ključ za provajdera.
┌ API key
└ enter
  1. Mnogi ZenMux modeli su unaprijed učitani po defaultu, pokrenite naredbu /models da odaberete onaj koji želite.
/models

Također možete dodati dodatne modele putem vaše opencode konfiguracije.

opencode.json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"zenmux": {
"models": {
"somecoolnewmodel": {}
}
}
}
}

Prilagođeni provajder

Da biste dodali bilo kojeg OpenAI-kompatibilnog provajdera koji nije naveden u naredbi /connect:

  1. Pokrenite naredbu /connect i pomaknite se prema dolje do Ostalo.
Terminal window
$ /connect
Add credential
Select provider
...
Other
  1. Unesite jedinstveni ID za provajdera.
Terminal window
$ /connect
Add credential
Enter provider id
myprovider
  1. Unesite svoj API ključ za provajdera.
Terminal window
$ /connect
Add credential
This only stores a credential for myprovider - you will need to configure it in opencode.json, check the docs for examples.
Enter your API key
sk-...
  1. Kreirajte ili ažurirajte svoju opencode.json datoteku u direktoriju projekta:
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"myprovider": {
"npm": "@ai-sdk/openai-compatible",
"name": "My AI ProviderDisplay Name",
"options": {
"baseURL": "https://api.myprovider.com/v1"
},
"models": {
"my-model-name": {
"name": "My Model Display Name"
}
}
}
}
}

Evo opcija konfiguracije:

  • npm: AI SDK paket za korištenje, @ai-sdk/openai-compatible za OpenAI-kompatibilne provajdere
  • name: Ime za prikaz u korisničkom sučelju.
  • modeli: Dostupni modeli.
  • options.baseURL: URL krajnje tačke API-ja.
  • options.apiKey: Opciono postavite API ključ, ako ne koristite auth.
  • options.headers: Opciono postavite prilagođena zaglavlja.

Više o naprednim opcijama u primjeru ispod.

  1. Pokrenite naredbu /models i vaš prilagođeni provajder i modeli će se pojaviti na listi izbora.

Primjer

Evo primjera postavljanja opcija apiKey, headers i modela limit.

opencode.json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"myprovider": {
"npm": "@ai-sdk/openai-compatible",
"name": "My AI ProviderDisplay Name",
"options": {
"baseURL": "https://api.myprovider.com/v1",
"apiKey": "{env:ANTHROPIC_API_KEY}",
"headers": {
"Authorization": "Bearer custom-token"
}
},
"models": {
"my-model-name": {
"name": "My Model Display Name",
"limit": {
"context": 200000,
"output": 65536
}
}
}
}
}
}

Detalji konfiguracije:

  • apiKey: Postavite pomoću sintakse varijable env, saznajte više.
  • zaglavlja: Prilagođena zaglavlja se šalju sa svakim zahtjevom.
  • limit.context: Maksimalni ulazni tokeni koje model prihvata.
  • limit.output: Maksimalni tokeni koje model može generirati.

Polja limit omogućavaju OpenCode da shvati koliko vam je konteksta ostalo. Standardni dobavljači ih automatski preuzimaju sa models.dev.


Rješavanje problema

Ako imate problema s konfiguracijom provajdera, provjerite sljedeće:

  1. Provjerite postavke autentifikacije: Pokrenite opencode auth list da vidite da li su vjerodajnice za provajdera se dodaju u vašu konfiguraciju.

    Ovo se ne odnosi na dobavljače kao što je Amazon Bedrock, koji se oslanjaju na varijable okruženja za svoju autentifikaciju.

  2. Za prilagođene provajdere, provjerite konfiguraciju otvorenog koda i:

    • Uvjerite se da ID provajdera korišten u naredbi /connect odgovara ID-u u vašoj opencode konfiguraciji.
    • Za provajdera se koristi pravi npm paket. Na primjer, koristite @ai-sdk/cerebras za Cerebras. A za sve ostale OpenAI kompatibilne provajdere, koristite @ai-sdk/openai-compatible.
    • Provjerite da li se ispravna krajnja tačka API-ja koristi u polju options.baseURL.