Claude az OpenCode-ban: a Claude Agent szolgáltató, az API-kulcsok és a többi út

A Claude kétféleképpen használható az OpenCode-ban. A 2026. október 30-án megjelent OpenCode 2.2.3 óta a beépített Claude Agent szolgáltató a saját Claude Code-bejelentkezésén keresztül futtatja a Claude-ot: telepítse a Claude Code-ot, futtassa a claude auth login parancsot, válassza a Claude Agentet a /connect alatt, és a Claude-modellek a Claude-előfizetésén futnak, miközben az OpenCode megtartja a saját eszközeit, jogosultságait és munkamenet-előzményeit. A másik út a tokenalapú vagy licencalapú fizetés egy szolgáltatón keresztül: Anthropic API-kulcs, OpenCode Console, GitHub Copilot, OpenRouter, illetve Amazon Bedrock és Google Vertex.

Ne használja viszont a régebbi közösségi bővítményeket, amelyek közvetlenül a Claude Pro vagy Max fiókjával léptetik be az OpenCode-ot. Az OpenCode az 1.3.0-s verzió óta nem csomagolja őket, a dokumentációja szerint az Anthropic kifejezetten tiltja őket, és az Anthropic feltételei megtiltják, hogy külső alkalmazások Claude.ai-hozzáférési adatokat gyűjtsenek vagy közvetítsenek. Ez az útmutató sorra veszi az utakat, bemutatja, hogyan működik a Claude Agent szolgáltató, mennyibe kerülnek az egyes utak, és mit mutatott egy kis tesztfuttatás a gépemen. Magáról az eszközről az OpenCode-értékelésem szól.

Milyen utakon futtatható a Claude az OpenCode-ban?

2026 októberében hét gyakorlati út létezik. Az opencode models parancs minden bekötött szolgáltató Claude-modelljeit kilistázza; a gépemen öt szolgáltató kínált Claude-ot, a claude-agent/opus-tól az openrouter/anthropic/claude-sonnet-5.5-ig.

A modellazonosítók az egyes szolgáltatók szokását követik. A Claude Agent a Claude Code álneveit használja, például opus, sonnet és haiku, és ezeket a Claude Code oldja fel az aktuális modellre, például az opus-t claude-opus-5-5-re. A Copilot és az OpenRouter ponttal írja a verziót, mint a claude-sonnet-5.5; az Anthropic szolgáltató és az OpenCode Console kötőjelet használ, mint a claude-sonnet-5-5.

Hogyan állítható be a Claude Agent szolgáltató?

Kell hozzá a Claude Code 2.1.248-as vagy újabb verziója, bejelentkezve, ugyanazon a gépen, ahol az OpenCode-szerver fut. Ezután a Claude Agentet ugyanúgy köti be, mint bármely más szolgáltatót. A modellek listája a Claude Code-tól jön, az effort-szintek pedig variánsok, például claude-agent/opus#high.

# 1. Telepítse vagy frissítse a Claude Code-ot (2.1.248 vagy újabb), majd lépjen be
claude update
claude auth login

# 2. Az OpenCode TUI-ban: kösse be a szolgáltatót és válasszon modellt
/connect     # válassza a Claude Agentet
/models      # például claude-agent/sonnet

# 3. Vagy parancssorból, effort-variánssal
opencode run -m "claude-agent/opus#high" "Magyarázd el, miért bukik el a tests/api"

Az OpenCode a PATH-ban keresi a claude programot. Másik példány használatához állítsa be az OPENCODE_CLAUDE_PATH változót az OpenCode-szerveren, például így: opencode service set env OPENCODE_CLAUDE_PATH /opt/claude/bin/claude. A 2.2.3-mal azonos napon kiadott 2.2.4-es verzió vezetett beállítást hozott az asztali és a webes alkalmazásba: a Claude Agent kiválasztásakor megjelenik a claude auth login parancs, egy gomb a Claude Code telepítéséhez, és egy ellenőrzés, amely megvárja, amíg az OpenCode megerősíti, hogy a Claude Code telepítve van és be van jelentkezve. Ha az ellenőrzés nem sikerül, a párbeszédablak megnevezi az okát, például hogy nincs telepítve, nincs bejelentkezve vagy túl régi, és felajánlja az újbóli ellenőrzést.

