Клодная Приложение для MacМой кабинет ↗

От установки
до первого запроса.

«Клодная» — приложение на вашем Mac. В его окне можно работать с Claude Code прямо на компьютере или подключиться к личной Ubuntu команды. Выберите, где должны лежать рабочие файлы.

Установка на Mac

  1. Откройте страницу «Клодная для Mac». Для приложения, Claude Code и Tailscale нужна macOS 13 Ventura или новее. Подходят Mac с Apple Silicon и Intel. Версию системы посмотрите в меню Apple → «Об этом Mac». Для пилота приложение собирается прямо на вашем Mac. Установка Клодной · Требования Claude Code · Требования Tailscale
  2. Установите и откройте приложение. На странице установки нажмите «Скопировать команду». Нажмите ⌘ + Пробел, введите «Терминал» и нажмите Return. Вставьте команду (⌘ + V) и нажмите Return ещё раз. Если macOS предложит инструменты разработчика Apple, нажмите «Установить» и оставьте окно Терминала открытым. Как только инструменты готовы, сборка начинается автоматически. На ожидание отведено до 30 минут. Если время истекло, дождитесь установки Apple и повторите ту же команду.
  3. Дождитесь окна «Клодной». Команда скачает исходники, сверит контрольную сумму, соберёт приложение и откроет его. Для следующего запуска найдите «Клодную» в своей папке «Программы» (~/Applications/Klodnaya.app).
  4. Запустите Claude Code. Если вы собираетесь работать на Ubuntu, перейдите к выдаче сервера. Для работы на этом Mac выберите «Запустить Claude на Mac». Если Claude Code ещё нет, запустите его установку прямо из приложения, проверьте предложенное действие и подтвердите. Дождитесь завершения установки и нажмите кнопку локального запуска. Получить Ubuntu · Инструкция Anthropic
  5. Войдите в Claude. Следуйте запросу самого Claude Code и подтвердите вход в браузере. Используйте свой аккаунт с доступом к Claude Code. На новом устройстве или на отдельной Ubuntu вход может потребоваться ещё раз. Для использования Claude важна страна, в которой находится сотрудник. Россия отсутствует в списке поддерживаемых регионов Anthropic, в том числе при работе через удалённый сервер. Поддерживаемые регионы

Если вы видите приглашение Claude Code в окне «Клодной», можно вводить задачу. Для локальной работы сервер команды и Tailscale не требуются.

Где найти исходники и готовое приложение?

На странице установки есть два ZIP. В архиве исходников лежат код и install-local.sh. Их можно посмотреть и собрать вручную. В готовом архиве лежит Klodnaya.app для Apple Silicon и Intel. У пилотной сборки локальная подпись, поэтому проверка издателя macOS может остановить её запуск. В этом случае воспользуйтесь установкой из исходников выше.

Открыть страницу загрузки

Личный сервер команды

Установите «Клодную» на Mac. При таком подключении Claude Code запускается на Ubuntu. Сервис устанавливает его на сервер, а для входа вы используете свой аккаунт с доступом к Claude Code. Где Anthropic предоставляет услуги

  1. Создайте кабинет. Возьмите у организатора код команды, введите его вместе с рабочей почтой и придуманным паролем от 12 символов. Сохраните выданный личный код восстановления в менеджере паролей. Нажмите «Перейти в кабинет». При повторном входе достаточно почты и пароля. Регистрация · Вход
  2. Проверьте доступность. Кнопка «Открыть мой сервер» показывает состояние вашей машины. Когда выдача включена и машины ещё нет, появится «Запустить бесплатно». Нажатие резервирует одно место. Инфраструктуру предоставляет команда. Повторное нажатие обращается к той же машине. Проверить мой сервер
  3. Дождитесь подготовки. Клодная создаёт Ubuntu и устанавливает Claude Code и Tailscale. Держите страницу открытой или вернитесь позже. Для повторной проверки нажмите «Обновить статус». Создание кабинета само по себе машину не заказывает.
  4. Подключите Mac к Tailscale. Установите приложение Tailscale, войдите под учётной записью своей сети и включите соединение. При первом запуске macOS может запросить разрешение добавить сетевую конфигурацию. Если Tailscale уже работает, проверьте выбранную сеть. Tailscale для Mac
  5. Добавьте Ubuntu в ту же сеть. Нажмите «Добавить сервер в Tailscale» в кабинете. На странице Tailscale проверьте название сети и подтвердите добавление устройства. Если сеть управляется компанией, администратору может понадобиться одобрить устройство и разрешить SSH для вашего аккаунта к пользователю desktop этой Ubuntu. Вернитесь в кабинет и обновите статус.
  6. Откройте выданный сервер в приложении. Нажмите «Открыть в Клодной» на странице сервера. Подтвердите запрос браузера открыть приложение. Окно покажет пользователя desktop и частный адрес из кабинета. Сверьте адрес и нажмите «Подключиться к серверу».
  7. Завершите первый вход. SSH может запросить подтверждение ключа сервера. Если показан отпечаток, сверьте его с организатором перед подтверждением. Tailscale может запросить повторный вход в браузере. После подключения сервер откроет папку /home/desktop/Projects и запустит установленный Claude Code. Если он предлагает авторизацию, войдите со своим аккаунтом и вернитесь в окно.

