setup-gateway CLI
setup-gateway за один проход прописывает OpenAI-совместимый шлюз в конфиги Claude Code, OpenCode и Codex CLI с резервной копией.
- 444 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Перезаписывает файлы настроек клиентов и кладет ключ API в конфиг открытым текстом.
- Передает ключ на `/v1/models` указанного шлюза, поэтому адрес нужно проверять.
Установка
- Работает в
Ручная установка
node bin/setup-gateway.mjsПервая команда Quick start из README. Сначала клонируйте репозиторий, установка пакетов не нужна.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Перезаписывает файлы настроек клиентов и кладет ключ API в конфиг открытым текстом.
- Передает ключ на `/v1/models` указанного шлюза, поэтому адрес нужно проверять.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
setup-gateway — CLI без зависимостей на Node.js 18 и новее, который настраивает любой шлюз с интерфейсом `/v1` на трех клиентах. Вы вводите адрес шлюза, ключ и модель, а команда запрашивает `GET <baseURL>/v1/models` и дает выбрать модель из списка. Для Claude Code пишется `~/.claude/settings.json` с `ANTHROPIC_BASE_URL`, `ANTHROPIC_API_KEY` и моделью. Для OpenCode создается блок провайдера в `opencode.json`, для Codex CLI блок `[model_providers.gateway]` в `config.toml` и каталог моделей `gateway-catalog.json`. Остальные настройки и комментарии TOML сохраняются, перед записью делается резервная копия, а `restore` возвращает ее.
Для кого. Разработчикам и командам, которые ходят в модели через LiteLLM, OpenRouter или внутренний прокси и хотят подключить его к трем клиентам одной командой.
Подходит, если
- Компания выдала адрес шлюза и ключ, и три клиента настраивают одинаково.
- Модель шлюза появляется в списке `/model` в Codex CLI.
- Настройку воспроизводят в CI через флаги и переменные `GATEWAY_BASE_URL`.
- Конфиг изменили неудачно, и прежний возвращают через `restore`.
Не подходит, если
- У клиента нет запроса к OpenAI-совместимому шлюзу.
- Нельзя хранить ключ открытым текстом в конфиге.
- Шлюз отдает только классический Chat Completions для Codex CLI.
Пример запроса к агенту
Настрой Codex CLI на мой шлюз по адресу https://gw.example.com с моделью deepseek-v4, сделай резервную копию и покажи `status` без ключа.Ограничения
Ключ API записывается в конфиг открытым текстом: README прямо предупреждает об этом и советует `status` с маскированием. Для Codex CLI нужен шлюз с Responses API (`wire_api = "responses"`), для каталога моделей Codex версии 0.105.0 и новее и перезапуск после настройки. Адрес `http://` дает предупреждение, а флаг `--yes` его пропускает. README на индонезийском. Последний коммит в августе 2026 года.
Как отключить. Выполните `node setup-gateway.mjs restore claude` (или `opencode`, `codex`), чтобы вернуть последнюю резервную копию. Ничего не установлено глобально: достаточно удалить клонированный каталог.
Частые вопросы
Что пишется в конфиг Claude Code?
`ANTHROPIC_BASE_URL`, `ANTHROPIC_API_KEY` и `model` в `~/.claude/settings.json` либо в каталоге `$CLAUDE_CONFIG_DIR`.
Как запустить без вопросов?
Передайте `--base-url`, `--api-key`, `--model` и `--yes` либо задайте `GATEWAY_BASE_URL`, `GATEWAY_API_KEY`, `GATEWAY_MODEL`.
Как вернуть прежнюю настройку?
`node setup-gateway.mjs restore codex` восстанавливает последнюю копию. В терминале откроется меню выбора копии.
Подойдет ли шлюз с Chat Completions?
Для Codex CLI нет: нужен Responses API. Поможет прокси-переводчик вроде LiteLLM.
Есть ли самопроверка?
Да, `--selftest` проверяет чистые функции без обращения к реальным конфигам, это удобно для CI.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыШлюз GoModel собирает MCP-серверы за одним защищенным адресом: агент видит нужные инструменты по ключу, а токены остаются в шлюзе.
Самохостящийся шлюз между ИИ-приложениями и моделями, MCP-инструментами и A2A-агентами: политики, бюджеты, маршрутизация и журнал
CLI запускает шлюз к моделям и MCP-инструментам с собственными API-ключами, переводом форматов, маршрутами и журналом запросов.
Самостоятельный шлюз для нескольких ключей и провайдеров LLM: ротация, отказоустойчивость, логи и учет расходов
Tingly Box запускает локальный шлюз моделей: Claude Code, Codex и OpenCode ходят по одному адресу к выбранным провайдерам
Лаунчер запускает Claude Code, Codex, Gemini CLI и другие агенты с настройками Aperture от Tailscale, есть режим моста
Коротко о README
Инструмент не знает заранее ни провайдера, ни адреса, ни модели. Он пишет только блоки шлюза и сохраняет остальные настройки.