Начало работы с Arc OS
Arc OS — система оркестрации AI для команд разработки. Этот гайд объясняет, что такое Arc OS, зачем он существует и как начать эффективно им пользоваться.
Что такое Arc OS?
Arc OS — платформа, которая позволяет собрать и развивать личную AI-команду разработки поверх Claude.
Ключевая идея: вместо того чтобы открывать новый AI-чат каждый раз, когда нужна помощь, у тебя есть персистентные AI-воркеры, которые:
- Знают твою кодовую базу, архитектуру и историю
- Никогда не теряют контекст между сессиями
- Специализируются каждый на своей роли
- Используют общую базу знаний проекта
Команду ты собираешь один раз. Дальше просто работаешь с ней — через CLI, IDE или веб.
Главная идея: одна LLM, общий контекст, специализированные роли
Большинство разработчиков используют AI как одноразовый чат — вставил код, получил ответ, забыл.
Arc OS устроен иначе:
Одна LLM (Claude) — все воркеры работают на Claude. Мы выбрали Claude за длинное контекстное окно, следование инструкциям и качество кода. Подписку на Claude ты приносишь свою.
Без потери контекста — у каждого воркера есть доступ к:
- Вики проекта (архитектурные решения, конвенции, заметки)
- Скиллам (кастомные инструкции для конкретных задач)
- Трекеру задач (что в работе, что сделано)
- Истории сессий (что обсуждалось раньше)
Специализированные роли — у каждого воркера своя личность, права и назначение:
| Воркер | Роль | Что делает |
|---|---|---|
| Developer | Полный доступ | Пишет код, выполняет команды, коммитит, отлаживает |
| Consultant | Только чтение | Делает ревью, объясняет, советует — никогда не трогает файлы |
| Designer | Фокус на UI/UX | Дизайн компонентов, доступность, визуальные системы |
| Sentinel | Безопасность | Аудит кода, поиск уязвимостей, харднинг систем |
| Archivist | Документация | Пишет доки, поддерживает вики, формирует отчёты |
| Product Owner | Планирование | Ведёт roadmap, создаёт задачи, приоритизирует бэклог |
Можно также создавать кастомных воркеров под свои нужды.
Что такое проект?
Проект в Arc OS соответствует одной кодовой базе или продукту, над которым ты работаешь.
У каждого проекта есть:
- Свой набор воркеров (Developer, Consultant и т. д.)
- Своя вики (архитектурные доки, решения, конвенции)
- Свои скиллы (кастомные инструкции, инжектируемые воркерам)
- Свой трекер задач (таски, баги, фичи)
- Своя история сессий
Проектов может быть несколько — по одному на продукт, клиента или репозиторий.
Основной способ работы: CLI Bridge
CLI bridge — главный интерфейс Arc OS. Он подключает твой локальный терминал или IDE напрямую к AI-воркерам.
# Start a Developer session on project "my-app"
arc my-app developer
# Start a Consultant (read-only) session
arc my-app consultant
# Continue the previous session (restores context)
arc my-app developer continue
Когда ты запускаешь arc <project> <worker>, воркер:
- Загружает вики проекта, скиллы и активную задачу
- Открывает интерактивную сессию Claude в твоём терминале
- Получает полный доступ к локальной файловой системе (Developer) или только чтение (Consultant)
- Сохраняет контекст сессии для следующего раза
Почему CLI-first?
- Работает в любом терминале (macOS, Linux, Windows)
- Интегрируется с VS Code, Cursor, JetBrains через панель терминала
- Без переключения контекста — остаёшься в своём редакторе
- Понимает Git: воркер видит текущую ветку, staged-изменения, последние коммиты
Ключевые команды arc CLI
arc <project> <worker> # Start a session
arc <project> <worker> continue # Resume previous session
arc sessions <project> # Browse past sessions
arc issues # List open issues
arc issue create --title "..." # Create new issue
arc issue log <id> "progress note" # Log progress
arc skill <name> # Load a skill into context
arc wiki # Browse project wiki
arc roadmap # View project roadmap
arc retro <project> # Reconstruct issues from history
Как начать
Шаг 1 — Установи arc CLI
Скачай бинарник для своей ОС из дашборда Arc OS (Settings → CLI).
# macOS / Linux
chmod +x arc-linux-x64
sudo mv arc-linux-x64 /usr/local/bin/arc
arc --version
Шаг 2 — Создай первый проект
В CRM-дашборде:
- Нажми New Project
- Дай ему имя и подключи свой GitHub-репозиторий
- Система автоматически создаст команду воркеров
Шаг 3 — Добавь скиллы (опционально, но рекомендуется)
Скиллы — это кастомные наборы инструкций, которые делают воркеров умнее в контексте твоего проекта:
- Конвенции стиля кода
- Архитектурные паттерны, которые ты используешь
- Библиотеки и фреймворки в твоём стеке
- Что воркер должен делать всегда / не делать никогда
Открой Skill Registry → Generate — система прочитает твою кодовую базу и предложит скиллы автоматически.
Шаг 4 — Запусти первую сессию
arc my-project developer
Воркер Developer представится, загрузит контекст проекта и будет ждать первую задачу.
Шаг 5 — Подключи Telegram (опционально)
Если хочешь отправлять воркерам быстрые сообщения с телефона или вдали от компьютера, подключи Telegram через Settings → Telegram Bot.
Telegram опционален — вся основная функциональность работает через CLI.
Как воркеры делятся знаниями
Все воркеры одного проекта используют общие:
Вики — markdown-документы о проекте, которые пишешь ты или воркеры. Архитектурные решения, API-конвенции, «что нужно знать», заметки для онбординга. Воркеры автоматически читают вики при старте сессии.
Скиллы — переиспользуемые наборы инструкций. Скилл «TypeScript strict mode» или «всегда сначала пиши тесты» инжектируется в каждую релевантную сессию воркера.
Задачи — когда воркер работает над задачей #42, он знает этот контекст. Другие воркеры видят, что сейчас в работе.
История сессий — воркеры могут обращаться к тому, что обсуждалось в прошлых сессиях, через arc sessions или continue.
Standard Cloud — постоянно доступный воркспейс
Standard Cloud уже доступен. С подпиской Standard Cloud ты получаешь выделенный Docker-контейнер на серверах Arc OS (Hetzner).
Что это даёт
Персистентные файлы проекта на VPS
Твоя директория /workspace живёт на сервере — не на ноутбуке. Файлы на месте, когда ты возвращаешься, даже после выключения компьютера.
/workspace/my-project/ ← your code, always available
/home/arcuser/.claude/ ← Claude auth, persisted
/home/arcuser/.ssh/ ← GitHub SSH key, persisted
Синхронизация с GitHub по SSH
В контейнере есть выделенный SSH-ключ, привязанный к твоему GitHub-аккаунту. Делаешь git clone один раз — дальше git pull / push откуда угодно без повторной аутентификации.
# Inside your container workspace
cd /workspace
git clone [email protected]:you/project.git # once
git pull # any time, from any device
Доступ с любого устройства Открой CRM Arc OS с телефона, планшета или другого компьютера — воркспейс и файлы ровно там, где ты их оставил. Никакой проблемы «проект остался на другой машине».
Продолжай с того места, где остановился
# In Telegram, next morning:
/continue
# Worker responds:
# Yesterday: finished auth middleware, tests remaining
# Continuing...
Воркер подхватывает контекст прошлой сессии и продолжает работать — пока ты пьёшь кофе.
Что включено
| Возможность | Free / Local | Standard Cloud |
|---|---|---|
| arc CLI (локально) | ✅ | ✅ |
| CRM-дашборд | ✅ | ✅ |
| Персистентный воркспейс на VPS | ❌ | ✅ |
| GitHub SSH-интеграция | ❌ | ✅ |
| Доступ с любого устройства | ❌ | ✅ |
| /continue из Telegram | ❌ | ✅ |
| Файлы переживают закрытие ноутбука | ❌ | ✅ |
Как активировать
- Открой Billing → Standard Cloud
- Оформи подписку (актуальные цены — в дашборде)
- Нажми Create Cloud Workspace — контейнер готов меньше чем за 60 секунд
- Подключи Claude Code (твоя подписка Claude Pro)
- Подключи GitHub SSH-ключ
- Склонируй проект в
/workspace
Подписка Claude Pro/Max — отдельная, ты приносишь свою. Arc OS не взимает плату за использование Claude.
Чем Arc OS НЕ является
- Не автономный агент — воркеры не работают в фоне без тебя. Каждая сессия начинается, когда ты её открываешь.
- Не бот клиентской поддержки — воркеры общаются с тобой (разработчиком), а не с твоими конечными пользователями.
- Не инструмент автоматизации workflow — Arc OS сам не подключается к внешним API. Воркеры помогают тебе писать код, который это делает.
- Не замена Claude.ai — Arc OS построен поверх Claude, добавляя контекст проекта и структуру команды.
Частые первые вопросы
В: Нужен ли мне Telegram? Нет. Telegram опционален. Основной интерфейс — CLI bridge.
В: Делятся ли воркеры контекстом друг с другом? Да — через общие вики, скиллы и трекер задач. Живое состояние сессий они не разделяют, но читают одну и ту же базу знаний.
В: Могу ли я кастомизировать воркеров? Да. Worker Studio (в CRM) позволяет редактировать системный промпт, скиллы и поведение каждого воркера.
В: Как работает биллинг? Ты используешь собственную подписку Claude Pro или Max. Arc OS не добавляет плату за использование Claude — ты платишь Anthropic напрямую. Arc OS берёт платформенную плату за дашборд и инструменты.
В: Что если мне нужен тип воркера, которого нет в списке? Создай кастомного воркера в Worker Studio. Задай его роль, права и подключи любые нужные скиллы.
Твои данные и приватность
Arc OS спроектирован так, чтобы твои данные оставались под твоим контролем.
Экспорт данных (GDPR ст. 20)
Полный JSON-экспорт всех данных аккаунта можно скачать в любой момент:
- Открой Settings → Security → Download my data
- JSON-файл генерируется и скачивается сразу
Экспорт включает данные аккаунта, проекты, историю чатов, задачи, страницы вики, скиллы и журналы активности. Лимит — 3 экспорта за 24 часа.
Удаление аккаунта (GDPR ст. 17)
Аккаунт можно навсегда удалить в любой момент:
- Открой Settings → Security → Delete account
- Подтверди удаление
Это немедленно и безвозвратно стирает все твои данные во всех таблицах — проекты, историю чатов, скиллы, записи vault, журналы активности и саму запись аккаунта. Действие необратимо.
Чего мы не делаем
- Мы не используем твой код, промпты или ответы AI для обучения моделей
- Мы не встраиваем рекламные трекеры или аналитические SDK
- Мы не устанавливаем HTTP-cookies — всё состояние сессии хранится в
localStorage - Мы не передаём твои данные третьим сторонам сверх необходимого для работы сервиса (Cloudflare CDN, инференс AI от Anthropic, OAuth-провайдеры)
Полная политика: Privacy Policy.