Настройка терминала Claude Code: уют за 10 минут

Claude Code работает в любом терминале вообще без настройки — настройка терминала нужна исключительно для удобства: чтобы Shift+Enter вставлял перенос строки, чтобы приходил сигнал, когда Claude закончил, чтобы тема совпадала с вашей и чтобы полезные цифры висели в статус-баре. Встроенная команда /terminal-setup закрывает самое раздражающее (клавиши в терминалах семейства VS Code) одним махом.

Я неделями отказывался настраивать терминал из гордого убеждения новичка, что дефолты и так хороши. Потом одна команда /statusline — и я стал видеть заполнение контекста с одного взгляда и перестал удивляться авто-сжатию посреди мысли. Десять минут настройки — постоянный комфорт. Вот весь маршрут.

Что на самом деле делает /terminal-setup?

В VS Code, Cursor, Devin Desktop, Alacritty и Zed команда /terminal-setup записывает в конфигурацию терминала привязку Shift+Enter, чтобы клавиша вставляла перенос строки, а не отправляла сообщение. В семействе VS Code она дополнительно выключает GPU-ускорение терминала (лечит «кашу» из символов) и настраивает чувствительность прокрутки. В Apple Terminal предложение при первом запуске — «Option+Enter for newlines and visual bell» — выполняет её за вас: включает Option как Meta и визуальный звонок. В iTerm2 она разрешает доступ к буферу обмена, чтобы работала /copy. Существующие привязки никогда не перезаписываются, и одно правило важно: запускайте её в самом терминале, а не внутри tmux или screen.

Хорошие новости, если ваш терминал — Ghostty, Kitty, iTerm2, WezTerm, Warp, Apple Terminal или Windows Terminal: там Shift+Enter работает вообще без настройки. А в любом терминале на свете перенос строки вставляет Ctrl+J — или символ \ и затем Enter.

Как запустить Claude Code в терминале?

Перейдите в папку проекта и наберите claude — вот и весь ритуал. При первом запуске войдите через /login и подтвердите доверие к папке. Типичное начало выглядит так:

$ cd ~/my-project
$ claude
> /login            # только в первый раз: вход через браузер
> что делает этот проект?
> /theme            # выберите тему под свой терминал
> /terminal-setup   # если вы в VS Code, Cursor, Alacritty или Zed

Как выбрать модель в терминале?

Два способа: внутри сессии команда /model открывает интерактивный выбор (стрелки меняют уровень усилий, клавиша s применяет модель только к текущей сессии). Либо решите до запуска — флагом:

claude --model sonnet

Как настроить Claude Code в терминале VS Code?

Выполните /terminal-setup один раз внутри Claude Code во встроенном терминале VS Code: это сразу починит Shift+Enter и глюки GPU-ускорения. Два предупреждения из документации именно про VS Code: очень большие вставки во встроенном терминале могут молча терять символы — длинные логи лучше сохранить в файл и попросить Claude его прочитать; а на macOS добавьте в настройки VS Code "terminal.integrated.macOptionIsMeta": true, чтобы шорткаты с Option (например, Option+P для выбора модели) вообще доходили.

Уведомления, тема и статус-бар

Когда Claude заканчивает работу или ждёт разрешения, он шлёт событие-уведомление. Ghostty, Kitty и iTerm2 по умолчанию пробрасывают его в системный центр уведомлений (в iTerm2 включите «Notification Center Alerts» и «Send escape sequence-generated alerts» в Settings → Profiles → Terminal). В остальных терминалах задайте preferredNotifChannel равным terminal_bell в настройках — или сделайте красиво через хук Notification:

{ "hooks": { "Notification": [ { "hooks": [ { "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" } ] } ] } }

/statusline покажи модель, текущую папку и процент контекста

Свои клавиши, если дефолты раздражают

Команда /keybindings создаёт и открывает файл ~/.claude/keybindings.json. Это список контекстов (Chat, Global, Confirmation и так далее), где клавиши сопоставлены действиям вроде chat:submit или chat:newline — а значит, можно даже поменять местами Enter и Shift+Enter, если милее поведение мессенджера. Значение null снимает привязку, поддерживаются аккорды вроде ctrl+x ctrl+e, а правки применяются на лету без перезапуска. Ctrl+C и Ctrl+D зарезервированы и не переназначаются; конфликты покажет /doctor.

Практический финал: проделайте пять шагов выше прямо сейчас, затем нарочно вставьте длинный промпт и понажимайте Ctrl+J между абзацами. В момент, когда многострочный промпт впервые уйдёт ровно тогда, когда вы хотели, — а не на три предложения раньше, — вы поймёте, зачем существует эта страница.