Bármilyen Claude Code-bejelentkezés működik, nem csak az előfizetés. Ha a Claude Code API-kulccsal van bejelentkezve, vagy Claude Platform on AWS, Bedrock, Vertex vagy Microsoft Foundry használatára van beállítva, a szolgáltató ezt a bejelentkezést használja. Az OpenCode konfigurációjának kapcsolati beállításait az OpenCode továbbadja a Claude Code-nak: a settings.baseURL-ből ANTHROPIC_BASE_URL, a settings.apiKey-ből ANTHROPIC_API_KEY, a headers-ből ANTHROPIC_CUSTOM_HEADERS lesz. Így vezethető a szolgáltató egy céges LLM-átjárón keresztül.

Mi történik, amikor az OpenCode a Claude Code-on át futtatja a Claude-ot?

A modellt a Claude Code hívja, minden mást az OpenCode végez. Az OpenCode az Anthropic Claude Agent SDK-ján keresztül indítja el a telepített claude programot, munkamenetenként egy hosszan futó folyamattal, és a Claude Code saját eszközei helyett az OpenCode eszközeit adja neki. Ha a Claude eszközt hív, a szolgáltató visszatartja a hívást, az OpenCode a szokásos jogosultsági kérdésekkel lefuttatja, és az eredmény visszakerül a Claude-hoz. A tervezési specifikáció szerint az OpenCode soha nem áll a Claude Code és az Anthropic közé, nem módosítja a Claude Code kéréseit, és nem olvassa a Claude Code elmentett bejelentkezését.

A szolgáltató szándékosan kikapcsolja a Claude Code saját mechanizmusainak nagy részét, hogy az OpenCode ugyanúgy viselkedjen, bármelyik modellt választja:

• Eszközök: a Claude Code beépített eszközei ki vannak kapcsolva. A Claude csak az OpenCode eszközeit kapja, így egyetlen jogosultsági rendszer érvényes, és az előzmények ugyanúgy néznek ki, bármelyik modell írta őket.
• Beállítások: a Claude Code nem olvassa a ~/.claude beállításait, a CLAUDE.md fájlokat, a hookokat, az MCP-szervereket és a skilleket. Az OpenCode a Claude Code rendszerpromptja mellé a saját utasításait teszi: a kiválasztott ügynök promptját, az AGENTS.md fájlokat, a skilleket és az MCP-utasításokat.
• Előzmények: az OpenCode előzményei a mérvadók. Ha munkamenet közben vált a Claude-ra, minden, amit a Claude még nem látott, egyetlen üzenetként megy át, így ugyanabban a munkamenetben válthat a Claude és más modellek között.
• Tömörítés és alügynökök: mindkettőt az OpenCode végzi. A Claude Code automatikus tömörítése, automatikus memóriája és eszközkeresése ki van kapcsolva.
• Folyamat élettartama: a claude folyamat 5 perc tétlenség után leáll, a következő üzenet pedig folytatja az elmentett Claude-munkamenetet. Az OpenCode eszközeinek futása nem számít tétlenségnek.

Gyakorlati következmény, hogy az eszközhívások egymás után futnak. A specifikáció szerint a szolgáltatónak minden eredményt a Claude hívásazonosítójához kell rendelnie, és egyszerre csak egy azonosítót követ, ezért az eszközöket soha nem jelöli párhuzamosan futtathatónak.

Szabad a Claude-előfizetést az OpenCode-ban használni?

A Claude Agent szolgáltató használata a saját előfizetéssel 2026 októberében megfelel az Anthropic közzétett szabályainak; a Claude.ai-bejelentkezést újrahasznosító bővítmények nem. A különbség az, hogy ki kezeli a hozzáférési adatokat. Az Anthropic jogi oldala szerint az OAuth-bejelentkezés az előfizetőknek, a Claude Code és más natív Anthropic-alkalmazások szokásos használatára szolgál. Külső fejlesztők nem kínálhatnak Claude.ai-bejelentkezést a saját alkalmazásukban, nem irányíthatnak kéréseket a felhasználóik nevében Free, Pro, Max vagy Ultra csomagok hozzáférési adataival, és nem gyűjthetnek, tárolhatnak vagy közvetíthetnek Claude.ai-hozzáférési adatokat vagy munkamenet-tokeneket. Ugyanez a szakasz kimondja, hogy ez nem akadályozza meg a végfelhasználót abban, hogy a saját Claude-előfizetésével belépjen a módosítatlan Claude Code programba.

