Claude Code українською: мова відповідей і гарячі клавіші
Як змусити Claude Code відповідати українською через ключ language, чому диктування не працює на VPS і що робити, коли комбінації з Ctrl мовчать на кирилиці.
Claude Code українською: коротка відповідь
Щоб Claude Code відповідав українською, додайте ключ "language": "ukrainian" у файл налаштувань ~/.claude/settings.json. Той самий ключ задає мову голосового диктування і мову автоматичних назв сесій. Інтерфейс Claude Code (меню, описи слеш-команд, системні повідомлення) лишається англійською, бо ключ language документовано лише для відповідей, диктування і назв сесій. У релізі 2.1.247 Anthropic виправила неспрацьовування комбінацій з Ctrl на нелатинських розкладках у терміналах з Kitty keyboard protocol. Issue #77386 досі відкритий і містить також звіти про інші шляхи обробки клавіш, тому нижче є тест і способи обійти збій, якщо він виникає у вас.
Документацію Claude Code, примітки до релізів і згадані issue повторно перевірено 17 листопада 2026 року. Остання версія Claude Code на npm цього дня: 2.1.326.
Як увімкнути відповіді українською через ключ language
Довідник налаштувань (settings reference) описує ключ language так: Claude Code передає значення Claude дослівно, як інструкцію завжди відповідати цією мовою. Фіксованого списку мов для відповідей немає. Підходить будь-яка назва мови, яку Claude може прочитати. Приклад у документації японський ("japanese"), а для української той самий шаблон виглядає так:
{
"language": "ukrainian"
}Якщо файл ~/.claude/settings.json уже існує, не перезаписуйте його. Додайте рядок "language": "ukrainian" всередину наявного об'єкта і поставте кому після попереднього ключа. Встановлення Claude Code не створює файлів налаштувань, тож на чистій машині цього файлу може й не бути. Тоді створіть його з вмістом вище.
Файли налаштувань це строгий JSON. Коментар // або зайва кома в кінці є синтаксичною помилкою, і на наступному старті Claude Code покаже діалог Settings Error. Перевірте синтаксис ще до запуску:
python3 -m json.tool ~/.claude/settings.jsonКоманда має надрукувати ваш JSON з відступами. Повідомлення на кшталт Expecting ',' delimiter означає, що в файлі бракує коми, а Expecting property name enclosed in double quotes найчастіше означає зайву кому перед закривною дужкою.
Потім запустіть claude і виконайте /status. Рядок Setting sources має містити User settings. Він показує, які файли завантажено, але не показує, з якого файлу взято кожен ключ.
Одна пастка: Claude Code не перевіряє значення language. Якщо написати "ukranian" з помилкою, ця назва дійде до Claude як є, і жодного повідомлення про помилку ви не побачите. Тому перевірте написання очима.
Який файл налаштувань обрати
Ключ language працює в будь-якому файлі налаштувань. Від файлу залежить, на кого діє значення. ~/.claude/settings.json діє на вас у всіх проєктах на цій машині. .claude/settings.json у папці проєкту діє на всіх, хто працює з репозиторієм, якщо файл закомічено. .claude/settings.local.json діє тільки на вас і тільки в одному проєкті.
Це важливо в міжнародній команді. Не кладіть "language": "ukrainian" у спільний .claude/settings.json, бо тоді Claude почне відповідати українською вашим колегам. Покладіть ключ у ~/.claude/settings.json або в .claude/settings.local.json. Якщо спільний файл команди вже задає іншу мову, він переважить ваш користувацький файл, бо спільні налаштування проєкту стоять вище за користувацькі. Тоді допоможе .claude/settings.local.json: локальний файл проєкту стоїть вище за спільний. Найвищий рівень мають керовані налаштування (managed settings) від вашої організації, і їх перекрити не можна.
Щоб спробувати мову на одну сесію без змін у файлах, передайте ключ під час запуску:
claude --settings '{"language": "ukrainian"}'Значення діє тільки в цій сесії. Файли лишаються без змін.
CLAUDE.md як запасний варіант
Ключ language керує мовою розмови. Але часто потрібні тонші правила: відповіді українською, а коментарі в коді, повідомлення комітів і назви змінних англійською. Такі правила пишуть у CLAUDE.md. Особистий файл для всіх проєктів лежить у ~/.claude/CLAUDE.md. Файл проєкту лежить у ./CLAUDE.md або ./.claude/CLAUDE.md.
Мова:
- Відповідай українською.
- Коментарі в коді, повідомлення комітів і назви змінних пиши англійською.Документація прямо каже, що Claude сприймає CLAUDE.md як контекст, а не як примусову конфігурацію. Отже, ці рядки нічого не гарантують. Чому модель інколи пропускає інструкції з таких файлів, пояснює розбір того, чому агенти ігнорують ваші інструкції. Як CLAUDE.md ділить контекстне вікно з рештою сесії, описано в посібнику з керування контекстом у Claude Code.
Питання про те, скільки коштує сесія і де бачити витрату, тут не розбираємо. Для цього є пояснення витрати токенів у Claude Code.
Чому Claude Code іноді відповідає англійською
На GitHub є два звіти про те, що відповіді повертаються до англійської попри ключ language. Обидва це звіти користувачів, а не підтверджена поведінка поточної версії.
Звіт #66228 (червень 2026 року) описує Claude Code 2.1.168 на Windows з "language": "Japanese" у глобальному settings.json. За словами автора, Claude іноді відповідав англійською. Інший коментатор описав те саме з бразильською португальською. Бот закрив issue як «not planned» через неактивність, а не тому, що баг виправили. Відповіді розробників на сторінці немає.
Звіт #32107 (березень 2026 року) прив'язаний до версії 2.1.71. Після виходу з plan mode з варіантом «Yes, clear context and auto-accept edits» Claude відповідав англійською на етапі автоматичного виконання. Після цього налаштована мова поверталася. За словами автора, у 2.1.69 цього не було. Бот теж закрив цей issue без виправлення, і перевірки на нових версіях на сторінці немає.
Що робити на практиці. Якщо відповідь прийшла англійською, напишіть наступне повідомлення українською або прямо попросіть відповідати українською. Якщо це повторюється в кожній сесії, виконайте /status і перевірте, чи не задає інший файл налаштувань той самий ключ з іншим значенням.
Інтерфейс Claude Code лишається англійською
Довідник налаштувань пов'язує language з трьома речами: відповідями Claude, мовою диктування і автоматичними назвами сесій. Окремого ключа для мови інтерфейсу ми в довіднику не знайшли. Меню команд, описи слеш-команд і системні повідомлення лишаються англійською.
Запити на локалізацію інтерфейсу на GitHub є, але старі загальні запити закрито. #29147 закрили як дублікат у березні 2026 року. #59359 бот закрив через неактивність у червні 2026 року. Відкритим лишається, наприклад, #102820 від 16 жовтня 2026 року: автор просить локалізувати меню слеш-команд через наявний ключ language або новий ключ uiLanguage. Відповіді розробників на ньому поки немає. Окремого запиту саме про українську на першій сторінці пошуку issue ми не знайшли.
Документація теж англійською. Адреса https://code.claude.com/docs/uk 12 листопада 2026 року повернула HTTP 404.
Диктування українською: на ноутбуці працює, на сервері ні
Голосове диктування вмикає команда /voice. За замовчуванням працює режим утримання: тримаєте пробіл (Space) і говорите. /voice tap перемикає на режим, де одне натискання починає запис. Esc або Ctrl+C скасовують запис, що триває.
Диктування бере мову з того самого ключа language. Українська є у списку підтримуваних мов диктування з кодом uk. Документація дозволяє писати або код BCP 47, або назву мови, тож "ukrainian" підходить і для відповідей, і для диктування. Якщо мова з ключа не підтримується, /voice попереджає під час увімкнення і диктує англійською. Мова текстових відповідей від цього не змінюється. Якщо ключ не задано зовсім, диктування теж працює англійською.
Обмеження, які важливі для тих, хто працює з сервером:
- Потрібен вхід через акаунт Claude.ai. Якщо Claude Code працює з ключем Anthropic API напряму, через Amazon Bedrock, Google Cloud's Agent Platform або Microsoft Foundry, диктування недоступне. Якщо ви налаштовували Claude Code через Bedrock або Vertex, голосу там не буде.
- Потрібен локальний мікрофон. У хмарних сесіях і в SSH-сесіях диктування не працює.
- Аудіо передається на сервери Anthropic для розпізнавання. Локально воно не обробляється.
- Розпізнавання не витрачає повідомлень чи токенів Claude і не враховується в ліміти, які показує
/usage.
Для того, хто тримає Claude Code на VPS, висновок простий. На сервері немає пристрою запису звуку, і для такого випадку документація радить запускати Claude Code на машині з мікрофоном. Тож диктуйте в Claude Code, запущеному на ноутбуці. На сервер ви заходите через SSH і пишете з клавіатури, як у схемі з Claude Code на VPS у tmux. Розширення VS Code теж уміє диктувати, але не в Remote-сесіях: SSH, Dev Containers і Codespaces.
Кирилична розкладка: чому не спрацьовують комбінації з Ctrl
Так проявлявся баг #77386 у старих версіях Claude Code. Ви набираєте запит українською, натискаєте Ctrl+W, щоб стерти слово, і нічого не відбувається. Повідомлення про помилку немає. Перемикаєте розкладку на англійську, і та сама комбінація працює.
Причина в тому, як термінал повідомляє програмі про натискання. У класичному режимі термінал надсилає для Ctrl+W один керівний байт ASCII, 0x17, і він однаковий на будь-якій розкладці. Термінал з Kitty keyboard protocol надсилає escape-послідовність з кодом символу і модифікатором. На англійській розкладці Ctrl+W дає ESC[119;5u: 119 це код літери w, а 5 означає Ctrl. На українській розкладці на тій самій клавіші стоїть літера «ц», і термінал надсилає ESC[1094;5u, де 1094 це код «ц». Протокол уміє додати ще й код клавіші на базовій розкладці: ESC[1094::119;5u.
Документація з гарячих клавіш описує задуману поведінку. Якщо термінал використовує Kitty keyboard protocol і повідомляє позицію клавіші на US-розкладці, Claude Code зіставляє комбінації з Ctrl саме за цією позицією. Тоді Ctrl і фізична клавіша W спрацьовують як ctrl+w навіть на кириличній розкладці. Якщо термінал позицію не повідомляє, керівний код ASCII спрацює, а натискання, що прийшло як кириличний символ, не збігається з жодною комбінацією.
Issue #77386 показує, що на практиці так було не завжди. Станом на 12 листопада 2026 року він відкритий, з мітками bug і reproduced. 20 серпня 2026 року розробник Claude Code відтворив баг на версії 2.1.233 під Linux, надсилаючи байти напряму. У запиті з текстом foo bar послідовності 0x17 і ESC[119;5u стерли слово bar. А ESC[1094;5u і навіть ESC[1094::119;5u з кодом базової клавіші Claude Code проігнорував. Розробник позначив це як підтверджений баг. Запропоноване виправлення, тобто запитувати в термінала альтернативні клавіші і зіставляти Ctrl та Alt за базовою розкладкою, він назвав правильним напрямом.
Звіти в цьому issue за версіями:
- 2.1.208: macOS, Ghostty, перший звіт від 14 липня 2026 року.
- 2.1.233: Linux, відтворення розробником 20 серпня.
- 2.1.259: macOS, iTerm2 3.6.10, 3 вересня.
- 2.1.272: Windows 10, вбудований термінал VS Codium, 15 вересня.
- 2.1.311: macOS, agterm 0.38.1 на основі Ghostty, не працював Cmd+C, 27 жовтня.
У примітках до релізу 2.1.247 Anthropic задокументувала виправлення комбінацій з Ctrl на нелатинських, зокрема кириличних, розкладках у терміналах з Kitty keyboard protocol. Пізніший звіт для 2.1.311 стосується Cmd+C, тому він не доводить, що помилка Ctrl-комбінацій зберігалася до 2.1.322. Звіти для 2.1.259 і 2.1.272 описують окремо modifyOtherKeys та власні комбінації з Alt. Сам факт, що issue лишається відкритим, не скасовує задокументованого виправлення. Перевірте свою версію тестом нижче.
Звіт з Windows цікавий окремо. Його автор пов'язує проблему зі зміною у 2.1.272: Claude Code почав визначати підтримку Kitty-протоколу через запит можливостей термінала, тому вбудований термінал VS Codium перейшов у Kitty-режим і отримав цей баг. Власні комбінації з Alt, які працювали на 2.1.270 і 2.1.271, за його словами, перестали спрацьовувати. Класичний cmd.exe, за тим самим звітом, не постраждав.
Звіт з iTerm2 показує інший шлях до тієї самої проблеми. Автор пише, що iTerm2 тут не використовує формат CSI-u з Kitty-протоколу. Після запитів, які Claude Code надсилає на старті, iTerm2 переходить у режим modifyOtherKeys і для Ctrl+V на російській розкладці надсилає ESC[27;5;1084~, де 1084 це код літери «м». На українській розкладці на клавіші V теж стоїть «м», тож код той самий.
Окремо про версію 2.1.314. У changelog є рядок про виправлення комбінації диктування Ctrl+D, яка не працювала на нелатинських розкладках, наприклад російській, грецькій чи івриті. Цей рядок має мітку [VSCode]. У терміналі диктування за замовчуванням висить на пробілі, а Ctrl+D у CLI означає вихід. Тому не вважайте цей рядок виправленням для комбінацій з Ctrl у терміналі. В інших записах changelog від 2.1.322 приблизно до 2.1.306 кириличні чи нелатинські розкладки не згадуються.
Як перевірити, чи баг є у вашому терміналі
Спочатку порівняйте встановлену версію з останньою:
claude --version
npm view @anthropic-ai/claude-code versionПерша команда показує вашу версію, друга показує версію з тегом latest на npm. Якщо вони різні, оновіться перед тестом.
Потім повторіть тест з issue руками:
- Запустіть
claudeз англійською розкладкою. - Наберіть у полі запиту
foo barі не надсилайте. - Перемкніть розкладку на українську.
- Натисніть Ctrl+W.
Якщо слово bar зникло, ваш термінал і ваша версія Claude Code працюють правильно. Якщо нічого не сталося, це симптом, описаний у #77386. Перемкніть розкладку на англійську і натисніть Ctrl+W ще раз. Слово має зникнути, і це підтверджує, що причина саме в розкладці. Якщо тест не пройшов після оновлення, додайте коментар у #77386 з версією і назвою термінала, зазначивши, що виправлення для Kitty-протоколу вже виходило у 2.1.247.
Обхідні шляхи, поки баг відкритий
Перемикайте розкладку на англійську для комбінації. Це найпростіший спосіб. У тесті розробника латинська w спрацювала і в класичному режимі, і в Kitty-форматі, тож латинська літера дає код, який Claude Code розпізнає. Незручно, але не потребує жодних налаштувань.
Прив'язка клавіш в iTerm2. Автор звіту від 3 вересня (версія 2.1.259) описав такий спосіб. Увімкніть кириличну розкладку, відкрийте в iTerm2 Settings → Keys і додайте прив'язку для потрібної комбінації з дією «Send Escape Sequence». Для Ctrl+V він вказав послідовність [27;5;118~, де 118 це код латинської v. Тоді iTerm2 надсилає латинський варіант незалежно від розкладки. Це обхід від користувача, а не виправлення від Anthropic.
Головне застереження: не прив'язуйте так Ctrl+C і Ctrl+D. Прив'язки клавіш в iTerm2 глобальні, тому зміна зачепить і звичайну роботу в shell. Там Ctrl+C надсилає сигнал SIGINT, який перериває команду. Зламаний Ctrl+C означає, що ви не зупините завислий процес звичним способом. Автор звіту попереджає саме про це.
У самого Claude Code є окреме обмеження. Ctrl+C (переривання) і Ctrl+D (вихід, два натискання протягом 800 мс) жорстко закріплені. Перепризначити їх у ~/.claude/keybindings.json не можна.
Що не допомагає. За тим самим звітом, змінна середовища CLAUDE_CODE_ALTGR_AS_TEXT проблему не вирішує.
Власні комбінації. У ~/.claude/keybindings.json назви клавіш пишуть латиницею навіть тоді, коли активна інша розкладка. Модифікатор cmd (Super) Claude Code бачить лише в терміналах, які його передають, наприклад з Kitty keyboard protocol або режимом modifyOtherKeys з xterm. Більшість терміналів його не надсилають, тому для комбінацій, які мають працювати всюди, документація радить ctrl або meta.
FAQ
Як зробити, щоб Claude Code завжди відповідав українською?
Додайте "language": "ukrainian" у ~/.claude/settings.json. Claude Code передає це значення Claude як інструкцію завжди відповідати цією мовою. Значення не перевіряється, тому помилка в написанні не дасть жодного повідомлення. Для тонших правил, наприклад коментарів у коді англійською, додайте інструкції в ~/.claude/CLAUDE.md. Пам'ятайте, що CLAUDE.md це контекст, а не примусове налаштування.
Чому Ctrl+W або Ctrl+V не працюють на українській розкладці в Claude Code?
У терміналах з Kitty keyboard protocol або режимом modifyOtherKeys натискання на кириличній розкладці приходить з кодом кириличної літери, наприклад «ц» замість w. У релізі 2.1.247 виправлено Ctrl-комбінації на нелатинських розкладках у Kitty-терміналах. Issue #77386 досі відкритий, але його звіт для 2.1.311 стосується Cmd+C і не підтверджує збереження помилки Ctrl-комбінацій. Оновіть Claude Code і повторіть тест з Ctrl+W. Якщо збій лишився, перемкніть розкладку на англійську для комбінації або налаштуйте прив'язку в терміналі, але ніколи не для Ctrl+C і Ctrl+D.
Чи можна диктувати українською в Claude Code на VPS через SSH?
Ні. Диктування потребує локального мікрофона і не працює в SSH-сесіях та хмарних сесіях. Воно також потребує входу через акаунт Claude.ai і недоступне з ключем API, Amazon Bedrock, Google Cloud's Agent Platform чи Microsoft Foundry. Диктуйте в Claude Code на ноутбуці, де українська підтримується з кодом uk, а на сервері пишіть з клавіатури.
Чи є в Claude Code український інтерфейс?
Ні. Ключ language змінює відповіді Claude, мову диктування і автоматичні назви сесій, а меню та описи команд лишаються англійською. Запити на локалізацію інтерфейсу є на GitHub, наприклад відкритий #102820, але старі загальні запити #29147 і #59359 закрито. Українська версія документації за адресою code.claude.com/docs/uk 12 листопада 2026 року повертала помилку 404.