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

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

Запускать 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 — это уже рабочая связка под ваншоты.

---

Источник: https://localhost:3000/m/claude-code-vps-oneshot-setup