Перейти к содержимому
Ручка — документация

Codex CLI — интеграция с Ручкой

Codex CLI — терминальный агент OpenAI. Кастомный провайдер задаётся в ~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml):

model = "gpt-5.1-codex"
model_provider = "ruchka"


[model_providers.ruchka]
name = "Ручка"
base_url = "https://api.ruchka.dev/v1"
env_key = "RUCHKA_API_KEY"
wire_api = "chat"

wire_api = "chat" — важно: по умолчанию Codex ходит в Responses API, через Ручку работает формат chat completions.

Ключ — через переменную окружения:

Окно терминала
export RUCHKA_API_KEY=sk-ruchka-YOUR_KEY_HERE
codex

API-ключ (sk-ruchka-...) на раннем доступе выдаём в @ruchkadev_bot.

Проверка

Окно терминала
curl https://api.ruchka.dev/v1/chat/completions \
  -H "Authorization: Bearer sk-ruchka-YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.1-codex", "messages": [{"role": "user", "content": "Привет"}]}'

Ответ 200 + choices[0].message.content — работает.

Если не работает

  • 401 — ключ начинается с sk-ruchka- и скопирован целиком; переменная RUCHKA_API_KEY видна в том терминале, где запускаешь codex.
  • Codex ходит не в Ручку — model_provider = "ruchka" должен стоять на верхнем уровне config.toml, не внутри секции провайдера.
  • model not found — id модели точно как в каталоге, строчными: gpt-5.1-codex.

В model подойдёт любой id из каталога — gpt-5.1-codex, gpt-5.3-codex, а также Kimi, DeepSeek или Qwen, — но лучше всего Codex отлажен на своих моделях: начинай с gpt-5.1-codex.

Что-то не так? Пиши в @ruchkadev_bot — разберём по request_id.