Kimi в Claude Code: официальное подключение и проверка

Связка Kimi Claude Code существует как официально описанный продвинутый сценарий. Kimi Code предоставляет Anthropic-совместимый адрес, а Claude Code направляет запросы на него через переменные окружения. Это не превращает Kimi в модель Anthropic и не добавляет её в обычную подписку Claude. Вы используете интерфейс Claude Code, но запросы и оплата относятся к Kimi Code.

Для большинства задач основной путь проще: установить официальное десктопное приложение Claude, открыть вкладку Code и работать с Claude без подмены адреса API. Вариант с Kimi имеет смысл, если вам нужна именно модель Kimi и вы готовы отдельно контролировать ключ, адрес сервиса и условия передачи данных. Официальная инструкция Kimi описывает терминал Claude Code и расширение для VS Code, поэтому ниже не предполагается, что Kimi поддерживается в графической вкладке Code.

Что именно поддерживается официально

В инструкции Kimi для Claude Code указаны официальный адрес Kimi Code, переменная ANTHROPIC_API_KEY и настройка ANTHROPIC_BASE_URL. В руководстве по Kimi Code тот же адрес назван совместимым с протоколом Anthropic, а kimi-for-coding указан как постоянный идентификатор модели, который может направляться на актуальную кодовую модель Kimi. Это прямой документированный способ, а не найденная в форуме подмена конечной точки.

Со стороны Claude Code механизм тоже штатный: документация Anthropic о моделях объясняет, что ANTHROPIC_BASE_URL меняет адрес назначения запросов, а модель задаётся отдельно. Раздел о шлюзах уточняет, что внешний адрес должен принимать запросы в формате Anthropic Messages API. Совместимость конкретного сервиса при этом подтверждает сам сервис, в нашем случае Kimi.

Критерий безопасности простой: используйте только адрес из документации Kimi, ключ из консоли Kimi Code и настройки, которые описаны обеими сторонами. Случайный прокси или инструкция без первоисточника не подходят.

Когда выбирать Kimi, а когда оставить обычный Claude Code

• Оставьте десктопный Claude Code основным вариантом, если вам важны самый короткий путь, единая учётная запись Claude и работа без собственного API-адреса.
• Подключайте Kimi через терминал, если вам нужна модель Kimi, у вас активированы возможности Kimi Code и вы готовы вести отдельный ключ.
• Используйте официальный Kimi Code CLI, если интерфейс Claude Code не нужен. Не стоит добавлять лишний промежуточный слой только ради привычного названия команды.
• Выбирайте провайдерный шлюз лишь для настоящей задачи маршрутизации между несколькими поставщиками и после проверки его политики данных, цен и журналов.

Эта развилка отличает статью от уже опубликованной настройки Claude Code через OpenRouter. OpenRouter является отдельным шлюзом со своим ключом, адресом и именами моделей. Kimi Code в этой инструкции использует прямой официальный адрес Kimi. Аналогично, GLM в Claude Code и DeepSeek в Claude Code относятся к другим поставщикам. Их ключи, адреса и названия моделей нельзя смешивать с Kimi.

По теме: Authorization code Claude: вход и setup-token без путаницы

Что подготовить перед тестом

1. Установите Claude Code по официальной инструкции Anthropic и убедитесь, что команда claude запускается без Kimi-настроек.
2. Активируйте возможности Kimi Code и создайте отдельный API-ключ в консоли Kimi. Полный ключ храните в менеджере секретов и не вставляйте в репозиторий.
3. Создайте небольшой тестовый каталог без рабочих секретов, незакоммиченных правок и доступа к важной инфраструктуре.
4. Откройте новую терминальную вкладку. Настройки сначала должны жить только в этой сессии, чтобы закрытие вкладки стало простым откатом.
5. Если раньше вы меняли ~/.claude/settings.json или файлы запуска оболочки, сделайте резервную копию и проверьте, нет ли там старого ANTHROPIC_BASE_URL.

