Как подключить API к вашей программеHow to connect the API to your app

Два значения: адрес API и твой ключ. Вставь ключ в поле ниже — все команды и файлы на этой странице соберутся под тебя, останется нажать кнопку.Two values: the API address and your key. Paste your key into the field below and every command and file on this page will be built for you — just press the button.

Base URL
API KeyAPI Key

При настройке ключ не отправляется с этой страницы: команды и файлы собираются локально в браузере. Без галочки выше ключ исчезнет после закрытия страницы. Скачанные файлы содержат ключ — не пересылай их и не добавляй в Git. Нет ключа — зарегистрируйся: личный ключ выпустится сам.During setup, this page does not send your key anywhere: commands and files are generated locally in your browser. Without the checkbox above, the key disappears when you close the page. Downloaded files contain the key — do not share or commit them. No key yet? Register — your personal key is issued automatically.

Не знаешь, что выбрать? Найди себя в спискеNot sure what to pick? Find yourself in the list

Пишу код в Cursorдва поля в настройках, всё мышкойI code in Cursortwo fields in settings, all with the mouse→ Работаю в VS Codeрасширение Cline — вставить два значенияI use VS Codethe Cline extension — paste two values→ У меня Claude Codeскачать файл настроек или две командыI have Claude Codedownload a settings file or run two commands→ У меня Codex (CLI или в VS Code)на Windows — .bat одним кликом, он всё сделает самI have Codex (CLI or VS Code)on Windows — a one-click .bat that does everything→ У меня ZCodeмастер настройки: вставить четыре значенияI have ZCodesetup wizard: paste four values→ Пишу свой код или ботаготовые сниппеты Python и JavaScriptI write my own code or a botready-made Python and JavaScript snippets→ Работаю в JetBrains (Rider, IDEA, PyCharm)встроенный AI Assistant или плагин ContinueI use JetBrains (Rider, IDEA, PyCharm)built-in AI Assistant or the Continue plugin→ Работаю в Antigravityсвоей настройки там нет — подключение через ClineI use Antigravityno native setting there — connect via Cline→ Другая программалюбое приложение с полями «Base URL» и «API Key»Another appanything with “Base URL” and “API Key” fields→
Что такое «CLI» и «терминал» — для тех, кто впервые слышитWhat “CLI” and “terminal” mean — for first-timers
Терминал — это чёрное окно, где команды вводят текстом. CLI — программа без окон, которая живёт в этом окне: Codex CLI, Claude Code и ZCode — всё это CLI. Если терминал никогда не открывал — бери Cursor или VS Code: там всё делается мышкой, ни одной команды.A terminal is the black window where you type commands. A CLI is a windowless app that lives in that window: Codex CLI, Claude Code and ZCode are all CLIs. If you have never opened a terminal, go with Cursor or VS Code — everything there is done with the mouse, zero commands.
Нужна ссылка на одну инструкцию? Постоянные страницы по программамNeed a single-instruction link? Per-app pages
Под каждую программу — отдельная страница, удобно кидать одним линком: Codex · Claude Code · Cursor · Cline (VS Code) · ZCode · терминал и cURL · Python · JavaScript · JetBrains · AntigravityA dedicated page per app — handy to share as a single link: Codex · Claude Code · Cursor · Cline (VS Code) · ZCode · terminal & cURL · Python · JavaScript · JetBrains · Antigravity
Какая у тебя система?Your operating system?
Cursor VS Code Claude Code Codex ZCode JetBrains Antigravity Python JavaScript ПроверкаTest Другое приложениеOther app

Cursor

Редактор с ИИ. Всё мышкой в настройках — терминал не нужен.

  1. Открой Settings → Models (шестерёнка).Open Settings → Models (the gear icon).
  2. Внизу в разделе «OpenAI API Key» нажми «Override Base URL» — появится поле Base URL.At the bottom, in the “OpenAI API Key” section, click “Override Base URL” — a Base URL field appears.
  3. Base URL: вставь Base URL: paste
  4. API Key: вставь свой ключ и нажми Verify.API Key: paste your key and click Verify.
  5. Включи нужные модели списком или выбери в чате (ID — в таблице моделей).Enable the models you need as a list or pick one in chat (IDs are in the model table).

