# API-шлюз
## Что такое API-шлюз?
AQBot включает встроенный локальный API-сервер, который предоставляет настроенных провайдеров как **OpenAI-совместимые**, **нативные Claude** и **нативные Gemini** endpoints. Любой инструмент или клиент, использующий один из этих протоколов, может использовать AQBot в качестве бэкенда — без отдельных ключей API или ретрансляционных сервисов.
Сценарии использования:
- Запускайте **Claude Code CLI**, **OpenAI Codex CLI**, **Gemini CLI** или **OpenCode** через AQBot.
- Подключайте расширения IDE к единому локально управляемому endpoint.
- Делитесь набором ключей провайдера между множеством инструментов с ограничением частоты запросов на ключ.
---
## Начало работы
1. Откройте **Настройки → API-шлюз** (или нажмите Cmd/Ctrl+Shift+G).
2. Нажмите **Запустить** для запуска сервера шлюза.
3. По умолчанию сервер слушает на `127.0.0.1:8080` (HTTP).
> **Совет**
>
> Включите **Автозапуск** в настройках шлюза, чтобы сервер запускался автоматически при старте AQBot.
---
## Управление ключами API
1. Перейдите на вкладку **Ключи API**.
2. Нажмите **Создать новый ключ**.
3. Опционально добавьте **описание** для идентификации каждого ключа.
4. Скопируйте ключ — он отображается только один раз.
---
## Шаблоны конфигурации
### Claude Code CLI
```bash
claude config set --global apiUrl http://127.0.0.1:8080
claude config set --global apiKey aqbot-xxxx
```
### OpenAI Codex CLI
```bash
export OPENAI_BASE_URL=http://127.0.0.1:8080/v1
export OPENAI_API_KEY=aqbot-xxxx
codex
```
### Gemini CLI
```bash
export GEMINI_API_BASE=http://127.0.0.1:8080
export GEMINI_API_KEY=aqbot-xxxx
gemini
```
### Пользовательский клиент
```
Base URL: http://127.0.0.1:8080/v1
Ключ API: aqbot-xxxx
```
---
## Следующие шаги
- [Быстрый старт](./getting-started) — вернуться к руководству по быстрому старту
- [Настройка провайдеров](./providers) — добавить upstream-провайдеров, к которым маршрутизирует шлюз
- [MCP-серверы](./mcp) — подключить внешние инструменты для вызова ИИ-инструментов