> ## Content Index
> Fetch the complete content index at: https://matveev.tech/llms.txt
> Use this file to discover other available public pages before exploring further.

# Kimi K2.5 + Claude Code
- URL: https://matveev.tech/kimi-claude-code-setup/
- Published: 2026-02-21T14:26:07.000Z
- Updated: 2026-02-25T12:16:36.000Z
- Description: Подключаем Kimi K2.5 от Moonshot AI к Claude Code — 256K контекст, thinking mode и алиас для переключения.
- Author: Pavel Matveev
- Tags: Claude Code, Claude, Dev Tools, Гайд, LLM

**TL;DR:** Подключаем Kimi K2.5 от Moonshot AI к Claude Code. Модель с контекстом 256K токенов, thinking mode и ценой $0.60/$3.00 за миллион токенов. Настроим алиас `kimi` для быстрого переключения.

Moonshot AI — китайская компания, которая делает модели серии Kimi. Их последняя K2.5 вышла в январе 2026 с поддержкой мультимодальности и thinking mode. Для Claude Code у них есть Anthropic-совместимый эндпоинт, так что подключение занимает пару минут.

## Что понадобится

- Claude Code (установленный)
- Аккаунт на [platform.moonshot.ai](https://platform.moonshot.ai/?ref=matveev.tech)
- Баланс на аккаунте (pay-per-token)
- Терминал с zsh или bash

## Шаг 1\. Регистрация и API-ключ

Заходи на [platform.moonshot.ai](https://platform.moonshot.ai/?ref=matveev.tech) и создай аккаунт. Перейди в раздел [API Keys](https://platform.moonshot.ai/console/api-keys?ref=matveev.tech) и сгенерируй новый ключ. Он начинается с `sk-kimi-` и показывается один раз.

Сохрани в `~/.zshrc`:

```bash
export KIMI_API_KEY="sk-kimi-вставь-свой-ключ"

```

## Шаг 2\. Выбираем модель

У Kimi несколько моделей, вот основные:

| Модель                 | Контекст | Input (cache miss) | Input (cache hit) | Output за 1M | Для чего                         |
| ---------------------- | -------- | ------------------ | ----------------- | ------------ | -------------------------------- |
| kimi-k2.5              | 256K     | $0.60              | $0.10             | $3.00        | Лучшее соотношение цена/качество |
| kimi-k2-thinking       | 256K     | $0.60              | $0.15             | $2.50        | Reasoning-задачи                 |
| kimi-k2-thinking-turbo | 256K     | $1.15              | $0.15             | $8.00        | Быстрый reasoning, 60–100 tps    |
| kimi-k2-0905-preview   | 256K     | $0.60              | $0.15             | $2.50        | Улучшенный кодинг                |

Автоматический кэш работает для всех моделей — при повторных запросах с тем же контекстом input-цена падает до cache hit. Для k2.5 это $0.10 вместо $0.60 — экономия 83%.

K2.5 — самый свежий и при этом дешевле турбо-вариантов. Я бы начинал с него.

## Шаг 3\. Настраиваем алиас

Добавь в `~/.zshrc`:

```bash
kimi() {
  ANTHROPIC_BASE_URL=https://api.moonshot.ai/anthropic \
  ANTHROPIC_AUTH_TOKEN="$KIMI_API_KEY" \
  ANTHROPIC_MODEL=kimi-k2.5 \
  ANTHROPIC_SMALL_FAST_MODEL=kimi-k2.5 \
  CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 \
  claude "$@"
}

```

Перезагрузи терминал: `source ~/.zshrc`.

## Шаг 4\. Проверяем

```bash
kimi

```

Если сессия открылась — работает. Попробуй что-нибудь простое.

Для thinking mode используй модель `kimi-k2-thinking`:

```bash
kimi --model kimi-k2-thinking

```

## Шаг 5\. Глобальная настройка (альтернатива)

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.moonshot.ai/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-kimi-ваш-ключ",
    "ANTHROPIC_MODEL": "kimi-k2.5",
    "ANTHROPIC_SMALL_FAST_MODEL": "kimi-k2.5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

```

Сохрани в `~/.claude/settings.json`.

## Результат

Команда `kimi` запускает Claude Code с моделью Kimi K2.5\. Контекст 256K токенов, thinking mode через `kimi-k2-thinking`.

## Частые ошибки

**Температура отличается от привычной**

Moonshot рекомендует temperature=0.6 для обычного режима и temperature=1.0 для thinking mode. Claude Code может отправлять другие значения — Kimi их принимает, но результат может отличаться от ожидаемого. Если ответы кажутся «странными», попробуй явно задать температуру в настройках.

**Tool calls не работают в thinking mode**

Известное ограничение: в thinking mode `tool_choice` принимает только `auto` или `none`. Встроенный web\_search Kimi тоже отключается при thinking. Для Claude Code это обычно не проблема, но если заметишь, что MCP-серверы не вызываются — переключись на обычный режим.

**Изображения не поддерживаются через Anthropic API**

Kimi K2.5 — мультимодальная модель и поддерживает картинки через OpenAI API (в base64). Но через Anthropic-совместимый эндпоинт передача изображений не работает. Только текст.

**Контроль расходов**

Moonshot рекомендует [настроить дневной лимит](https://platform.moonshot.ai/console?ref=matveev.tech) в разделе «Project Settings». Агентские циклы Claude Code могут быстро расходовать токены — лимит защитит от неожиданных трат.

## FAQ

**Чем Kimi отличается от DeepSeek и Z.ai?**

Kimi K2.5 — мультимодальная модель с контекстом 256K (у DeepSeek — 128K). По цене: $0.60/$3.00 у Kimi vs $0.28/$0.42 у DeepSeek. DeepSeek дешевле, но Kimi может быть лучше на задачах, где нужен большой контекст или мультимодальность.

**Есть ли бесплатный тариф?**

Бесплатного тарифа нет, но при регистрации могут дать грантовый баланс для тестирования.

**Где серверы Kimi?**

Серверы в Китае. Для международных пользователей используется домен `api.moonshot.ai`. Задержка из России/СНГ может быть заметной.

## Что ещё почитать

- [Claude Code: 5 провайдеров с Anthropic API в 2026](https://matveev.tech/claude-code-alternative-providers-2026/) — обзор всех провайдеров
- [DeepSeek + Claude Code: reasoning за копейки](https://matveev.tech/deepseek-claude-code-setup/) — альтернативный китайский провайдер
- [Переменные окружения Claude Code](https://matveev.tech/claude-code-environment-variables/) — справочник