A Claude Agent szolgáltató pontosan e mentén épül: a saját, módosítatlan claude programját futtatja, és a bejelentkezés az Anthropic folyamatán keresztül, a terminálban történik. Az Anthropic 2026 októberében frissített súgóközpontja azt is kimondja, hogy az Agent SDK, a claude -p és a külső alkalmazások használata továbbra is az előfizetés kereteiből fogy, ha a csomagjával van bejelentkezve. Ez fordulat 2026 elejéhez képest: az OpenCode v1-es szolgáltatói dokumentációja még mindig azt írja, hogy léteznek bővítmények a Claude Pro vagy Max használatához az OpenCode-ban, hogy ezt az Anthropic kifejezetten tiltja, és hogy az OpenCode az 1.3.0-s verzió óta nem csomagolja őket.

Mikor jobb választás az API-kulcs vagy az OpenCode Console?

Fizessen tokenalapon, ha a munka szerveren, CI-ban, csapatban vagy távoli munkaterületen fut. A Claude Agent szolgáltatóhoz telepített és bejelentkezett Claude Code kell ugyanazon a gépen, ahol az OpenCode-szerver fut, ezért hosztolt OpenCode-ban és távoli munkaterületen nem érhető el. API-kulccsal az OpenCode közvetlenül hívja az Anthropicot. A kulcsot a /connect paranccsal kötheti be, vagy környezeti változóként adhatja át a háttérszolgáltatásnak:

# Anthropic API-kulcs a közös háttérszolgáltatáshoz
opencode service set env ANTHROPIC_API_KEY sk-ant-...
opencode auth list

# Vagy egyetlen futtatáshoz, saját szerverrel
ANTHROPIC_API_KEY=sk-ant-... opencode --standalone

Az OpenCode Console előre fizetett egyenlegre viszonteladja ugyanezeket a modelleket, ami kényelmes, ha egyetlen OpenCode-számlát szeretne több szolgáltatóra. 2026 októberében a bemeneti és kimeneti tokenárai megegyeznek az Anthropicéval. A táblázat egyetlen eltérése a Sonnet 5.5 gyorsítótár-olvasása, egy hosszú kódolási munkamenetben pedig a bemeneti tokenek többsége gyorsítótár-olvasás.

Az ötperces gyorsítótár-írás mindkettőnél a bemeneti ár 1.25-szöröse: az Opus 5.5-nél $5.00, a Sonnet 5.5-nél $2.50, a Haiku 5.5-nél $0.125. Az OpenCode az Anthropic-utakon automatikusan elhelyezi a prompt-gyorsítótár töréspontjait. Csak akkor kell a compatibility.cacheFormat értékét "anthropic"-ra állítani ezeknél a modelleknél, ha a Claude egy OpenAI-kompatibilis proxy, például a LiteLLM mögött van, mert az OpenCode a proxyból nem tudja megállapítani, hogy Anthropic-stílusú töréspontokra van szükség. A Claude-árazási útmutatóm részletesebben összeveti az előfizetési kereteket az API-költségekkel.

Használható a Claude Copiloton, OpenRouteren, Bedrockon vagy Vertexen át?

Igen, mind a négy működik, és akkor van értelmük, ha az adott szolgáltatásért amúgy is fizet. A GitHub Copilot a GitHub eszközös bejelentkezésével kapcsolódik, és a fióknak Copilot Chat-hozzáférés kell. A GitHub általánosan elérhetőként sorolja fel a Copilotban a Claude Haiku 4.5-öt és 5.5-öt, a Sonnet 4.6-ot, 5-öt és 5.5-öt, az Opus 4.8-at, 5-öt és 5.5-öt, valamint a Fable 5-öt és 5.1-et, de a Copilot Free és Student felhasználók csak az automatikus modellválasztáson keresztül kapnak modellt. Az OpenCode bejelentkezés után letölti a fiók aktuális modellistáját.

