![](\"https:\/\/demensdeum.com\/blog\/wp-content\/uploads\/2026\/10\/aibank.jpg\"\/)
<\/p>\nOpenCode ist ein offener Programmieragent, der direkt im Terminal arbeitet: Projektdateien liest, Code bearbeitet, Befehle und Tests ausf\u00fchrt, das Repository durchsucht und mit Git arbeitet. Seine St\u00e4rke liegt darin, dass es nicht an einen Modellanbieter gebunden ist und Dutzende Anbieter verbinden kann.<\/p>\n
<\/p>\n
GigaChat ist ein gro\u00dfes Sprachmodell von Sber. Es ist nicht in der Liste der OpenCode-Anbieter enthalten, aber das ist kein Problem: OpenCode verbindet beliebige Anbieter \u00fcber Vercel AI SDK-Pakete. F\u00fcr GigaChat gibt es ein Paket gigachat-ai-sdk-provider<\/b>, das sich um die OAuth-Autorisierung und die Aktualisierung des Zugriffstokens k\u00fcmmert. Eine weitere Nuance sind die Zertifikate des Ministeriums f\u00fcr digitale Entwicklung: Ohne sie vertraut Node den GigaChat-Servern nicht und Anfragen schlagen mit einem Fehler bei der Zertifikats\u00fcberpr\u00fcfung fehl.<\/p>\n
In diesem Beitrag beschreibe ich, wie man einen Schl\u00fcssel erh\u00e4lt, Zertifikate installiert und GigaChat mit OpenCode verbindet.<\/p>\n
Zum Arbeiten ben\u00f6tigen Sie drei Dinge:<\/p>\n
Der Schl\u00fcssel wird in Ihrem pers\u00f6nlichen GigaChat Studio-Konto erstellt. Gehen Sie zu Developers.sber.ru\/studio, melden Sie sich an und erstellen Sie ein Projekt im Abschnitt GigaChat API<\/b>. In den Projekteinstellungen gibt es einen Block mit Berechtigungsdaten: Die Zeile, die von dort kopiert wird, ist ein vorgefertigter Berechtigungsschl\u00fcssel in base64. Dies wird in die Umgebungsvariable eingef\u00fcgt und nicht das Client-Geheimnis-Paar separat.<\/p>\n
Zusammen mit dem Schl\u00fcssel wird scope<\/b> angegeben \u2013 der Zugriffsbereich:<\/p>\n Der angezeigte Schl\u00fcsselwert sollte sofort gespeichert werden, er wird sp\u00e4ter nicht mehr angezeigt und muss ggf. neu vergeben werden.<\/p>\n Es ist wichtig zu verstehen, was diese Zeile ist. Der Autorisierungsschl\u00fcssel ist kein separates Geheimnis, sondern ein Paar von client_id:client_secret<\/b>, das bereits in base64 codiert ist. Die gigachat-js-Bibliothek ersetzt diesen Header in der OAuth-Anfrage:<\/p>\n Als Reaktion darauf verf\u00fcgt ein JWE-Zugriffstoken \u00fcber eine Lebensdauer von etwa einer halben Stunde und wird dann von der Bibliothek automatisch aktualisiert. Das Paket selbst pr\u00fcft, ob der Wert Base64 \u00e4hnelt, und warnt, wenn die Variable versehentlich ein \u201erohes\u201c Client-Geheimnis enth\u00e4lt. Daher ist es notwendig, den vorgefertigten Base64-String vom Konto in die Konfigurations- und Umgebungsvariable zu \u00fcbertragen und nicht das Paar client_id und client_secret separat.<\/p>\n Die GigaChat-API verwendet Zertifikate des NCA Ministry of Digital Development. Der standardm\u00e4\u00dfige vertrauensw\u00fcrdige Stammspeicher verf\u00fcgt nicht \u00fcber sie. Wenn Sie also versuchen, ein Zugriffstoken abzurufen, schl\u00e4gt die Anforderung mit einem Fehler wie dem folgenden fehl:<\/p>\n Zertifikate k\u00f6nnen auf Betriebssystemebene installiert werden \u2013 dann werden sie vom Browser und den Systemdienstprogrammen als vertrauensw\u00fcrdig eingestuft. Aber OpenCode l\u00e4uft auf Node und Bun, daher ist es sicherer und einfacher, die Zertifikatsdatei direkt in der Variablen NODE_EXTRA_CA_CERTS<\/b> anzugeben. Laden Sie die Stamm- und Ausstellerzertifikate herunter und f\u00fcgen Sie sie in einer PEM-Datei zusammen:<\/p>\n Die Datei kann an einem geeigneten Ort abgelegt werden und ihr vollst\u00e4ndiger Pfad kann beim Starten des Agenten angegeben werden.<\/p>\n Hier gibt es einen Haken. Heruntergeladene Dateien verwenden CRLF-Zeilenumbr\u00fcche und das Stammzertifikat verf\u00fcgt \u00fcber keinen nachgestellten Zeilenvorschub. Daher verkettet eine normale Katze das Ende des ersten Zertifikats und den Anfang des zweiten in einer Zeile:<\/p>\n LibreSSL \u2013 und das System OpenSSL unter macOS ist, ich m\u00f6chte Sie daran erinnern, genau LibreSSL \u2013 akzeptiert eine solche Datei nicht und antwortet mit einem Fehler:<\/p>\n Das bedeutet, dass eine Katze allein nicht ausreicht. Jedes Zertifikat muss zuerst \u00fcber openssl ausgef\u00fchrt werden: Es wird in kanonisches PEM mit LF-Zeilenvorsch\u00fcben und einem letzten Zeilenvorschub umcodiert und erst dann zusammengef\u00fchrt:<\/p>\n Sie k\u00f6nnen \u00fcberpr\u00fcfen, ob die Datei wie folgt gelesen wird:<\/p>\n Wenn die Zertifikate aus einer anderen Quelle stammen und im DER- oder PKCS#7-Format vorliegen, k\u00f6nnen sie auch in PEM umcodiert werden:<\/p>\n Der Anbieter ist in der Konfigurationsdatei opencode.jsonc<\/b> beschrieben. OpenCode selbst l\u00e4dt das im npm<\/b>-Feld angegebene npm-Paket herunter, verbindet es, findet darin die createGigaChat<\/b>-Factory und \u00fcbergibt ihr die Optionen. Es reicht aus, die Modelle anhand ihrer Kennungen aus der API aufzulisten.<\/p>\n Die Datei kann an zwei Orten abgelegt werden:<\/p>\n Beide Dateien verwenden das gleiche Schema und werden kombiniert: Die Projektdatei \u00fcberlappt die globale Datei nur bei passenden Schl\u00fcsseln, die restlichen Einstellungen werden gespeichert. Die Erweiterung .jsonc wird ebenfalls unterst\u00fctzt. Wenn GigaChat nur f\u00fcr einige Repositories ben\u00f6tigt wird, ist es bequemer, den Anbieter in der Projektkonfiguration zu belassen, statt in der globalen.<\/p>\n Verf\u00fcgbare Modelle mit pers\u00f6nlichem Schl\u00fcssel finden Sie hier. Wenn Sie ein Projekt f\u00fcr einen Einzelunternehmer oder eine juristische Person mit Zugriff auf GigaChat 3 haben, f\u00fcgen Sie die erforderlichen Identifikatoren aus der Models-Methode zum Models-Block hinzu.<\/p>\n Bequemer ist es, den Schl\u00fcssel selbst nicht in einer Datei zu speichern, sondern ihn an eine Umgebungsvariable zu \u00fcbergeben: Das Paket gigachat-js liest ihn automatisch. Der Bereichswert kann auch auf eine Variable festgelegt werden. Jetzt m\u00fcssen nur noch der Pfad zu den Zertifikaten festgelegt und der Agent gestartet werden:<\/p>\n Diese Option ist auch deshalb gut, weil das Geheimnis nicht im lokalen auth.json-Speicher landet: Es lebt nur in der Umgebung des Prozesses. Dies ist praktischer f\u00fcr CI- und einmalige Starts.<\/p>\n Die Menge der verf\u00fcgbaren Modelle h\u00e4ngt vom Scope-Schl\u00fcssel ab. Der pers\u00f6nliche Schl\u00fcssel (GIGACHAT_API_PERS) steht der GigaChat- und GigaChat 2-Familie zur Verf\u00fcgung:<\/p>\n Die GigaChat 3-Familie (GigaChat-3-Ultra, GigaChat-3-Pro, offene Modelle wie GigaChat3.5-432B-A28B-Reasoning) ist im Konsolenkatalog sichtbar, steht aber nicht f\u00fcr den pers\u00f6nlichen Schl\u00fcssel zur Verf\u00fcgung: Sie erfordert ein einzelnes Unternehmerprojekt oder eine juristische Person mit dem Geltungsbereich GIGACHAT_API_B2B oder GIGACHAT_API_CORP und einen passenden Tarif. Auf einen pers\u00f6nlichen Schl\u00fcssel antwortet ein solches Modell mit einem Fehler:<\/p>\n Sie k\u00f6nnen \u00fcberpr\u00fcfen, was Ihr Schl\u00fcssel tats\u00e4chlich ausgibt, indem Sie die Liste der Modelle abfragen:<\/p>\n Noch zwei Punkte. Modell-IDs in der API stimmen nicht mit den angezeigten Namen \u00fcberein \u2013 das Light-Modell hei\u00dft GigaChat-2<\/b>, nicht GigaChat-2-Lite. Und der Katalog in der Konsole zeigt nicht das Gleiche an, was f\u00fcr Ihren Schl\u00fcssel verf\u00fcgbar ist. Daher sollten Sie sich auf die Reaktion der Modellmethode und nicht auf die Preisliste konzentrieren.<\/p>\n In der Schnittstelle wird die Liste der Modelle mit dem Befehl ge\u00f6ffnet:<\/p>\n F\u00fcr Routinearbeiten im Repository \u2013 Navigieren durch Dateien, kleinere \u00c4nderungen, Ausf\u00fchren von Tests \u2013 reicht GigaChat-2 vollkommen aus. Bei komplexen Aufgaben und Designs ist es sinnvoll, auf Pro oder Max umzusteigen.<\/p>\n Gehen Sie in das Projektverzeichnis und starten Sie den Agenten:<\/p>\n Der erste Schritt besteht darin, den Agenten zu initialisieren:<\/p>\n OpenCode analysiert die Projektstruktur und erstellt eine Datei AGENTS.md<\/b> \u2013 Anweisungen f\u00fcr den Agenten. Es lohnt sich, diese Datei an Git zu \u00fcbergeben: Sie hilft dem Agenten, die im Projekt \u00fcbernommenen Konventionen und Muster zu verstehen.<\/p>\n Wenn Sie den NPM-Anbieter aus irgendeinem Grund nicht verwenden m\u00f6chten, liefert ein lokaler Proxy das gleiche Ergebnis. Das GigaChat-Team verf\u00fcgt \u00fcber einen offiziellen gpt2giga<\/b> \u2013 FastAPI-Dienst, der Anfragen im OpenAI-, Anthropic- und Gemini-Format in die GigaChat-API \u00fcbersetzt und das Zugriffstoken selbst aktualisiert. Es wird lokal auf Port 8090 ausgel\u00f6st, woraufhin ein regul\u00e4rer OpenAI-kompatibler Anbieter in OpenCode \u00fcber das Paket @ai-sdk\/openai-kompatible<\/b> mit der Basisadresse http:\/\/localhost:8090\/v1 konfiguriert wird. Der Nachteil dieses Weges besteht darin, dass Sie neben OpenCode auch einen laufenden Python-Dienst aufrechterhalten m\u00fcssen.<\/p>\n Die GigaChat-API selbst verf\u00fcgt nicht \u00fcber DeepSeek-Modelle: Es gibt nur die GigaChat-Familie und Modelle f\u00fcr Einbettungen. Wenn Sie DeepSeek in OpenCode ben\u00f6tigen, aber \u00fcber ein russisches Cloud-Gateway, ist der Foundation Models-Dienst von Cloud.ru geeignet. Es liefert Modelle mithilfe des OpenAI-kompatiblen Protokolls und ist daher \u00fcber das Standardpaket @ai-sdk\/openai-kompatible<\/b> verbunden.<\/p>\n Im Cloud.ru Foundation Models-Katalog gibt es beispielsweise folgende Modelle:<\/p>\n Der Schl\u00fcssel wird in der Cloud.ru-Konsole ausgegeben: Abschnitt Benutzer, Registerkarte Dienstkonten. Wir erstellen ein Dienstkonto auf Projektebene und erstellen dann in seinen Anmeldeinformationen einen API-Schl\u00fcssel mit dem Foundation Models-Dienst. Das Schl\u00fcsselgeheimnis wird einmalig angezeigt und wir speichern es.<\/p>\n Die Anbieterkonfiguration in opencode.json sieht folgenderma\u00dfen aus:<\/p>\n Wir \u00fcbergeben den Schl\u00fcssel an die Umgebungsvariable:<\/p>\n Zertifikate des Ministeriums f\u00fcr digitale Entwicklung sind hier nicht erforderlich: Die Domain api.cloud.ru verf\u00fcgt im Gegensatz zu GigaChat \u00fcber regul\u00e4res TLS. Es lohnt sich jedoch, die Ausgewogenheit des Projekts zu \u00fcberwachen. Wenn das Konto Null ist, ist die Autorisierung erfolgreich und Anfragen werden mit der Abrechnungsantwort verworfen:<\/p>\n Dies ist kein Konfigurationsfehler, sondern ein Signal, dass Sie das Projekt in der Cloud.ru-Konsole aktualisieren m\u00fcssen.<\/p>\n Ein paar praktische Punkte, die bei der Ersteinrichtung am h\u00e4ufigsten im Weg stehen:<\/p>\n https:\/\/opencode.ai\/<\/a> https:\/\/opencode.ai\/docs\/providers\/#custom-provider<\/a> OpenCode ist ein offener Programmieragent, der direkt im Terminal arbeitet: Projektdateien liest, Code bearbeitet, Befehle und Tests ausf\u00fchrt, das Repository durchsucht und mit Git arbeitet. Seine St\u00e4rke liegt darin, dass es nicht an einen Modellanbieter gebunden ist und Dutzende Anbieter verbinden kann. GigaChat ist ein gro\u00dfes Sprachmodell von Sber. Es ist nicht in der Liste […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[8],"tags":[],"class_list":["post-196","post","type-post","status-publish","format-standard","hentry","category-notes"],"translation":{"provider":"WPGlobus","version":"3.0.6","language":"de","enabled_languages":["en","ru","zh","de","ja","fr","es","pt","hi"],"languages":{"en":{"title":true,"content":true,"excerpt":false},"ru":{"title":true,"content":true,"excerpt":false},"zh":{"title":true,"content":true,"excerpt":false},"de":{"title":true,"content":true,"excerpt":false},"ja":{"title":true,"content":true,"excerpt":false},"fr":{"title":true,"content":true,"excerpt":false},"es":{"title":true,"content":true,"excerpt":false},"pt":{"title":true,"content":true,"excerpt":false},"hi":{"title":true,"content":true,"excerpt":false}}},"_links":{"self":[{"href":"https:\/\/demensdeum.com\/blog\/de\/wp-json\/wp\/v2\/posts\/196","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/demensdeum.com\/blog\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/demensdeum.com\/blog\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/demensdeum.com\/blog\/de\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/demensdeum.com\/blog\/de\/wp-json\/wp\/v2\/comments?post=196"}],"version-history":[{"count":0,"href":"https:\/\/demensdeum.com\/blog\/de\/wp-json\/wp\/v2\/posts\/196\/revisions"}],"wp:attachment":[{"href":"https:\/\/demensdeum.com\/blog\/de\/wp-json\/wp\/v2\/media?parent=196"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/demensdeum.com\/blog\/de\/wp-json\/wp\/v2\/categories?post=196"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/demensdeum.com\/blog\/de\/wp-json\/wp\/v2\/tags?post=196"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\n
\nAuthorization: Basic \u0432\u0430\u0448_\u043a\u043b\u044e\u0447_\u0430\u0432\u0442\u043e\u0440\u0438\u0437\u0430\u0446\u0438\u0438\n<\/code><\/pre>\n<\/div>\nZertifikate des Ministeriums f\u00fcr digitale Entwicklung<\/h2>\n
\nself-signed certificate in certificate chain\n<\/code><\/pre>\n<\/div>\n\ncurl -s https:\/\/gu-st.ru\/content\/lending\/russian_trusted_root_ca_pem.crt -o russian_trusted_root_ca_pem.crt\ncurl -s https:\/\/gu-st.ru\/content\/lending\/russian_trusted_sub_ca_pem.crt -o russian_trusted_sub_ca_pem.crt\ncat russian_trusted_root_ca_pem.crt russian_trusted_sub_ca_pem.crt > russian_trusted_ca_bundle.pem\n<\/code><\/pre>\n<\/div>\n\n-----END CERTIFICATE----------BEGIN CERTIFICATE-----\n<\/code><\/pre>\n<\/div>\n\nPEM routines:CRYPTO_internal:bad end line\n<\/code><\/pre>\n<\/div>\n\nopenssl x509 -in russian_trusted_root_ca_pem.crt -out russian_trusted_root_ca.pem\nopenssl x509 -in russian_trusted_sub_ca_pem.crt -out russian_trusted_sub_ca.pem\ncat russian_trusted_root_ca.pem russian_trusted_sub_ca.pem > russian_trusted_ca_bundle.pem\n<\/code><\/pre>\n<\/div>\n\nopenssl x509 -in russian_trusted_ca_bundle.pem -noout -subject\n<\/code><\/pre>\n<\/div>\n\nopenssl x509 -in cert.crt -inform DER -outform PEM -out cert.pem\nopenssl pkcs7 -print_certs -in bundle.p7b -out cert.pem\n<\/code><\/pre>\n<\/div>\nMit OpenCode verbinden<\/h2>\n
\n
\n{\n \"$schema\": \"https:\/\/opencode.ai\/config.json\",\n \"provider\": {\n \"gigachat\": {\n \"npm\": \"gigachat-ai-sdk-provider\",\n \"name\": \"GigaChat\",\n \"models\": {\n \"GigaChat-2-Max\": { \"name\": \"GigaChat 2 Max\" },\n \"GigaChat-2-Pro\": { \"name\": \"GigaChat 2 Pro\" },\n \"GigaChat-2\": { \"name\": \"GigaChat 2 Lite\" },\n \"GigaChat\": { \"name\": \"GigaChat\" }\n }\n }\n }\n}\n<\/code><\/pre>\n<\/div>\n\nexport GIGACHAT_CREDENTIALS=\u0432\u0430\u0448_\u043a\u043b\u044e\u0447_\u0430\u0432\u0442\u043e\u0440\u0438\u0437\u0430\u0446\u0438\u0438\nexport GIGACHAT_SCOPE=GIGACHAT_API_PERS\nexport NODE_EXTRA_CA_CERTS=\/\u043f\u0443\u0442\u044c\/\u043a\/russian_trusted_ca_bundle.pem\nopencode\n<\/code><\/pre>\n<\/div>\nModelle<\/h2>\n
\n
\n{\"status\":404,\"message\":\"No such model\"}\n<\/code><\/pre>\n<\/div>\n\ncurl -H \"Authorization: Bearer <\u0442\u043e\u043a\u0435\u043d_\u0434\u043e\u0441\u0442\u0443\u043f\u0430>\" https:\/\/gigachat.devices.sberbank.ru\/api\/v1\/models\n<\/code><\/pre>\n<\/div>\n\n\/models\n<\/code><\/pre>\n<\/div>\nErster Start im Projekt<\/h2>\n
\ncd \u0432\u0430\u0448_\u043f\u0440\u043e\u0435\u043a\u0442\nopencode\n<\/code><\/pre>\n<\/div>\n\n\/init\n<\/code><\/pre>\n<\/div>\nAlternative: lokaler Proxy<\/h2>\n
\n{\n \"$schema\": \"https:\/\/opencode.ai\/config.json\",\n \"provider\": {\n \"gigachat\": {\n \"npm\": \"@ai-sdk\/openai-compatible\",\n \"name\": \"GigaChat (proxy)\",\n \"options\": {\n \"baseURL\": \"http:\/\/localhost:8090\/v1\"\n },\n \"models\": {\n \"GigaChat-2-Max\": { \"name\": \"GigaChat 2 Max\" }\n }\n }\n }\n}\n<\/code><\/pre>\n<\/div>\nDeepSeek und andere Modelle \u00fcber Cloud.ru<\/h2>\n
\ndeepseek-ai\/DeepSeek-V4.1-Flash\ndeepseek-ai\/DeepSeek-V4-Flash\ndeepseek-ai\/DeepSeek-V4-Pro\n<\/code><\/pre>\n<\/div>\n\n{\n \"$schema\": \"https:\/\/opencode.ai\/config.json\",\n \"provider\": {\n \"cloudru\": {\n \"npm\": \"@ai-sdk\/openai-compatible\",\n \"name\": \"Cloud.ru Foundation Models\",\n \"options\": {\n \"baseURL\": \"https:\/\/foundation-models.api.cloud.ru\/v1\",\n \"apiKey\": \"{env:CLOUDRU_API_KEY}\"\n },\n \"models\": {\n \"deepseek-ai\/DeepSeek-V4.1-Flash\": { \"name\": \"DeepSeek V4.1 Flash\", \"limit\": { \"context\": 1048576, \"output\": 1048576 } },\n \"deepseek-ai\/DeepSeek-V4-Flash\": { \"name\": \"DeepSeek V4 Flash\", \"limit\": { \"context\": 1048576, \"output\": 1048576 } },\n \"deepseek-ai\/DeepSeek-V4-Pro\": { \"name\": \"DeepSeek V4 Pro\", \"limit\": { \"context\": 1048576, \"output\": 1048576 } }\n }\n }\n }\n}\n<\/code><\/pre>\n<\/div>\n\nexport CLOUDRU_API_KEY=\u0432\u0430\u0448_\u043a\u043b\u044e\u0447_cloudru\nopencode\n<\/code><\/pre>\n<\/div>\n\n{\"message\":\"Not enough money\"}\n<\/code><\/pre>\n<\/div>\nWorauf Sie achten sollten<\/h2>\n
\n
Links<\/h2>\n
\nhttps:\/\/opencode.ai\/docs\/providers\/<\/a>
\nhttps:\/\/developers.sber.ru\/studio\/<\/a>
\nhttps:\/\/developers.sber.ru\/docs\/ru\/gigachat\/guides\/main<\/a>
\nhttps:\/\/github.com\/nyddle\/gigachat-ai-sdk-provider<\/a>
\nhttps:\/\/github.com\/ai-forever\/gpt2giga<\/a>
\nhttps:\/\/cloud.ru\/docs\/foundation-models\/ug\/topics\/quickstart<\/a><\/p>\nQuellen<\/h2>\n
\nhttps:\/\/developers.sber.ru\/docs\/ru\/gigachat\/certificates<\/a>
\nhttps:\/\/developers.sber.ru\/docs\/ru\/gigachat\/models\/main<\/a>
\nhttps:\/\/developers.sber.ru\/docs\/ru\/gigachat\/guides\/selecting-a-model<\/a>
\nhttps:\/\/github.com\/nyddle\/gigachat-ai-sdk-provider<\/a>
\nhttps:\/\/github.com\/ai-forever\/gpt2giga<\/a>
\nhttps:\/\/cloud.ru\/docs\/foundation-models\/ug\/topics\/quickstart<\/a>
\nhttps:\/\/cloud.ru\/docs\/foundation-models\/ug\/topics\/overview__available__models<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"