Проверка не проходит? Base URL должен заканчиваться на /v1, а ключ — без пробелов.Verification failing? The Base URL must end with /v1, and the key must have no spaces.

VS Code

Через бесплатное расширение-агент. Встроенный Copilot адрес API менять не умеет.

1

Способ А — Cline (проще всего)

Ставишь расширение, вставляешь два значения — готово.

  1. Слева нажми «Расширения» (или Ctrl+Shift+X) → в поиске набери Cline → Install.On the left, click “Extensions” (or Ctrl+Shift+X) → search for Cline → Install.
  2. Кликни по иконке Cline → шестерёнка (Settings).
  3. API Provider: выбери OpenAI Compatible.API Provider: choose OpenAI Compatible.
  4. Base URL: вставь Base URL: paste
  5. API Key: вставь свой ключ.API Key: paste your key.
  6. Model ID: укажи модель, например gpt-5.6-terra (список — в таблице). Готово.Model ID: enter a model, e.g. gpt-5.6-terra (the list is in the table). Done.
2

Способ Б — Continue

Если пользуешься Continue: один блок в конфиг.

  1. Установи расширение Continue, кликни по его иконке → шестерёнка (откроется файл настроек config.yaml).Install the Continue extension, click its icon → the gear (this opens the config.yaml settings file).
  2. Вставь блок в конец файла (Base URL и ключ уже подставлены из поля выше). Если в конфиге уже есть раздел models: — добавь строки, начиная с дефиса, внутрь него:Paste the block at the end of the file (the Base URL and the key are already filled in from the field above). If the config already has a models: section — add the lines, starting with the dash, inside it:

Сохрани конфиг — чат Continue отвечает через наш API.

Claude Code

ИИ-помощник в терминале. Настраивается один раз, два способа на выбор.

1

Файл настроек — без терминала

Скачай файл, положи в папку — готово. Проще некуда.

  1. Открой папку: нажми Win+R, вставь %USERPROFILE%\.claude, Enter. Папки нет — создай.Open the folder: press Win+R, paste %USERPROFILE%\.claude, Enter. No folder? Create one.
  2. Открой папку: в Finder нажми Cmd+Shift+G, вставь ~/.claude, Enter. Папки нет — создай.Open the folder: in Finder press Cmd+Shift+G, paste ~/.claude, Enter. No folder? Create one.
  3. Скачай файл настроек кнопкой (твой ключ из поля выше уже внутри):
Скачается обычный текстовый файл настроек — положи его в папку из шага 1.

Если делаешь руками: создай в папке файл settings.json блокнотом и вставь текст выше. Готово — запусти claude.Doing it by hand: create a settings.json file in the folder with Notepad and paste the text above. Done — run claude.

2

Команды в терминале

Скопировал блок — вставил в окно.

Windows. Открой PowerShell: Пуск → набери powershell → Enter. Вставь обе команды (правая кнопка мыши в окне = вставка) и нажми Enter:Windows. Open PowerShell: Start → type powershell → Enter. Paste both commands (right-click in the window = paste) and press Enter:

macOS / Linux. Открой Terminal (Cmd+Пробел → набери terminal). Вставь блок и нажми Enter — он пропишет настройки сразу в оба файла запуска терминала (~/.zshrc и ~/.bashrc, у разных систем используется один из них):macOS / Linux. Open Terminal (Cmd+Space → type terminal). Paste the block and press Enter — it writes the settings into both shell startup files (~/.zshrc and ~/.bashrc, different systems use one of them):

Обязательно для обоих способов: полностью закрой все окна терминала и открой заново — настройки работают только в новых окнах. Потом запусти claude.Required for both methods: close all terminal windows completely and open a new one — the settings only work in new windows. Then run claude.

Модель — как обычно, например /model claude-sonnet-5. Доступны claude-opus-5, claude-sonnet-5, claude-haiku-4-5 и другие — полный список в таблице. Подробный гайд с объяснением каждого шага и решением ошибок — «Claude Code в России».Model — as usual, e.g. /model claude-sonnet-5. Available: claude-opus-5, claude-sonnet-5, claude-haiku-4-5 and more — the full list is in the table. A detailed guide explaining every step and fixing errors: “Claude Code in Russia”.