Рабочее соединение видно в терминале после входа в Ubuntu. Наличие ссылки в кабинете подтверждает готовность сервера к подключению. Прохождение SSH и вход в Claude проверяются на вашем Mac.

Первый сеанс

Введите в уже запущенном Claude Code короткое задание и нажмите Return.

Покажи полный путь к текущей папке и перечисли файлы в ней. Ничего не меняй.

Если Claude запросит разрешение на действие, проверьте команду и подтвердите его в окне. В локальном режиме папка расположена на Mac. В серверном ожидайте путь /home/desktop/Projects. Пустой список при первом входе — нормальный результат.

Где сохраняются изменения
Проект на Mac
~/Library/Application Support/Klodnaya/Projects находится в домашнем каталоге пользователя macOS. В приложении его можно открыть через «Папка проекта».
Проект на Ubuntu
Файлы из /home/desktop/Projects сохраняются на диске выданной машины. Подключение с Mac передаёт команды и вывод. Для переноса файлов между устройствами нужна отдельная операция.
Заметки в кабинете
Их хранит Клодная в Cloudflare под учётной записью сотрудника. Для доступа к ним из Claude подключите MCP по инструкции ниже.
Что случится при закрытии окна или потере сети

«Завершить» останавливает процесс этой сессии терминала. При закрытии окна или разрыве SSH работающий процесс может завершиться. Уже записанные файлы остаются на соответствующем диске.

Включите Tailscale, убедитесь, что текущий адрес в кабинете прежний, затем используйте «Подключиться снова». Это новый SSH-вход. Для локального режима используйте «Запустить снова». Перед повтором прерванной команды проверьте, что успело сохраниться.

Как дать Claude свою заметку

MCP — способ, которым Claude получает у вас разрешение читать текст из кабинета. Например, коллега прислал бриф. Вы сохраняете его один раз и можете спросить Claude о сроках из этого брифа. Для обычной работы в терминале этот шаг можно пропустить.

Сохранить бриф, подключить и проверить чтение
  1. В «Моих заметках» нажмите «Новый файл» и сохраните текст. Для первой проверки можно раскрыть «Проверить чтение заметки» и сохранить готовый пример brief.txt. В кабинете помещается до 64 текстовых файлов, до 64 КиБ каждый.
  2. На сайте Клодной откройте «Подключить заметки к Claude» → «Подключить заметки в приложении». Разрешите браузеру открыть приложение. В окне «Клодной» нажмите «Подключить заметки». На этом Mac сохранится адрес вашего кабинета для локальных сеансов.
  3. Нажмите «Запустить Claude на Mac». Если ещё требуется вход в MCP, введите /mcp в Claude Code, выберите klodnaya, затем Authenticate. В браузере войдите в свой кабинет и проверьте название приложения. «Разрешить доступ» открывает чтение всех заметок в этом кабинете. Клиент может отдельно запросить право создавать и менять файлы.
  4. Отправьте Claude запрос «Прочитай brief.txt в Клодной. Что нужно сделать до четверга?» В примере ответ — согласовать тему рассылки и баннер. В кабинете откройте проверку чтения. После фактического чтения появится имя заметки.

В «Управлении доступом» нажмите «Отозвать все подключения», чтобы закрыть доступ всем ранее подключённым приложениям. Для следующего чтения потребуется новое разрешение. Уже сохранённые заметки останутся в кабинете. Чтобы убрать адрес из приложения на своём Mac, выберите в меню «Клодная» → «Забыть подключение заметок…» и подтвердите. Это действует со следующего локального запуска Claude.

Открыть кабинет ↗
Я использую другое приложение или обычный Терминал

В кабинете раскройте «Подключить через браузер или другое приложение» и скопируйте персональный адрес MCP. В настройках клиента добавьте удалённый MCP по HTTP с этим адресом и подтвердите доступ в браузере. Ссылка содержит идентификатор кабинета. Чтение начинается после авторизации.

Для обычного Терминала есть пункт «Подключить вручную в Терминале macOS» с готовой командой. Настройка на Mac применяется к Mac. Для работы с заметками в удалённом Claude Code подключение нужно настроить и авторизовать на Ubuntu отдельно.

