Kimi API key получите в своём проекте на Kimi API Platform: войдите в кабинет, откройте API Keys, создайте и безопасно сохраните ключ. Подключаем его к Codex CLI отдельным профилем, не меняя прежний config.toml. Затем проверяем выбранную модель, выполненную задачу и расход проекта.
Одну и ту же задачу я дал Kimi 3.1 Pro, Codex на GPT 6.1 Sol и Opus 5.5: написать навык, который повторяет успешный результат конкурента, и самостоятельно его улучшать. У Kimi на 3-й день началась сильнейшая деградация, отклонение от стратегии, после чего я завершил эксперимент. Поэтому ответом в чате проверку не заканчиваем: открываем готовый файл сами.
API Platform или Kimi Code: какой ключ вам нужен?
Нужен ключ Kimi API Platform с оплатой по использованию. Покупать подписку Code ради этого подключения не требуется.
| Сервис | Где создают ключ | Базовый адрес | Модель | Оплата |
|---|---|---|---|---|
| API Platform - наш маршрут | API Keys своего проекта: https://platform.kimi.ai/console/api-keys | https://api.moonshot.ai/v1 | kimi-k3.1-pro | Баланс организации, учёт по проекту |
| Kimi Code - другой сервис | Kimi Code Console из документации Code | https://api.kimi.ai/coding/v1 | k3.1-pro | Месячная/годовая подписка с ограничениями скорости |
Ключи этих сервисов друг друга не заменяют. Выбор подписки Kimi разбираю в отдельной статье.
Совместимость Kimi с интерфейсом OpenAI не означает, что запросы оплачивает подписка ChatGPT. Запросы нашего профиля оплачиваются в Kimi API Platform.
Разборы подключения моделей и проверки работы ИИ-агентов смотрите в канале:
Где получить свой Kimi API key и куда его сохранить?
Войдите своим аккаунтом на https://platform.kimi.ai/. В меню текущего проекта вверху консоли выберите нужный проект. Затем откройте API Keys, создайте собственный ключ и скопируйте его.
Новый проект не обязателен. Если нужен отдельный, его создаёт администратор: меню проекта → Create Project → имя и описание → подтверждение. Если платформа требует пополнить баланс, сначала пополните его.
Запомните проект: по нему потом сверите расход. Ключ принадлежит проекту, баланс общий у организации.
Не вставляйте ключ в чат, исходный код или config.toml и не показывайте на снимках экрана. Всё, что вы в чат скидываете, попадает в контекст модели и сохраняется в истории. Codex получит ключ через переменную окружения.
Если ключ раскрыли, прекратите его использовать и перевыпустите. При поиске утечки записывайте, в каких файлах и коммитах нашли секреты, сами значения не печатайте.
Как подключить Kimi к Codex и не затереть прежние настройки?
Для этих шагов нужны macOS/Linux, Bash, Codex CLI 0.134.0 или новее и стандартная папка настроек CODEX_HOME=~/.codex. Для Desktop этот профиль не используйте. Параметры провайдера взяты из инструкции Kimi, формат профиля - из документации Codex.
- Завершите старую сессию. Запишите её модель и провайдера с экрана запуска, чтобы потом проверить возврат. Базовый
~/.codex/config.tomlоставьте без изменений. - Проверьте, свободны ли имя файла
~/.codex/kimi-platform-test.config.tomlи имя провайдераkimi_platform_test. Занятые не перезаписывайте. Если выбрали другое имя файла, поменяйте его и в команде запуска; имя провайдера замените в обеих записях ниже. - Создайте новый файл
~/.codex/kimi-platform-test.config.toml:
model = "kimi-k3.1-pro"
model_provider = "kimi_platform_test"
model_context_window = 1048576
[model_providers.kimi_platform_test]
name = "Kimi"
base_url = "https://api.moonshot.ai/v1"
env_key = "KIMI_API_KEY"
wire_api = "responses"kimi_platform_test - локальное имя провайдера. Секция [profiles.*] не нужна: профиль хранится отдельным файлом.
base_url заканчивается на /v1. Клиент использует POST https://api.moonshot.ai/v1/responses, дописывать /responses в базовый адрес не надо. Оставьте wire_api = "responses" и model_context_window как в примере Kimi, Chat Completions сюда не подставляйте.
- В том же терминале Bash выполните первую команду, вставьте ключ и нажмите Enter. Символы не показываются. Затем выполните вторую:
read -s KIMI_API_KEY
export KIMI_API_KEYПеременная действует в текущей сессии терминала. Не сохраняйте ключ открытым текстом в export в настройках оболочки. Проверьте только наличие значения:
test -n "$KIMI_API_KEY" && echo set || echo missingЕсли получили missing, задайте переменную заново до запуска. Нужно имя KIMI_API_KEY, указанное в env_key. Переменная MOONSHOT_API_KEY из общего Quickstart здесь не подходит.
- В отдельной тестовой папке без рабочих секретов и чужих данных запустите новую сессию:
codex --profile kimi-platform-testИмя профиля передаётся без .config.toml. Не добавляйте разовые --model или -c, меняющие выбор.
На старте сверьте модель kimi-k3.1-pro и провайдера kimi_platform_test. Если они отличаются, задачу не отправляйте: параметры запуска и проектные настройки имеют приоритет выше профиля. Проверьте также, не перезаписывает ли конфигурацию Codex другая программа.
Адрес и протокол вы сверили по файлу. Экран запуска не показывает фактический сетевой запрос.
Теперь проверяем подключение: ответ, файл и расход
До платного задания проверьте доступ аккаунта и баланс Platform. В Project Settings задайте дневной или месячный бюджет больше 0. Выберите сумму, которую готовы потратить: учёт и блокировка запросов могут запаздывать, расходы за это время тоже оплачиваются.
Ставки смотрите на странице цен Kimi. На сумму влияют ввод, вывод и кеширование, поэтому одного числа токенов для расчёта недостаточно.
Запишите дату, версию клиента, выбранные модель и провайдера, текст задания и расход проекта до отправки. Сам ключ в эти записи не включайте.
Отправьте hello. Ответ подтверждает базовое соединение. Теперь проверьте инструменты и результат на знакомых вам несекретных файлах:
Изучите структуру этой тестовой папки и сохраните краткое описание в structure-report.md. Укажите существующие файлы, их назначение по содержимому и что осталось непонятно. Исходные файлы не меняйте.
Откройте полученный файл сами. Проверьте вызовы инструментов и финальный ответ после них. Пути должны существовать, описание - соответствовать содержимому, исходные файлы - остаться без изменений. «Готово» без файла не принимаем.
И учитывайте, чем дешевле нейросеть вы используете, тем более продвинутый кожаный редактор ей нужен, то есть вы.
Откройте проект → Project Information → Project Overview. После обновления сравните расход до и после задания по модели и API-ключу. Статистика может запаздывать примерно на 10 минут. Ноль сразу после ответа ещё не значит, что запрос был бесплатным.
Если тем же ключом параллельно выполнялись другие запросы, разница включает и их расход. Объём использования и денежный расход запишите отдельно, с учётом кеширования.
Как посчитать расход токенов и бюджет API, разбираю в отдельной статье.
| Что проверяем | По чему проверяем | Чего из этого не узнать |
|---|---|---|
| Настройки и выбор модели | Профиль и экран запуска | Фактический адрес запроса |
| Выполнение задачи | Файл, который открыли и сверили с исходниками | Качество будущих запусков |
| Расход | Обновлённая статистика проекта и ключа | Цена одной задачи при параллельных запросах |
Как вернуться к прежнему провайдеру?
Завершите сессию Kimi и запустите новую прежней командой, без --profile kimi-platform-test и разовых параметров Kimi. Стандартный запуск:
codexСравните модель и провайдера с записью до переключения. Тестовый профиль больше не применяется, базовый файл вы не редактировали. Оставшаяся KIMI_API_KEY сама по себе провайдера не выбирает. Продолжать историю Kimi через resume для проверки возврата нельзя.
Если модель или провайдер отличаются, до рабочей задачи проверьте параметры запуска, проектные настройки и программы, меняющие конфигурацию. Сбрасывать config.toml не нужно.
Кстати, я снял полный гайд про связку для первого агента Hermes Agent, обязательно посмотрите.
В нём я подключаю Firecrawl и проверяю навык на разных моделях. Посмотрите, как подключать инструменты и проверять работу агента в Hermes.
Если после этого хотите собрать свой проект с ИИ-агентами, посмотрите программу практикума СмыслоКода.
Не подключилось или не сделало задачу: что проверяем?
При 429 сначала прочитайте error.type: по одному статусу нельзя решить, нужно ли пополнять баланс.
| Симптом | Что проверить | Что сделать |
|---|---|---|
401 | Есть ли KIMI_API_KEY в терминале запуска; соответствует ли Platform-ключ адресу https://api.moonshot.ai/v1? | Задайте переменную в том же терминале или вернитесь к собственному Platform-ключу |
403 | Есть ли доступ API, разрешён ли ваш IP в организации? | Проверьте права и адреса в кабинете, защиту целиком не отключайте |
404, Model not found | Верно ли написано kimi-k3.1-pro, есть ли доступ у аккаунта? | Исправьте опечатку или проверьте права в кабинете |
404 на /v1/responses | Точно ли base_url равен https://api.moonshot.ai/v1? | Исправьте адрес, уберите оставшийся адрес старого локального маршрутизатора |
429, engine_overloaded_error | Указана ли перегрузка в error.type? | Учитывайте Retry-After, снизьте параллельность, увеличивайте паузу между попытками |
429, exceeded_current_quota_error | Каковы баланс, квота и статус аккаунта? | Устраните указанную причину до повтора |
429, rate_limit_reached_error | Какой лимит достигнут? | Снизьте нагрузку с учётом параллельности, RPM, TPM или TPD |
Обрыв, получен 499/504 | Обновился ли расход проекта после обрыва? | Сверьте расход перед следующей платной попыткой |
| Ответ есть, результата нет | Существует ли structure-report.md, верно ли содержание? | Укажите, что не выполнено, и решите, нужна ли следующая попытка |
499 связан с прерыванием соединения, отменой или промежуточным сетевым узлом. 504 означает, что сервер не ответил за 900 секунд. Обрыв без HTTP-статуса нельзя считать 504. Перед повтором проверьте расход, не рассчитывайте на бесплатную попытку.
Предупреждение об отсутствии kimi-k3.1-pro во встроенном каталоге ещё не означает отказ API. Сверьте model_context_window = 1048576 с примером Kimi.
Если настройки не применились, начните новую сессию и проверьте параметры запуска, проекта и профиля. Ответ на hello без сверки модели и провайдера эту проверку не заменяет. Если задача сделана плохо, причина может быть в качестве работы модели, а не в соединении.
Общую диагностику Codex разбираю в отдельной статье.
«Работать своей головой»: когда подключение можно принять?
Перед работой с настоящим проектом проверьте:
- Ключ нигде не раскрыт.
- Профиль и модель совпали с выбранными.
- Полученный файл проверен человеком.
- Расход сверен после обновления статистики.
- Возврат к прежнему провайдеру подтверждён новой сессией.
Если что-то не выполнено, оставайтесь в тестовой папке. Успешное маленькое поручение не показывает, как модель справится с долгой самостоятельной работой. Чем умнее ваша нейросеть, тем меньше приходится работать своей головой, но работать приходится всегда.
Что пришлось проверять дольше: подключение Kimi или выполненную им задачу? Напишите в комментариях в канале.
Частые вопросы
Источники
- Kimi: Quickstart - выпуск ключа.
- Kimi: Codex - параметры и проверка.
- OpenAI: Codex - профили CLI.
- Kimi: проекты - ключи, бюджеты, учёт.
- Kimi: Code - отдельный сервис.
- Kimi: цены - оплата и кеш.
- Kimi: ошибки - статусы.
Новые материалы - дайджестом, без спама
Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