Az OpenRouter OPENROUTER_API_KEY-t vagy bekötött fiókot használ, a modellek pedig az előtag után a teljes OpenRouter-azonosítót viselik, például openrouter/anthropic/claude-sonnet-5.5. A modellistámban mindig a legújabb verzióra mutató álnevek is szerepeltek, például openrouter/~anthropic/claude-sonnet-latest. Az Amazon Bedrock az AWS alapértelmezett hitelesítési láncát használja, a legegyszerűbb tartós beállítás egy elnevezett AWS-profil. A Google Vertex az Application Default Credentials-t használja, és projekt kell hozzá, mielőtt a modellek megjelennek. A szolgáltatói specifikáció szerint a Bedrock regionális modellazonosítói, például a us.anthropic.claude-opus-5-5, 10%-kal drágábbak az Anthropic listaáránál.

Az OpenCode Go a legolcsóbb belépő, de a Claude-modellek közül csak a Claude Haiku 5.5-öt tartalmazza. A Go csomag havi $10, és az OpenCode becslése szerint öt óránként 3,850 Haiku 5.5-kérést ad, kérésenként 1,100 bemeneti, 55,000 gyorsítótárazott és 240 kimeneti tokennel számolva. Ez alügynöknek vagy olcsó mellékmodellnek való, nem fő kódolási ügynöknek. A Haiku 5.5 útmutatóm megmutatja, mely feladatokat végzi jól.

Mit mutatott egy kis tesztfuttatás?

Mindkét előfizetéses út nagyjából öt másodperc alatt javította ugyanazt a kis hibát, és a Claude Agent út a specifikáció szerint az OpenCode eszközeit használta. Egy feladatot futtattam OpenCode 2.2.4-gyel és Claude Code 2.1.314-gyel: egy kétsoros Python-fájlt, amelynek add() függvénye kivont, azzal a prompttal, hogy javítsa ki, és egy mondatban írja le a változást. Mindkét futás Haiku 5.5-öt használt opencode run --format json módban, egyszer a claude-agent/haiku modellel a Claude-előfizetésemen, egyszer az opencode-go/claude-haiku-5-5 modellel.

Az OpenCode mindkét futásnál $0 költséget mutatott, mert a használatot az adott csomag fedezi. A listaáras oszlop a saját számításom Haiku 5.5-árakon, ötperces gyorsítótár-írást feltételezve. A promptok mérete hasonló volt: a Claude Agenten át, a Claude Code rendszerpromptjával nagyjából 22,900 token, a Gón át, az OpenCode sajátjával nagyjából 20,700. Az első Claude Agent lépés egy friss munkamenetben már 6,226 tokent olvasott a gyorsítótárból, nagy valószínűséggel a Claude Code rendszerpromptjának azt a részét, amely a korábbi Claude Code-használatomból még gyorsítótárban volt. Mindkét napló azt mutatja, hogy a read és edit eszközhívások az OpenCode-tól jöttek.

Két gyakorlati megjegyzés a tesztből. Az OpenCode Console-fiókomon nem volt egyenleg, és ez az út azonnal 402-es „Insufficient account funds” hibával leállt, mert a Console előre fizetett. Továbbá a terminál nélküli szkriptből hívott opencode run bemenetre várt, amíg a szabványos bemenetet le nem zártam a < /dev/null megadásával; ezzel minden futás rendben lefutott.

Hogyan állítható be a modell és az effort a Claude-hoz az OpenCode-ban?

Az opencode.jsonc fájlban állítson be alapértelmezett modellt, az egyes ügynököknek pedig adjon saját modellt opcionális #variant megadással. Gyakori felosztás az erős modell a tervezéshez, a közepes az építéshez és a kicsi a kereséshez. Az OpenCode beépített ügynökei: a build és a plan elsődleges ügynökök, a general és az explore alügynökök:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "claude-agent/sonnet",
  "agents": {
    "plan": { "model": "claude-agent/opus#high" },
    "explore": { "model": "claude-agent/haiku" }
  }
}

