Чек-лист

Claude Code на VPS: ваншот-сетап

Взрослый сетап Claude Code под ваншот-проекты: терминал VS Code на VPS (закрыл крышку — агент дорабатывает), Tmux для параллельных проектов, оркестратор агентов, Playwright MCP (глаза на браузер) и план-мод. В браузере — лишь четверть силы.

Содержание6 глав
  1. 011. База: терминал, а не браузер
  2. 022. tmux — несколько проектов в одном терминале
  3. 033. Gastown — оркестратор параллельных агентов
  4. 044. Playwright MCP — агент видит браузер
  5. 055. Plan mode — сначала план, потом код
  6. 066. ponytail — меньше токенов на задачу

Запускать Claude Code только в браузере claude.ai — использовать четверть его возможностей: там нет полного набора permission-режимов, !-шорткатов для bash и tab-completion. Ниже — рабочий сетап под ваншот-проекты: где физически крутится агент, чем вести параллельные задачи и какие открытые инструменты дают основной прирост.

Важно
Название пишется `Gastown` (не «Гастаун»), автор — Стив Йегге. Установка Gastown — не одна команда, а сборка из исходников, закладывай на неё время. У ponytail, наоборот, есть измеренная цифра эффекта — минус 20–27% по стоимости и времени на реальном бенчмарке, а не абстрактное «в разы дешевле».

1. База: терминал, а не браузер

  • Разница: облачные сессии на claude.ai/code дают только часть permission-режимов (Accept edits, Plan, Auto — без Manual и Bypass); полный CLI claude в терминале даёт все режимы, !-шорткаты для bash и tab-completion.
  • VS Code: расширение — графическая панель поверх CLI и не добавляет claude в PATH; чтобы работать именно в терминале, нужен отдельный CLI-инсталл — тогда встроенный терминал ведёт себя как обычный CLI-сеанс.
  • VPS: CLI запускается на удалённом сервере по SSH — сессия продолжает работу независимо от того, открыт ли ноутбук.

2. tmux — несколько проектов в одном терминале

  • Логика: терминальный мультиплексор — несколько независимых окон и панелей внутри одной SSH-сессии, плюс detach/attach: сессия живёт в фоне на сервере после отключения клиента.
  • Практика: одна вкладка tmux — один проект и один агент Claude Code; переключение между 4–5 задачами — горячими клавишами, без новых SSH-подключений.
  • Ссылка: github.com/tmux/tmux.

3. Gastown — оркестратор параллельных агентов

  • Логика: открытый проект Стива Йегге — git-backed координация нескольких агентов: роль Mayor управляет rig'ами, crew-воркспейсы — для ручной работы поверх агентной.
  • Масштаб: README заявляет комфортную работу с 20–30 агентами и отдельный Problems View для отслеживания зависших при 20–50+.
  • Установка: сборка из исходников — brew install dolt icu4c, go install github.com/steveyegge/beads/cmd/bd@latest, git clone https://github.com/steveyegge/gastown.git, cd gastown && make install.
  • Ссылка: github.com/gastownhall/gastown.

4. Playwright MCP — агент видит браузер

  • Логика: официальный MCP-сервер от Microsoft — даёт агенту доступ к странице через accessibility-снапшоты вместо угадывания по текстовому описанию.
  • Установка для Claude Code: claude mcp add playwright npx @playwright/mcp@latest.
  • Ссылка: github.com/microsoft/playwright-mcp.

5. Plan mode — сначала план, потом код

  • Как включить: в CLI Shift+Tab циклически переключает режимы default → acceptEdits → plan; либо добавить /plan перед промтом.
  • Что делает: Claude читает код и исследует, но не редактирует — предлагает план, который можно одобрить целиком, принять с ручной проверкой правок или доработать фидбеком.
  • По умолчанию: закрепляется на проект через "defaultMode": "plan" в .claude/settings.json.

6. ponytail — меньше токенов на задачу

  • Логика: скилл для Claude Code (и полутора десятков других агентных хостов) — перед тем как писать код, агент проверяет по лестнице: нужно ли это вообще, есть ли уже готовое решение, и только потом пишет минимум.
  • Измеренный эффект: на агентном бенчмарке (FastAPI+React репозиторий, 12 задач) — минус 54% кода, минус 22% токенов, минус 20% стоимости, минус 27% времени против агента без скилла.
  • Установка: /plugin marketplace add DietrichGebert/ponytail, затем /plugin install ponytail@ponytail (два отдельных промта).
  • Ссылка: github.com/DietrichGebert/ponytail.

Браузерный Claude Code — стартовая точка; терминал на VPS, оркестратор и plan mode — это уже рабочая связка под ваншоты.