Kimi предупреждает, что постоянные настройки в ~/.claude/settings.json могут иметь приоритет над командами текущего терминала. Поэтому тест в чистой сессии полезен только после проверки старых значений. Не удаляйте весь файл: в нём могут находиться разрешения, хуки и другие ваши настройки.

Временное подключение Kimi в терминале

Откройте новую вкладку терминала и задайте официальный адрес Kimi, ключ Kimi Code и постоянный идентификатор модели. Значение PASTE_KIMI_CODE_KEY_HERE замените своим ключом только локально. Не отправляйте получившуюся команду в чат, тикет или систему контроля версий.

export ANTHROPIC_BASE_URL="https://api.kimi.com/coding/"
export ANTHROPIC_API_KEY="PASTE_KIMI_CODE_KEY_HERE"
export ANTHROPIC_MODEL="kimi-for-coding"
export ANTHROPIC_DEFAULT_OPUS_MODEL="kimi-for-coding"
export ANTHROPIC_DEFAULT_SONNET_MODEL="kimi-for-coding"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-for-coding"
export ANTHROPIC_DEFAULT_FABLE_MODEL="kimi-for-coding"
export CLAUDE_CODE_SUBAGENT_MODEL="kimi-for-coding"
export CLAUDE_CODE_AUTO_COMPACT_WINDOW="1048576"
export CLAUDE_CODE_MAX_CONTEXT_TOKENS="1048576"
claude

Набор переменных модели важен не только для ответа в основном окне. Claude Code может выбирать отдельные уровни модели для вспомогательных действий и субагентов. Если актуальная инструкция Kimi изменила список переменных, приоритет имеет текущая страница настройки, а не сохранённая команда из старого поста. Не переносите значения в постоянный файл до завершения проверки.

Практическая проверка из пяти пунктов

После запуска Claude Code введите /status. Проверка нужна до первой большой задачи: красивый ответ модели не доказывает, что запрос ушёл по нужному маршруту.

1. Адрес: в статусе указан https://api.kimi.com/coding/, без чужого домена и случайного прокси.
2. Ключ: используется ключ, созданный в консоли Kimi Code, а не ключ Anthropic, OpenRouter, GLM или DeepSeek.
3. Модель: выбрана kimi-for-coding, если официальная инструкция Kimi не требует другого актуального значения.
4. Сессия: переменные заданы только в новой вкладке терминала, а постоянные настройки пока не менялись.
5. Результат: короткая тестовая задача выполняется в отдельном каталоге, а изменения видны в diff до принятия.

Для первой проверки попросите прочитать один небольшой файл, предложить изменение без записи и объяснить, какие строки будут затронуты. Затем разрешите правку копии файла и сравните diff. Такой тест одновременно проверяет маршрут, способность модели понимать проект и вашу точку контроля перед записью.

По теме: Claude и Claude Code: в чём разница и что выбрать

Как вернуть обычный маршрут Claude

Самый надёжный откат после временного теста: выйти из Claude Code и закрыть терминальную вкладку. Если нужно продолжить в той же вкладке, удалите только переменные Kimi, затем запустите Claude Code заново.

unset ANTHROPIC_BASE_URL
unset ANTHROPIC_API_KEY
unset ANTHROPIC_MODEL
unset ANTHROPIC_DEFAULT_OPUS_MODEL
unset ANTHROPIC_DEFAULT_SONNET_MODEL
unset ANTHROPIC_DEFAULT_HAIKU_MODEL
unset ANTHROPIC_DEFAULT_FABLE_MODEL
unset CLAUDE_CODE_SUBAGENT_MODEL
unset CLAUDE_CODE_AUTO_COMPACT_WINDOW
unset CLAUDE_CODE_MAX_CONTEXT_TOKENS

После перезапуска снова выполните /status. Если адрес Kimi остался, источник находится не в текущей сессии. Проверьте ~/.claude/settings.json, затем файлы запуска вашей оболочки. Исправляйте конкретную строку после резервной копии, а не удаляйте настройки целиком.