A #high effort-variánst választ. A variánsok neve a modell katalógusadataiból jön, az ismeretlen variáns pedig modellfeloldási hibával áll le, ezért egy konfiguráció véglegesítése előtt nézze meg a /models listát. A saját modell nélküli alügynök a szülő munkamenet modelljét örökli. Az Anthropic szolgáltatóval ugyanez a konfiguráció például anthropic/claude-opus-5-5#high azonosítókat használ. A Claude Agent szolgáltatónál a temperature, top-p, top-k, seed és stop-szekvenciák nem támogatottak, a shellben beállított CLAUDE_CODE_EFFORT_LEVEL pedig hatástalan, mert a szolgáltató törli, hogy az OpenCode-ban választott effort érvényesüljön.

Mi nem működik a Claude Agenttel az OpenCode-ban?

A szolgáltató a Claude modelljeit hozza az OpenCode-ba, nem a Claude Code termékfunkcióit. Az OpenCode dokumentációja és a tervezési specifikáció ezeket a hiányokat sorolja fel:

• Nincs hosztolt OpenCode és távoli munkaterület, mert a Claude Code-nak ugyanazon a gépen kell futnia, mint az OpenCode-szervernek.
• A Claude Code rendszerpromptja felváltja az OpenCode beépített ügynökpromptjait; az egyéni ügynökpromptok továbbra is érvényesek.
• A bővítmények http.request és http.response hookjai nem futnak, mert az API-hívásokat a Claude Code végzi.
• Hiányoznak a Claude Code azon funkciói, amelyeknek nincs OpenCode-megfelelője: a /usage és a keret elérésekor felkínált lehetőségek, a /loop, az automatikus mód, az ügynökcsapatok, a felhős munkamenetek és a /teleport, a számítógép-vezérlés, a homokozós Bash és a beépített skillek, például a /simplify. Az OpenCode saját /usage parancsa helyettük a Console-használatot mutatja.
• Az eszközhívások egymás után futnak, ahogy fent leírtam.

Ha ezekre a Claude Code-funkciókra naponta szüksége van, használja magát a Claude Code-ot; a Claude Code-értékelésem erről szól. A szolgáltató azoknak való, akik az OpenCode felületét, többmodelles munkameneteit és jogosultsági szabályait részesítik előnyben, de a Claude-előfizetésüket szeretnék mögötte használni.

Melyik utat válassza?

Az utat aszerint válassza, ki használja az OpenCode-ot és hol fut:

1. Saját gép és meglévő Claude Pro, Max vagy Ultra előfizetés: a Claude Agent szolgáltató. Olyan kereteket használ, amelyekért már fizet, és megtartja az OpenCode munkamódját.
2. Csapat, CI, szerver vagy távoli munkaterület: Anthropic API-kulcs, illetve Bedrock vagy Vertex, ha a cége már ott dolgozik. Az OpenCode Console-t válassza, ha egyetlen előre fizetett OpenCode-számlát szeretne több szolgáltatóra.
3. Meglévő Copilot-licenc: a GitHub Copilot szolgáltató, a Copilot-csomag modelljein és keretein belül.
4. Olcsó kis mellékmodell: OpenCode Go a Haiku 5.5-höz, például explore alügynökként.
5. Útválasztás és tartalék több szolgáltató között: OpenRouter, ha már használja.

Bármelyik utat választja, a projektutasításokat az AGENTS.md fájlban tartsa, ne a CLAUDE.md-ben, mert az OpenCode ezt adja át minden modellnek, a Claude Agent szolgáltatón keresztül a Claude-nak is. A döntési mátrix az AGENTS.md, a skillek, az MCP és a CLI-k között segít ebben a felosztásban. Ha kódoló ügynököket vezet be egy csapatnak, és rendezni kell a költség- és adatvédelmi kérdéseket, az az AI-mérnöki munkám része.

Források

1. OpenCode v2.2.3 release notes (October 30, 2026)
2. OpenCode pull request #58782: add Claude Agent provider
3. Claude Agent provider design spec
4. OpenCode docs: Providers
5. OpenCode docs: Models
6. OpenCode docs (v1): Providers, note on Claude Pro/Max plugins
7. OpenCode Console: models and pricing
8. OpenCode Go: plans and usage limits
9. Claude Code docs: Legal and compliance
10. Claude Help Center: Use the Claude Agent SDK with your Claude plan
11. Claude Platform docs: Pricing
12. GitHub Docs: Supported AI models in GitHub Copilot