![](\"https:\/\/demensdeum.com\/blog\/wp-content\/uploads\/2026\/10\/aibank.jpg\"\/)
<\/p>\nOpenCode est un agent de programmation ouvert qui fonctionne directement dans le terminal : lit les fichiers du projet, \u00e9dite le code, ex\u00e9cute des commandes et des tests, recherche dans le r\u00e9f\u00e9rentiel et fonctionne avec git. Sa force r\u00e9side dans le fait qu\u2019il n\u2019est pas li\u00e9 \u00e0 un seul fournisseur mod\u00e8le et qu\u2019il peut connecter des dizaines de fournisseurs.<\/p>\n
<\/p>\n
GigaChat est un grand mod\u00e8le de langage de Sber. Il ne figure pas dans la liste pr\u00eate des fournisseurs OpenCode, mais ce n’est pas un probl\u00e8me : OpenCode connecte des fournisseurs arbitraires via les packages Vercel AI SDK. Pour GigaChat, il existe un package gigachat-ai-sdk-provider<\/b>, qui s’occupe de l’autorisation OAuth et de la mise \u00e0 jour du jeton d’acc\u00e8s. Une nuance distincte concerne les certificats du minist\u00e8re du D\u00e9veloppement num\u00e9rique : sans eux, Node ne fait pas confiance aux serveurs GigaChat et les demandes \u00e9chouent avec une erreur de v\u00e9rification du certificat.<\/p>\n
Dans cet article, je vais d\u00e9crire comment obtenir une cl\u00e9, installer des certificats et connecter GigaChat \u00e0 OpenCode.<\/p>\n
Pour travailler, vous avez besoin de trois choses :<\/p>\n
La cl\u00e9 est cr\u00e9\u00e9e dans votre compte personnel GigaChat Studio. Acc\u00e9dez \u00e0 Developers.sber.ru\/studio, connectez-vous et cr\u00e9ez un projet dans la section API GigaChat<\/b>. Dans les param\u00e8tres du projet, il y a un bloc avec les donn\u00e9es d’autorisation : la ligne qui est copi\u00e9e \u00e0 partir de l\u00e0 est une cl\u00e9 d’autorisation pr\u00eate \u00e0 l’emploi en base64. C’est celle-ci qui est substitu\u00e9e dans la variable d’environnement, et non la paire client-secret s\u00e9par\u00e9ment.<\/p>\n
Avec la cl\u00e9, la port\u00e9e<\/b> est sp\u00e9cifi\u00e9e – la zone d’acc\u00e8s\u00a0:<\/p>\n La valeur de cl\u00e9 affich\u00e9e doit \u00eatre enregistr\u00e9e imm\u00e9diatement : elle ne sera plus affich\u00e9e plus tard, et si n\u00e9cessaire, une nouvelle devra \u00eatre \u00e9mise.<\/p>\n Il est important de comprendre quelle est cette ligne. La cl\u00e9 d’autorisation n’est pas un secret distinct, mais une paire de client_id:client_secret<\/b> d\u00e9j\u00e0 encod\u00e9 en base64. La biblioth\u00e8que gigachat-js remplace cet en-t\u00eate dans la requ\u00eate OAuth\u00a0:<\/p>\n En r\u00e9ponse, un jeton d’acc\u00e8s JWE a une dur\u00e9e de vie d’environ une demi-heure, puis la biblioth\u00e8que le met \u00e0 jour automatiquement. Le package lui-m\u00eame v\u00e9rifie que la valeur est similaire \u00e0 base64 et avertit si la variable contient accidentellement un secret client \u00ab brut \u00bb. Par cons\u00e9quent, il est n\u00e9cessaire de transf\u00e9rer la cha\u00eene base64 pr\u00eate \u00e0 l’emploi du compte vers la variable de configuration et d’environnement, et non la paire client_id et client_secret s\u00e9par\u00e9ment.<\/p>\n L’API GigaChat utilise des certificats du minist\u00e8re du D\u00e9veloppement num\u00e9rique de la NCA. Le magasin de racines de confiance standard ne les a pas, donc lorsque vous essayez d’obtenir un jeton d’acc\u00e8s, la demande \u00e9choue avec une erreur telle que\u00a0:<\/p>\n Les certificats peuvent \u00eatre install\u00e9s au niveau du syst\u00e8me d’exploitation – ils seront alors approuv\u00e9s par le navigateur et les utilitaires syst\u00e8me. Mais OpenCode fonctionne sur Node et Bun, il est donc plus s\u00fbr et plus facile de sp\u00e9cifier le fichier de certificat directement dans la variable NODE_EXTRA_CA_CERTS<\/b>. T\u00e9l\u00e9chargez les certificats racine et \u00e9metteur et placez-les dans un seul fichier PEM\u00a0:<\/p>\n Le fichier peut \u00eatre plac\u00e9 dans un emplacement pratique et son chemin complet peut \u00eatre sp\u00e9cifi\u00e9 lors du d\u00e9marrage de l’agent.<\/p>\n Il y a un pi\u00e8ge ici. Les fichiers t\u00e9l\u00e9charg\u00e9s utilisent des sauts de ligne CRLF et le certificat racine n’a pas de saut de ligne de fin. Par cons\u00e9quent, un chat ordinaire concat\u00e8ne la fin du premier certificat et le d\u00e9but du second en une seule ligne\u00a0:<\/p>\n LibreSSL – et le syst\u00e8me openssl sur macOS, je vous le rappelle, est exactement LibreSSL – n’accepte pas un tel fichier et r\u00e9pond par une erreur :<\/p>\n Cela signifie que le chat seul ne suffit pas. Chaque certificat doit d’abord \u00eatre ex\u00e9cut\u00e9 via openssl\u00a0: il le recodera en PEM canonique avec des sauts de ligne LF et un saut de ligne final, puis fusionn\u00e9\u00a0:<\/p>\n Vous pouvez v\u00e9rifier que le fichier est lu comme ceci\u00a0:<\/p>\n Si les certificats proviennent d’une autre source et sont au format DER ou PKCS#7, ils peuvent \u00e9galement \u00eatre recod\u00e9s en PEM :<\/p>\n Le fournisseur est d\u00e9crit dans le fichier de configuration opencode.jsonc<\/b>. OpenCode lui-m\u00eame t\u00e9l\u00e9chargera et connectera le package npm sp\u00e9cifi\u00e9 dans le champ npm<\/b>, y trouvera l’usine createGigaChat<\/b> et lui transmettra les options. Il suffit de lister les mod\u00e8les par leurs identifiants depuis l’API.<\/p>\n Le fichier peut \u00eatre plac\u00e9 \u00e0 deux endroits :<\/p>\n Les deux fichiers utilisent le m\u00eame sch\u00e9ma et sont combin\u00e9s : le fichier de projet chevauche le fichier global uniquement avec les cl\u00e9s correspondantes, les param\u00e8tres restants sont enregistr\u00e9s. L’extension .jsonc est \u00e9galement prise en charge. Si GigaChat n’est n\u00e9cessaire que pour certains r\u00e9f\u00e9rentiels, il est plus pratique de conserver le fournisseur dans la configuration du projet plut\u00f4t que dans la configuration globale.<\/p>\n Les mod\u00e8les disponibles avec une cl\u00e9 personnelle sont r\u00e9pertori\u00e9s ici. Si vous avez un projet pour un entrepreneur individuel ou une personne morale ayant acc\u00e8s \u00e0 GigaChat 3, ajoutez les identifiants n\u00e9cessaires de la m\u00e9thode mod\u00e8les au bloc mod\u00e8les.<\/p>\n Il est plus pratique de ne pas stocker la cl\u00e9 elle-m\u00eame dans un fichier, mais de la transmettre \u00e0 une variable d’environnement : le package gigachat-js la lit automatiquement. La valeur de port\u00e9e peut \u00e9galement \u00eatre d\u00e9finie sur une variable. Il ne reste plus qu’\u00e0 d\u00e9finir le chemin d’acc\u00e8s aux certificats et \u00e0 lancer l’agent :<\/p>\n Cette option est \u00e9galement int\u00e9ressante car le secret ne se retrouve pas dans le stockage local auth.json : il vit uniquement dans l’environnement du processus. Ceci est plus pratique pour les lancements CI et ponctuels.<\/p>\n L’ensemble des mod\u00e8les disponibles d\u00e9pend de la cl\u00e9 de port\u00e9e. La cl\u00e9 personnelle (GIGACHAT_API_PERS) est disponible pour la famille GigaChat et GigaChat 2 :<\/p>\n La famille GigaChat 3 (GigaChat-3-Ultra, GigaChat-3-Pro, mod\u00e8les ouverts comme GigaChat3.5-432B-A28B-Reasoning) est visible dans le catalogue de la console, mais elle n’est pas disponible \u00e0 la cl\u00e9 personnelle : elle n\u00e9cessite un projet d’entrepreneur individuel ou une personne morale de port\u00e9e GIGACHAT_API_B2B ou GIGACHAT_API_CORP et un tarif adapt\u00e9. Sur une cl\u00e9 personnelle, un tel mod\u00e8le r\u00e9pond par une erreur :<\/p>\n Vous pouvez v\u00e9rifier ce que votre cl\u00e9 g\u00e9n\u00e8re r\u00e9ellement en interrogeant la liste des mod\u00e8les\u00a0:<\/p>\n Encore deux points. Les ID de mod\u00e8le dans l’API ne correspondent pas aux noms affich\u00e9s\u00a0: le mod\u00e8le l\u00e9ger est appel\u00e9 GigaChat-2<\/b> et non GigaChat-2-Lite. Et le catalogue dans la console ne montre pas la m\u00eame chose que ce qui est disponible sur votre cl\u00e9, vous devez donc vous concentrer sur la r\u00e9ponse de la m\u00e9thode des mod\u00e8les, et non sur la liste avec les prix.<\/p>\n Dans l’interface, la liste des mod\u00e8les s’ouvre avec la commande :<\/p>\n Pour le travail de routine dans le r\u00e9f\u00e9rentiel – navigation dans les fichiers, modifications mineures, ex\u00e9cution de tests – GigaChat-2 est largement suffisant. Pour les t\u00e2ches et la conception complexes, il est logique de passer \u00e0 Pro ou Max.<\/p>\n Acc\u00e9dez au r\u00e9pertoire du projet et lancez l’agent\u00a0:<\/p>\n La premi\u00e8re \u00e9tape consiste \u00e0 initialiser l’agent\u00a0:<\/p>\n OpenCode analysera la structure du projet et cr\u00e9era un fichier AGENTS.md<\/b> – instructions pour l’agent. Ce fichier vaut la peine d’\u00eatre engag\u00e9 dans git\u00a0: il aide l’agent \u00e0 comprendre les conventions et les mod\u00e8les adopt\u00e9s dans le projet.<\/p>\n Si, pour une raison quelconque, vous ne souhaitez pas utiliser le fournisseur npm, un proxy local donne le m\u00eame r\u00e9sultat. L’\u00e9quipe GigaChat dispose d’un service officiel gpt2giga<\/b> – FastAPI qui traduit les requ\u00eates au format OpenAI, Anthropic et Gemini dans l’API GigaChat et met \u00e0 jour le jeton d’acc\u00e8s lui-m\u00eame. Il est g\u00e9n\u00e9r\u00e9 localement sur le port 8090, apr\u00e8s quoi un fournisseur compatible OpenAI standard est configur\u00e9 dans OpenCode via le package @ai-sdk\/openai-compatible<\/b> avec l’adresse de base http:\/\/localhost:8090\/v1. L’inconv\u00e9nient de cette voie est que vous devez \u00e9galement conserver un service Python en cours d’ex\u00e9cution \u00e0 c\u00f4t\u00e9 d’OpenCode.<\/p>\n L’API GigaChat elle-m\u00eame n’a pas de mod\u00e8les DeepSeek : il existe uniquement la famille GigaChat et des mod\u00e8les pour les int\u00e9grations. Si vous avez besoin de DeepSeek dans OpenCode, mais via une passerelle cloud russe, le service Foundation Models de Cloud.ru convient. Il fournit des mod\u00e8les utilisant le protocole compatible OpenAI, il est donc connect\u00e9 \u00e0 l’aide du package standard @ai-sdk\/openai-compatible<\/b>.<\/p>\n Dans le catalogue Cloud.ru Foundation Models, il existe, par exemple, les mod\u00e8les suivants\u00a0:<\/p>\n La cl\u00e9 est \u00e9mise dans la console Cloud.ru : section Utilisateurs, onglet Comptes de service. Nous cr\u00e9ons un compte de service au niveau du projet, puis dans ses informations d’identification, nous cr\u00e9ons une cl\u00e9 API avec le service Foundation Models. La cl\u00e9 secr\u00e8te est affich\u00e9e une fois et nous la sauvegardons.<\/p>\n La configuration du fournisseur dans opencode.json ressemble \u00e0 ceci\u00a0:<\/p>\n On passe la cl\u00e9 \u00e0 la variable d’environnement :<\/p>\n Les certificats du minist\u00e8re du D\u00e9veloppement num\u00e9rique ne sont pas n\u00e9cessaires ici : le domaine api.cloud.ru a un TLS r\u00e9gulier, contrairement \u00e0 GigaChat. Mais cela vaut la peine de surveiller le reste du projet. Si le compte est nul, l’autorisation est accept\u00e9e et les demandes sont abandonn\u00e9es avec la r\u00e9ponse de facturation\u00a0:<\/p>\n Ce n’est pas une erreur de configuration, mais un signal indiquant que vous devez mettre \u00e0 jour le projet dans la console Cloud.ru.<\/p>\n Quelques points pratiques qui g\u00eanent le plus souvent lors de la premi\u00e8re mise en place :<\/p>\n https:\/\/opencode.ai\/<\/a> https:\/\/opencode.ai\/docs\/providers\/#custom-provider<\/a> OpenCode est un agent de programmation ouvert qui fonctionne directement dans le terminal : lit les fichiers du projet, \u00e9dite le code, ex\u00e9cute des commandes et des tests, recherche dans le r\u00e9f\u00e9rentiel et fonctionne avec git. Sa force r\u00e9side dans le fait qu\u2019il n\u2019est pas li\u00e9 \u00e0 un seul fournisseur mod\u00e8le et qu\u2019il peut connecter […]<\/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":"fr","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\/fr\/wp-json\/wp\/v2\/posts\/196","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/demensdeum.com\/blog\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/demensdeum.com\/blog\/fr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/demensdeum.com\/blog\/fr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/demensdeum.com\/blog\/fr\/wp-json\/wp\/v2\/comments?post=196"}],"version-history":[{"count":0,"href":"https:\/\/demensdeum.com\/blog\/fr\/wp-json\/wp\/v2\/posts\/196\/revisions"}],"wp:attachment":[{"href":"https:\/\/demensdeum.com\/blog\/fr\/wp-json\/wp\/v2\/media?parent=196"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/demensdeum.com\/blog\/fr\/wp-json\/wp\/v2\/categories?post=196"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/demensdeum.com\/blog\/fr\/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>\nCertificats du Minist\u00e8re du D\u00e9veloppement Num\u00e9rique<\/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>\nConnectez-vous \u00e0 OpenCode<\/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>\nMod\u00e8les<\/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>\nPremier lancement dans le projet<\/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\u00a0: proxy local<\/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 et autres mod\u00e8les via 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>\n\u00c0 quoi faire attention<\/h2>\n
\n
Liens<\/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>\nSources<\/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":"