Диагностика частых ошибок

Claude Code просит войти в Anthropic. Сначала убедитесь, что Kimi-переменные заданы в той же терминальной вкладке до запуска claude. Если мастер входа уже записал старые значения, сверяйтесь с разделом устранения неполадок в официальной инструкции Kimi и не запускайте найденный в интернете скрипт очистки вслепую.

В статусе другой адрес. Ищите остаточный ANTHROPIC_BASE_URL в ~/.claude/settings.json и конфигурации оболочки. Одновременно задавать постоянный и временный способы настройки не стоит: трудно понять, какой источник победил.

Основной ответ работает, а вспомогательная задача падает. Сверьте все переменные моделей с актуальным руководством Kimi. Частичная настройка может оставить отдельные действия на неподдерживаемом имени модели.

Ошибка авторизации или лимита. Проверьте статус возможностей Kimi Code, правильность ключа и лимиты в консоли Kimi. Подписка Claude не оплачивает обращения к Kimi, а ключ Anthropic не заменяет ключ Kimi.

Хочется замаскировать клиент или изменить служебные заголовки. Не делайте этого. Руководство Kimi Code требует сохранять настоящий идентификатор клиента и предупреждает о возможной приостановке возможностей при его подмене.

По теме: Claude Code с OpenRouter: подключение и проверка

Что проверить перед постоянной настройкой

• Вы понимаете, какие данные проекта уходят на адрес Kimi, и правила вашей компании разрешают этот сервис.
• Ключ хранится вне репозитория, снимков экрана, журналов команд и общих файлов настройки.
• Команда /status показывает официальный адрес Kimi перед каждой важной сессией.
• Для модели, субагентов и вспомогательных действий заданы согласованные значения из актуальной документации Kimi.
• Есть короткая команда отката и сохранена резервная копия файла настроек, если вы всё же переходите к постоянному варианту.
• Первый рабочий проект имеет чистый статус Git и понятные тесты, чтобы действия модели можно было проверить.

Постоянная запись в ~/.claude/settings.json удобна, но увеличивает риск забыть, куда направляются следующие запросы. Для редких сессий с Kimi лучше оставить отдельный терминальный профиль или небольшой локальный сценарий, доступ к которому есть только у вас. Не храните ключ внутри такого сценария: передавайте его через защищённое окружение.

Короткий итог

Официальный способ подключить Kimi к Claude Code есть: Kimi документирует Anthropic-совместимый адрес и ключ Kimi Code, а Anthropic документирует смену адреса через ANTHROPIC_BASE_URL. Безопасный тест начинается в отдельной терминальной сессии, подтверждается через /status и заканчивается проверяемым откатом. Десктопный Claude Code с Claude остаётся основным маршрутом, а Kimi нужен как осознанная продвинутая альтернатива.

Частые вопросы

Kimi является моделью Anthropic?

Нет. Kimi предоставляет собственную модель и совместимый адрес API. Claude Code в этом сценарии служит клиентом.

Нужна ли подписка Claude для запросов к Kimi?

Запросы к официальному адресу Kimi требуют возможностей и ключа Kimi Code. Условия подписки Claude и лимиты Kimi являются разными вещами.

Можно ли использовать ключ OpenRouter или DeepSeek?

Нет. Для прямого маршрута Kimi нужен ключ из Kimi Code. Другой ключ означает другого поставщика или шлюз.

Работает ли Kimi в десктопной вкладке Code?

Официальная инструкция Kimi подтверждает сценарий для терминала Claude Code и расширения VS Code. Не переносите это утверждение на графическую вкладку Code без отдельного подтверждения.

Как понять, что запрос действительно ушёл в Kimi?

Проверьте /status: там должен быть официальный адрес Kimi Code, указанный в инструкции и в примере выше. Сам стиль ответа модели не является надёжной проверкой маршрута.