Claude Code: русский язык в ответах, комментариях и коммитах

Если вы ищете, как включить в Claude Code русский язык, то сначала нужно разделить две вещи. Интерфейс агента (названия команд, системные сообщения) остаётся английским. А вот язык, на котором модель отвечает, пишет комментарии и формулирует коммиты, вы задаёте сами: одной настройкой в settings.json и коротким файлом инструкций. Ниже: что и куда прописать, что лучше не переводить и сколько токенов добавляет русский текст.

Про «Claude Desktop на русском»: это отдельное приложение Anthropic, язык его интерфейса настраивается в самом приложении, и мы его здесь не описываем. Дальше речь про Claude Code, который работает с ключом Zukko через Anthropic-совместимый адрес.

Claude Code и русский язык: что можно настроить

Модель понимает русские запросы без всяких настроек. Проблема в другом: если в проекте английский код, английские комментарии и английский README, агент часто продолжает отвечать по-английски, потому что контекст «тянет» его в эту сторону. Поэтому язык лучше закрепить явно.

Что реально регулируется:

• язык объяснений, планов и итоговых отчётов в чате;
• язык комментариев и docstring в новом коде;
• язык сообщений коммитов, если вы просите агента их написать;
• язык вопросов, которые агент задаёт вам по ходу работы.

Что не стоит переводить: имена переменных, функций и файлов, команды терминала, названия ошибок и цитаты из логов. Если перевести вывод компилятора, вы потом не найдёте его в поиске и не сверите с документацией.

Самый короткий путь: настройка language

В справочнике настроек Claude Code есть параметр language. Claude Code передаёт его значение модели как инструкцию всегда отвечать на этом языке; значение не проверяется, поэтому подойдёт любое название языка, например "russian". По документации, тот же параметр задаёт язык автоматических названий сессий и голосового ввода.

{
  "language": "russian"
}

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

Подробные правила: CLAUDE.md

Claude Code читает файлы CLAUDE.md в начале каждой сессии. По документации Claude Code, есть несколько мест: файл пользователя ~/.claude/CLAUDE.md (для всех ваших проектов) и файл проекта ./CLAUDE.md или ./.claude/CLAUDE.md (общий для команды через репозиторий). Для личных языковых правил подходит пользовательский файл: это ваше предпочтение, и коллегам оно не навязывается.

Пример содержимого:

## Язык и стиль

- Отвечай мне по-русски: объяснения, планы, вопросы и итоговые отчёты.
- Комментарии и docstring в новом коде пиши по-русски.
- Имена переменных, функций, классов и файлов — только латиницей, по-английски.
- Команды, вывод терминала, названия ошибок и цитаты из логов не переводи.
- Существующие английские комментарии в проекте не переписывай.
- Сообщения коммитов — на русском, первая строка до 72 символов, в повелительном наклонении.

Проверьте, что файл подхватился: запустите claude, выполните /context и посмотрите список файлов памяти (Memory files). Если нужного файла там нет, проверьте путь и регистр имени: CLAUDE.md.

Две оговорки из документации. Во-первых, CLAUDE.md для модели не жёсткая настройка, а контекст, поэтому формулировки должны быть конкретными, а не «пиши красиво». Во-вторых, файл лучше держать коротким: рекомендуется не больше 200 строк, иначе он занимает контекст и инструкции хуже выполняются. Как писать такой файл целиком, разобрано в статье как написать CLAUDE.md↗. Если у вас ещё нет файла, команда /init создаст стартовый вариант, который можно потом дополнить блоком про язык.

Есть и другие варианты. Можно написать «отвечай по-русски» в первом сообщении сессии: это работает, но придётся повторять в каждой новой сессии. В Claude Code также есть флаг --append-system-prompt; его точное поведение сверьте в claude --help и документации инструмента.

Коммиты на русском: когда это уместно

Агент пишет коммиты по вашей просьбе, например «закоммить изменения». Если в CLAUDE.md сказано писать их по-русски, он последует правилу. Но сначала посмотрите на историю репозитория: git log --oneline | head. Если команда ведёт её на английском, русские коммиты будут выбиваться, а ещё сломают автоматику вроде генераторов changelog. В таком случае оставьте правило только в пользовательском файле и добавьте в проектный CLAUDE.md строку «сообщения коммитов — на английском», чтобы не было конфликта.

Противоречащие друг другу инструкции документация называет частой причиной нестабильного поведения: модель может выбрать любую из них. Раз в месяц просматривайте оба файла.

Подключение к Zukko