Codex — CLI и версия для VS Code

Настройка общая: сделал один раз — работает и в терминале, и в редакторе.

Сам Codex ещё не установлен? Поставь одной командой в терминале: npm install -g @openai/codex (нужен Node.js — скачай с nodejs.org и установи, это бесплатно).Codex itself not installed yet? Install it with one terminal command: npm install -g @openai/codex (you need Node.js — download it from nodejs.org and install, it's free).

1

Установщик одним кликом

Только для Windows. Вставь ключ в поле вверху страницы → скачай файл → двойной клик. Всё.

Твой ключ из поля выше уже внутри файла.

Это не вирус. Скачается файл codex-setup.bat — обычный текстовый скрипт настройки, а не программа. Хочешь убедиться — открой его Блокнотом: внутри только создание файла конфига и запись твоего ключа, никаких отправок в интернет.It's not a virus. The downloaded codex-setup.bat is a plain text setup script, not a program. Want to make sure? Open it in Notepad: inside there is only creating a config file and writing your key — nothing is sent to the internet.

Если у тебя уже есть свой файл %USERPROFILE%\.codex\config.toml — установщик сначала сохранит его копию рядом: config.toml.aidostup-backup, а затем создаст новый конфиг.If you already have your own %USERPROFILE%\.codex\config.toml — the installer first saves a copy next to it (config.toml.aidostup-backup) and then creates the new config.

  1. Вставь свой ключ в поле API Key вверху этой страницы.Paste your key into the API Key field at the top of this page.
  2. Нажми «Скачать codex-setup.bat».
  3. Запусти скачанный файл двойным кликом — он сам создаст конфиг и пропишет ключ. Дождись сообщения «Готово».
  4. Полностью закрой Codex CLI или VS Code, открой заново и запускай codex.Close Codex CLI or VS Code completely, reopen it and run codex.
Показать, что внутри .bat (для сомневающихся)
2

Вручную

Один файл конфига + одна команда с ключом.

Шаг 1. Открой файл конфига: нажми Win+R, вставь notepad %USERPROFILE%\.codex\config.toml, Enter — блокнот предложит создать файл, соглашайся.Step 1. Open the config file: press Win+R, paste notepad %USERPROFILE%\.codex\config.toml, Enter — Notepad will offer to create the file, accept.

Шаг 1. Открой файл ~/.codex/config.toml в любом текстовом редакторе (папки .codex нет — создай).Step 1. Open ~/.codex/config.toml in any text editor (no .codex folder? Create one).

Шаг 2. Вставь блок (адрес API уже подставлен) и сохрани:

Шаг 3. Ключ одной командой. Открой PowerShell: Пуск → набери powershell → Enter:Step 3. The key, one command. Open PowerShell: Start → type powershell → Enter:

Шаг 3. Ключ — вставь блок в Terminal и нажми Enter (пропишет и в ~/.zshrc, и в ~/.bashrc):Step 3. The key — paste the block into Terminal and press Enter (it writes to both ~/.zshrc and ~/.bashrc):

Шаг 4. Полностью закрой все окна терминала, открой заново, запусти codex.Step 4. Close all terminal windows completely, reopen them and run codex.

3

Codex в VS Code (IDE-версия)

Расширение читает тот же config.toml — отдельно настраивать нечего.

  1. Настрой по любому способу выше — этого достаточно.
  2. В VS Code: «Расширения» (Ctrl+Shift+X) → в поиске Codex → установи официальное расширение OpenAI.In VS Code: “Extensions” (Ctrl+Shift+X) → search for Codex → install the official OpenAI extension.
  3. Полностью закрой VS Code и открой заново — иначе расширение не увидит ключ.Close VS Code completely and reopen it — otherwise the extension won't see the key.
  4. Открой панель Codex, выбери модель (например gpt-5.6-terra) — работает через наш API.Open the Codex panel and pick a model (e.g. gpt-5.6-terra) — it works through our API.

Модель меняется полем model = "…" в config.toml или выбором в самом Codex — ID в таблице моделей. Для агентов рекомендуются gpt-5.6-terra, claude-sonnet-5.The model is changed via model = "…" in config.toml or in Codex itself — IDs are in the model table. For agents we recommend gpt-5.6-terra, claude-sonnet-5.

ZCode

ИИ-агент для кодинга. Подключается через мастер настройки при первом запуске — без команд.

  1. Установи и запусти ZCode.
  2. При первом запуске откроется настройка подключения — выбери добавление своего провайдера (OpenAI-совместимого). Если ZCode уже запущен — то же самое в настройках: добавление провайдера модели.
  3. Укажи четыре значения:
Base URL
Формат APIChat completions (/chat/completions)
API Keyтвой ключ из поля вверху страницы
Модельgpt-5.6-terra

Не выбирай формат «Anthropic Messages» — с ним ZCode выдает ошибку TLS. Рабочий формат только Chat completions.

Модель можно поменять в настройках ZCode: рекомендуются claude-sonnet-5 или gpt-5.6-terra — список в таблице моделей.You can change the model in ZCode's settings: we recommend claude-sonnet-5 or gpt-5.6-terra — the list is in the model table.

JetBrains: Rider, IDEA, PyCharm, WebStorm

Два способа. Если первый в твоей версии не нашёлся — второй работает одинаково везде.

Способ 1 — встроенный AI AssistantMethod 1 — the built-in AI Assistant
File → Settings (на Windows Ctrl+Alt+S) → Tools → AI Assistant → Providers & API keys. В разделе сторонних моделей выбери OpenAI-compatible.File → Settings (on Windows Ctrl+Alt+S) → Tools → AI Assistant → Providers & API keys. In the third-party models section, choose OpenAI-compatible.
Заполни Base URL, API Key и модель: Fill in the Base URL, the API Key and a model: , твой ключ (кнопка «Копировать» ниже) и, например, gpt-5.6-terra. Нажми Test Connection, затем Apply., your key (the “Copy key” button below) and, e.g., gpt-5.6-terra. Click Test Connection, then Apply.
В списке моделей впиши вручную ID из каталога моделей, например: gpt-5.6-terra, claude-sonnet-5. Сохрани — модель появится в выборе моделей чата.In the model list, enter the IDs from the model catalog manually, e.g.: gpt-5.6-terra, claude-sonnet-5. Save — the model appears in the chat model picker.

Названия пунктов немного отличаются между версиями IDE. Если в твоей версии нет «OpenAI-compatible» или проверка не проходит — используй Continue ниже.

Способ 2 — плагин Continue (проще и надёжнее)Method 2 — the Continue plugin (easier and more reliable)
File → Settings → Plugins → вкладка Marketplace → в поиске набери Continue → Install → перезапусти Rider. Справа появится панель Continue.File → Settings → Plugins → the Marketplace tab → search for Continue → Install → restart the IDE. A Continue panel appears on the right.
В панели Continue нажми шестерёнку (Open Config) — откроется файл config.yaml. Замени его содержимое на текст ниже (твой ключ уже внутри — просто нажми «Копировать» и вставь):In the Continue panel, click the gear (Open Config) — the config.yaml file opens. Replace its contents with the text below (your key is already inside — just click “Copy” and paste):
Сохрани файл (Ctrl+S) — Continue подхватит модели сам. В списке моделей панели выбери GPT-5.6 Terra и напиши что-нибудь — пришёл ответ, всё работает.Save the file (Ctrl+S) — Continue picks up the models on its own. In the panel's model list, choose GPT-5.6 Terra and write something — an answer comes back, everything works.

Нужно больше моделей — добавь в список ещё такие же блоки, поменяв title и model (ID брать из каталога моделей). Если Continue предложит войти в аккаунт — закрой окно входа, без него всё работает.Need more models — add more blocks like these to the list, changing title and model (take the IDs from the model catalog). If Continue offers to sign in — close the sign-in window, everything works without it.

Antigravity

Редактор-агент от Google. Настройки для своего API в нём нет — наш ключ подключается через расширение Cline.

Antigravity не умеет чужие API-ключи: в его настройках нет полей «Base URL» и «API Key», и Google официально это не поддерживает. Обойти это штатной настройкой нельзя. Рабочий путь — бесплатное расширение Cline: оно официально поддерживает Antigravity и принимает наш API.Antigravity cannot take third-party API keys: its settings have no “Base URL” or “API Key” fields, and Google officially does not support this. There is no built-in setting to bypass it. The working path is the free Cline extension: it officially supports Antigravity and accepts our API.

1

Установи расширение Cline

Бесплатно, из магазина расширений прямо внутри Antigravity.

  1. Слева нажми «Extensions» (или Ctrl+Shift+X) → в поиске набери Cline → Install.On the left, click “Extensions” (or Ctrl+Shift+X) → search for Cline → Install.
  2. Кликни по иконке Cline → шестерёнка (Settings).
  3. API Provider: выбери OpenAI Compatible.API Provider: choose OpenAI Compatible.
  4. Base URL: вставь Base URL: paste
  5. API Key: вставь свой ключ (твой — из поля вверху страницы).API Key: paste your key (yours is in the field at the top of the page).
  6. Model ID: укажи модель, например gpt-5.6-terra (список — в таблице). Готово — пиши задачи в панели Cline.Model ID: enter a model, e.g. gpt-5.6-terra (the list is in the table). Done — write your tasks in the Cline panel.

Встроенный ИИ Antigravity (агент, браузер, автопилот) продолжит работать по твоей подписке Google — наш ключ его не меняет и не ломает. Cline не нашёлся в поиске — скачай файл расширения (.vsix) со страницы Cline на GitHub: меню «…» в панели расширений → Install from VSIX…. Привык к Continue — он тоже ставится в Antigravity, настройка как во вкладке VS Code.Antigravity's built-in AI (agent, browser, autopilot) keeps working on your Google plan — our key doesn't change or break it. Can't find Cline in search? Download the extension file (.vsix) from Cline's GitHub page: the “…” menu in the Extensions panel → Install from VSIX…. Prefer Continue — it installs into Antigravity too; set it up as in the VS Code tab.

Python (OpenAI SDK)

Для своих скриптов и ботов. Ключ уже подставлен из поля выше.

  1. Установи библиотеку: pip install openaiInstall the library: pip install openai
  2. Используй сниппет:

Стриминг: stream=True. Vision: картинка передаётся в content. Список моделей — здесь.Streaming: stream=True. Vision: the image goes into content. The model list — here.

JavaScript / TypeScript (OpenAI SDK)

Ключ уже подставлен из поля выше.

  1. Установи Node.js (скачай с nodejs.org и установи — это бесплатно), затем в терминале установи библиотеку: npm install openaiInstall Node.js (download it from nodejs.org and install — it's free), then install the library in the terminal: npm install openai
  2. Создай файл test.js, вставь сниппет и сохрани:Create a test.js file, paste the snippet and save:
  1. Запусти в терминале: node test.js. Пришёл ответ с текстом — всё работает.Run it in the terminal: node test.js. If an answer with text comes back — everything works.

Быстрая проверка ключа (cURL)

Для тех, кто дружит с терминалом. Не дружишь — есть способ проще.

Проще некуда: страница «Баланс и логи» — вставь ключ, увидишь остаток и списания без единой команды. А если хочется терминала:Simplest possible: the “Balance & logs” page — paste your key and see the remaining balance and usage without a single command. And if you want the terminal:

Вернулся текст модели — всё работает. Остаток токенов:

Windows: команды вставляй в Git Bash (ставится вместе с Git) — в PowerShell перенос строки через «\» не работает.Windows: paste the commands into Git Bash (installed together with Git) — in PowerShell the “\” line break doesn't work.

Любое другое приложение

Есть поля «Base URL» и «API Key»? Значит подключится.

Base URL
API Keyтвой ключ (или скопируй из поля вверху страницы)
ФорматOpenAI-совместимый (chat/completions, responses)
  1. Вставь Base URL — он заканчивается на /v1. Если приложение просит адрес без /v1 — вставь без него: Paste the Base URL — it ends with /v1. If the app asks for the address without /v1 — paste it without:
  2. Вставь ключ.
  3. Выбери модель из таблицы моделей.Pick a model from the model table.

Поддерживаются: чат, стриминг (SSE), function calling, vision (картинки), Anthropic-формат (/v1/messages), WebSocket-транспорт Codex.Supported: chat, streaming (SSE), function calling, vision (images), the Anthropic format (/v1/messages), the Codex WebSocket transport.