Сотрудник может разрешить проверку готовности своей машины и спросить Claude «Готов ли мой сервер?». Инструмент server_status возвращает состояние машины, пояснение и ссылку на кабинет. Если команда ещё не подключила выдачу, в ответе будет offline. Для старого подключения с доступом только к заметкам пройдите авторизацию в /mcp заново. При подключённом шлюзе инструмент server_setup даёт ссылку на страницу сервера команды. Выдачу машины подтверждает сотрудник кнопкой «Запустить бесплатно» в браузере.

Если что-то пошло иначе

«Выдача Ubuntu пока не подключена» или «Все серверы команды заняты»

В первом случае организатору нужно подключить инфраструктуру Hetzner. Во втором все выделенные команде места уже заняты. Уточните доступность у организатора. Локальный режим приложения и кабинет доступны отдельно.

«Проверяем связь» или в кабинете нет адреса

Через минуту нажмите «Обновить статус». Если вы уже добавили машину в Tailscale и видите запрос на одобрение, сообщите администратору сети. Если срок ссылки прошёл, откройте страницу сервера заново, чтобы получить актуальную ссылку. Организатору передайте время, надпись на экране и шаг, на котором остановились.

Браузер остался на сайте, приложение не открылось

Откройте «Клодную» один раз из Finder, вернитесь на страницу готового сервера и нажмите кнопку снова. В запросе браузера разрешите запуск приложения. Запасной способ — скопировать предложенную команду ssh в обычный Терминал macOS.

SSH сообщает о тайм-ауте, запрете доступа или смене ключа

При тайм-ауте проверьте, что Mac подключён к той же сети Tailscale, что и Ubuntu. При отказе в доступе администратор проверяет устройство, сетевые правила и правило Tailscale SSH для пользователя desktop. Если уже знакомый адрес предъявляет другой ключ, прервите попытку и попросите организатора подтвердить адрес машины и новый отпечаток. Документация Tailscale SSH

Открылся терминал Ubuntu, но Claude Code ещё не появился

Проверьте страницу сервера. Надпись «Установка Claude Code ещё не подтверждена» означает, что SSH уже доступен. Когда установка завершится, переподключитесь к серверу. Если состояние сохраняется, сообщите организатору время запуска и надпись из кабинета.

Claude просит войти или не видит мои файлы

Войдите в Claude на том устройстве, где он запущен. Сверьте путь к папке, если файл лежит на диске. Если он сохранён в браузерном кабинете, завершите подключение к заметкам и попросите прочитать файл именно в Клодной. Проверить доступ к заметкам

Забыт пароль от кабинета

Введите почту, личный код восстановления и новый пароль. Сохраните новый код, когда он появится. После смены пароля заново подключите приложения к заметкам. Восстановить доступ

Для организатора

Что происходит от подготовки до первой машины
  1. Организатор выбирает проект Hetzner, европейский регион, типы шлюза и рабочих машин, лимит мест и внешний IP для административного SSH. Шаблон рабочей Ubuntu задаёт регион hel1 (Хельсинки) и тип cpx32. Перед запуском проверьте доступность региона и тарифа в своём проекте.
  2. На Mac организатора требуются Node.js, утилита hcloud, OpenSSH, административная SSH-пара и доступ к зоне сайта. Подготовьте ключ отдельного проекта Hetzner с правами Read & Write, служебный секрет для связи сайта со шлюзом и код для регистрации сотрудников. Перед заказом шлюза проверьте настройки Cloudflare и доступ к отдельному DNS-имени для шлюза.
  3. Установщик проверяет настройки, создаёт шлюз с постоянным хранилищем, настраивает firewall, отдельное DNS-имя шлюза и HTTPS. Привязка к сайту включается после проверки состояния шлюза с авторизацией. Запуск пустого шлюза оставляет все места свободными.
  4. При нажатии сотрудником кнопки запуска сайт передаёт идентификатор его аккаунта шлюзу. Шлюз сохраняет соответствие между аккаунтом и машиной, проверяет лимит и повторяет незавершённую подготовку. Обновление страницы показывает состояние прежнего запроса.
  5. Перед приглашением всей команды организатор проходит путь с тестовым сотрудником и настоящей Ubuntu. Нужно увидеть готовность сервера, добавить его в Tailscale, открыть нативное приложение, войти по SSH, запустить Claude Code и проверить доступ к сохранённому файлу после переподключения. Кабинет и проверка заметок через MCP проверяются отдельно от этого первого удалённого сеанса.

При завершении работы сотрудника отдельно отзовите доступ в сети Tailscale и согласуйте сохранение или удаление данных Ubuntu. Закрытие терминала не освобождает место, выделенное команде в Hetzner.