Если Claude Code ещё не настроен, добавьте блок env в ~/.claude/settings.json (не затирая остальной файл):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.zukko.pro",
    "ANTHROPIC_AUTH_TOKEN": "fetch_ваш_ключ",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5"
  },
  "language": "russian"
}

Адрес без /v1: Claude Code добавляет путь сам. Используйте именно переменную ANTHROPIC_AUTH_TOKEN: с ней Claude Code не просит логин в Anthropic. Подробный разбор и решение типовых ошибок — в документации по Claude Code↗.

Почему русский текст стоит дороже в токенах

Модель считает не символы и не слова, а токены. Русские слова обычно дробятся на больше кусков, чем английские, поэтому один и тот же по смыслу текст по-русски занимает больше токенов. Точный коэффициент зависит от модели и текста, и фиксированного числа мы не называем: его проще измерить на своём примере. Для этого есть метод count_tokens: он только считает токены и не запускает генерацию ответа:

import anthropic

client = anthropic.Anthropic(
    base_url="https://api.zukko.pro",
    api_key="fetch_ваш_ключ",
)

def count(text: str) -> int:
    r = client.messages.count_tokens(
        model="claude-sonnet-5-5",
        messages=[{"role": "user", "content": text}],
    )
    return r.input_tokens

ru = "Добавь проверку на пустой список и напиши тест для этого случая."
en = "Add a check for an empty list and write a test for that case."
print("ru:", count(ru), "en:", count(en))

К каждому результату добавляется небольшая служебная часть, поэтому сравнивайте разницу, а не абсолютные значения. Подробнее о механике — в статье почему русский текст считается иначе↗.

Сколько стоит сам файл инструкций

Допустим, ваш русский CLAUDE.md занимает 1 500 токенов (это допущение, замерьте свой). Он уходит в каждый запрос сессии. Цены claude-sonnet-5-5 на 18 октября 2026: вход $0.4 за 1M, чтение кэша $0.05, запись в кэш $0.5.

• Без кэша: 1 500 × $0.4 / 1 000 000 = $0.0006 за запрос; на 200 запросов в день это $0.12.
• С кэшем: запись один раз 1 500 × $0.5 / 1 000 000 = $0.00075, затем чтение 1 500 × $0.05 / 1 000 000 = $0.000075 за запрос; на 200 запросов $0.015 плюс запись.

Claude Code работает в Anthropic-формате, где шлюз видит чтение и запись кэша, поэтому постоянный префикс вроде CLAUDE.md обходится дёшево. Основной расход всё равно даст не он, а история диалога и файлы. Расход самих ответов по-русски проверяйте по разделу «Использование» в кабинете: если вы просите в основном код, разница небольшая, если подробные пояснения, заметнее. Другие способы сэкономить собраны в статье как сократить расход токенов в Claude Code↗. Актуальные цены: GET https://api.zukko.pro/v1/models или страница «Модели» в кабинете.

Если агент всё равно отвечает по-английски

1. Проверьте, что в settings.json задан language, а через /context убедитесь, что CLAUDE.md загружен.
2. Сделайте правило конкретнее: «объяснения и отчёты в чате всегда по-русски, даже если запрос или код на английском».
3. Уберите противоречия между пользовательским и проектным файлом.
4. Начните новую сессию: в длинной сессии инструкция из начала контекста может выполняться хуже, чем в свежей.
5. Проверьте на своей задаче другую модель из каталога: поведение у моделей разное, и обобщать мы не берёмся.

Ключ для Claude Code создаётся на странице API-ключей↗. Баланс в долларах пополняется от $1: СБП (платёжная страница добавляет 8,5% сверху), криптовалютой или картой MasterCard.

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

Есть ли в Claude Code переключатель языка интерфейса?

Отдельной настройки языка интерфейса в документации мы не нашли. Для ответов модели есть параметр language в settings.json, а подробные правила задаются в CLAUDE.md. Набор настроек меняется от версии к версии, поэтому сверяйтесь с официальной документацией.

Нужно ли писать CLAUDE.md по-русски?

Не обязательно. Инструкцию на английском с фразой «отвечай по-русски» модель тоже выполнит. По-русски писать удобнее вам, но он стоит больше токенов, а за счёт кэша эта разница невелика.

Будут ли русские комментарии мешать в проекте?

Агент не меняет уже написанное, если вы это запретили. Договоритесь в команде, на каком языке пишутся комментарии, и закрепите решение в проектном CLAUDE.md.

Ответы на русском хуже по качеству?

Мы не сравнивали и не делаем выводов о качестве. Проверьте свою типичную задачу на русском и английском промпте на выбранной модели и сравните результат и расход токенов.