Kimi K3 в Claude Code: полное руководство по настройке
Moonshot предоставляет совместимый с Anthropic эндпоинт, поэтому Claude Code работает на Kimi K3 с помощью одного блока переменных в settings.json. Каждое значение конфигурации ниже дословно сверено с официальным руководством Kimi, а восемь скриншотов сопровождают реальную сессию K3 — от первого промпта до проверенной, запускаемой игры.
Коротко — Kimi K3 внутри Claude Code
- Messages API от Moonshot совместима с Anthropic: направьте ANTHROPIC_BASE_URL на https://api.moonshot.ai/anthropic, вставьте ключ Kimi в ANTHROPIC_AUTH_TOKEN — и Claude Code сохранит все функции, а думать будет Kimi K3.
- Официальный settings.json отображает каждую модельную ступень на kimi-k3[1m] (вариант с контекстом 1M), ступень Haiku — на kimi-k2.7-code, а также задаёт CLAUDE_CODE_AUTO_COMPACT_WINDOW = 1000000 и CLAUDE_CODE_EFFORT_LEVEL = max.
- Два способа проверки: запустите /status и сверьте Base URL и модель kimi-k3[1m] — или просто прочитайте стартовый баннер. В демо там написано Using kimi-k3 (from .claude/settings.json).
- K3 работает по оплате по факту на Kimi API Platform: $3 за миллион входных токенов, $15 за миллион выходных, $0,30 при попадании в кэш, контекст 1M. Сама модель — MoE на 2,8 трлн параметров (104B активных) с всегда включённым режимом размышления.
Kimi K3 + Claude Code Demo
Видеодемонстрация:Data Science in your pocket8:11
Use Kimi in Claude Code — official guide
Факты о продукте:platform.kimi.aiKimi API Platform docs
Шаги 1–4 (установка, API-ключ, блок переменных, проверка curl) описаны по официальному руководству Kimi: чистой записи процесса настройки не существует — в каждом ролике на YouTube есть лицо автора. Кадры для шагов 5–12 взяты из записи чистого терминала с Claude Code v2.1.207 на kimi-k3.
Кадры — подписанные скриншоты из указанного видео, каждый со ссылкой на свой таймкод. Текст руководства оригинальный — это не транскрипт.
Kimi K3 в Claude Code, шаг за шагом
1 · Направить Claude Code на Kimi K3
- 1
Установить Claude Code
Используйте нативный установщик Anthropic: curl -fsSL https://claude.ai/install.sh | bash на macOS и Linux или irm https://claude.ai/install.ps1 | iex в PowerShell Windows. Работает и путь через npm: npm install -g @anthropic-ai/claude-code требует Node.js 22 или новее. Claude Code уже стоит? Пропускайте — но если сторонний инструмент когда-либо правил ~/.claude/settings.json, сначала вычистите устаревшие записи ANTHROPIC_* из поля env: эти значения молча переопределяют всё, что вы экспортируете в терминале.
- 2
Создать API-ключ Kimi
Войдите на platform.kimi.ai, откройте консоль и создайте ключ в разделе API Keys. K3 открывается после успешного пополнения, минимум — $1: одного доллара хватит на весь этот туториал. Учтите: это Kimi API Platform с оплатой по факту. Подписки Kimi Code и Kimi Membership — другие продукты и не выдают API-ключ, нужный для этой настройки.
- 3
Записать блок переменных в ~/.claude/settings.json
Откройте (или создайте) ~/.claude/settings.json и заполните поле env в точности как предписывает официальное руководство: ANTHROPIC_BASE_URL — https://api.moonshot.ai/anthropic, ANTHROPIC_AUTH_TOKEN — ваш ключ Kimi, ANTHROPIC_MODEL вместе со ступенями OPUS, SONNET и FABLE, а также CLAUDE_CODE_SUBAGENT_MODEL — kimi-k3[1m], ANTHROPIC_DEFAULT_HAIKU_MODEL — kimi-k2.7-code, CLAUDE_CODE_AUTO_COMPACT_WINDOW — 1000000, CLAUDE_CODE_EFFORT_LEVEL — max. Отобразить каждую ступень критично: Claude Code шлёт фоновые запросы и запросы субагентов через эти алиасы, и недостающая ступень молча приводит к сбою. Блок env переопределяет экспорты терминала и хранит ключ открытым текстом — никогда не коммитьте его.
- 4
Доказать работоспособность эндпоинта и ключа через curl
Прежде чем запускать Claude Code, отправьте запрос на один токен прямо в маршрут, совместимый с Anthropic: curl https://api.moonshot.ai/anthropic/v1/messages с заголовком Authorization: Bearer, несущим ваш ключ Kimi, и телом с model kimi-k3 и max_tokens 1. Обычный JSON-ответ означает, что эндпоинт и учётные данные работают. 401 означает, что ключ недействителен, Base URL не совпадает с платформой, выдавшей ключ, или оставшийся ANTHROPIC_API_KEY конфликтует с ANTHROPIC_AUTH_TOKEN — удалите его.
2 · Запустить и доказать, что рулит K3
- 5
Запустить claude и прочитать баннер
Запустите claude в папке проекта. Баннер рассказывает всю историю: в демо это Claude Code v2.1.207, затем kimi-k3 · API Usage Billing, а дальше ключевая строка — Using kimi-k3 (from .claude\settings.json) · /model. Это значит, что блок переменных подхвачен; проектный .claude/settings.json работает так же. Если в баннере всё ещё строка биллинга Claude или Anthropic, вернитесь к шагу 3 и перезапустите Claude Code.
Стартовый баннер называет kimi-k3 и settings.json, откуда он взялся.Смотреть на 0:22 - 6
Отправить реальную задачу, а не «кто ты»
Демо открывается промптом help me develop a game called snake and ladders. — конкретным, реализуемым заданием. K3 думает, прежде чем ответить: Thought for 16s, затем ответ идёт потоком, а строка статуса отсчитывает Channeling… 25s · ↓1.0k tokens. Забудьте про вопрос «какая это модель»: конфигурация отображает алиасы Claude на ID Kimi, самопрезентация ничего не доказывает — доказательства дают /status и баннер.
Первый промпт отправлен, K3 думает — счётчик токенов заработал.Смотреть на 1:42 - 7
Ответить на уточняющие вопросы
K3 не угадывает — он спрашивает. Появляется селектор с вкладками — Platform, Players, Rules, Submit — с вариантами Web (HTML/CSS/JS), Python console, Python + pygame или собственным текстом, и пояснением под каждым. Enter выбирает, Tab и стрелки перемещаются, Esc отменяет. Такое структурированное выяснение требований на старте — половина причины, по которой готовый результат не требует переделки.
Интерфейс вопросов с вкладками: Enter выбирает, Tab и стрелки перемещают, Esc отменяет.Смотреть на 2:04
3 · Один промпт — одна игра: рабочий цикл K3
- 8
Проверить и отправить ответы
Прежде чем что-то заработает, Claude Code показывает экран Review your answers: вкладки Platform, Players и Rules помечены зелёным — в демо это Python + pygame, 1 player vs computer и Classic — и Submit answers ждёт как выделенный вариант. Одно нажатие Enter — и у агента полная спецификация. Здесь проверяйте внимательно: план строится именно из этих выборов.
Platform, Players и Rules отмечены — до Submit answers один Enter.Смотреть на 2:12 - 9
Прочитать план и дать ему доустановить недостающее
План приходит проверяемыми шагами: проверить окружение и убедиться в наличии Python + pygame; написать игру и убедиться, что она компилируется; прогнать логику и рендеринг в headless-режиме так, чтобы симулированные партии завершались победой с точным попаданием на клетку 100. Он определяет Python 3.13, обнаруживает отсутствие pygame и сам запускает python -m pip install pygame. Обратите внимание на время размышления — 4 мин 53 с за один заход: это работает CLAUDE_CODE_EFFORT_LEVEL=max; K3 по умолчанию использует максимальный уровень рассуждений.
Трёхчастный план, а затем автоматическая установка pygame на Python 3.13.Смотреть на 3:42 - 10
Одобрить запись и проследить за проверкой компиляции
K3 записывает snake_and_ladders.py — 279 строк в демо — и затем проверяет собственную работу: сначала проверку компиляции (python -m py_compile … && echo "compile OK"), затем headless-смоук-тест, который отрисовывает каждый элемент и симулирует тысячи полных партий. Внизу горит accept edits on (shift+tab to cycle) — режим разрешений, при котором записи проходят без подтверждения по каждому файлу. Отклонённая запись поправима — сама демо-сессия восстанавливается после случайного отклонения и повторяет попытку.
Записано 279 строк, затем python -m py_compile в режиме accept edits on.Смотреть на 6:05
4 · Проверенный результат, готовый к запуску
- 11
Прочитать чек-лист проверки
All checks pass. The game is done and verified — и Claude Code перечисляет доказательства: компиляция ✓; отрисовка — доска, змейки, лестницы и кубик рисуются без ошибок ✓; соответствие доски — клетка 1 внизу слева, зигзагом до 100 ✓; правила — перелёт сгорает, победа только точным попаданием на 100 ✓; и 2000 симулированных партий, все завершившиеся победителем ✓. Ниже печатается команда запуска и резюме того, что вы получаете. Привычка, которую стоит перенять: никогда не верьте коду на слово — проверяйте симуляцией.
Компиляция, отрисовка, соответствие доски, правила и 2000 симуляций — всё зелёное.Смотреть на 6:55 - 12
Запустить
Выполните напечатанную команду — в демо это python C:\Users\datas\snake_and_ladders\snake_and_ladders.py — и откроется окно игры: доска 10x10 с волнистыми зелёными змейками и коричневыми лестницами, боковая панель SNAKES & LADDERS с индикатором хода, кубиком и зелёной кнопкой Roll. Пробел или клик бросает кубик, R перезапускает, Esc выходит. От одного предложения до играбельной, самопроверенной игры — около десяти минут работы K3.
Готовое окно Snakes & Ladders, запущенное командой, которую напечатал K3.Смотреть на 7:35