← Все гайды AI Release
EN Подписаться на @ai_release1

Как удалённо управлять Claude Code и Codex с телефона: настройка CodeRail

Обновлено: 06.11.2026 · AI Release · @ai_release1
Как удалённо управлять Claude Code и Codex с телефона: настройка CodeRail

TL;DR

Требования и подготовка

Иллюстрация к разделу «Требования и подготовка»
Иллюстрация к разделу «Требования и подготовка»

CodeRail — это self-hosted пульт (панель, развёрнутая на вашем собственном сервере) для Claude Code и Codex: чаты, подтверждения вызовов инструментов, терминалы, файлы, git и браузер на каждой вашей машине. Серверная часть — один контейнер ghcr.io/wiva-hq/coderail, веб-интерфейс на порту 8080 за HTTPS, всё состояние в ./data.

Схема из чего состоит система:

КомпонентГде работаетЧто делает
Сервер CodeRailваш сервер, контейнер `ghcr.io/wiva-hq/coderail`отдаёт веб-интерфейс на 8080, хранит историю в `./data`
Мост (bridge)каждая управляемая машинаходит только наружу, к серверу
Claude Code и Codexкаждая управляемая машинаключи остаются локально, на сервер не уезжают

Ключевое следствие: сервер должен быть доступен с телефона, а машины — только исходящие соединения к серверу. Сквозного шифрования нет — история хранится на вашем сервере, это надо принять до установки.

Проверьте базу списком:

Что сделать: выполнить диагностику одной пачкой.

Зачем: если Docker не установлен или порт занят, контейнер не поднимется, и вы будете искать причину не там.

Как проверить:

docker --version
docker compose version
uname -m
ss -ltnp | grep ':8080' || echo "порт 8080 свободен"
df -h / | tail -1

Ожидаемый вывод: строка вида Docker version 2x.x.x, Docker Compose version v2.x, x86_64 (это amd64) или aarch64 (это arm64), сообщение порт 8080 свободен и строка с запасом места. Почему это работает: ss -ltnp показывает занятые TCP-порты, поэтому пустой вывод по 8080 означает, что публикация порта не конфликтует.

Шаг 1. Подготовить каталог состояния

Что сделать: создать рабочий каталог и подкаталог data рядом с файлом конфигурации.

Зачем: всё состояние CodeRail хранится в ./data; если каталог не смонтировать как том, история исчезнет при пересоздании контейнера.

Как проверить:

mkdir -p ~/coderail/data
cd ~/coderail
pwd && ls -la

Ожидаемый вывод: путь вида /home/<user>/coderail и список с каталогом data. Почему это работает: Docker монтирует каталог хоста внутрь контейнера, и запись переживает docker compose down — при условии, что путь тома совпадает с тем, который ожидает образ.

Пример: если вы работаете под пользователем deploy, команда pwd вернёт /home/deploy/coderail.

Шаг 2. Запустить сервер и подключить машины

Иллюстрация к разделу «Шаг 2. Запустить сервер и подключить машины»
Иллюстрация к разделу «Шаг 2. Запустить сервер и подключить машины»

Что сделать: создать docker-compose.yml, поднять контейнер, поставить перед ним HTTPS и установить мост на управляемые машины.

Зачем: контейнер даёт веб-интерфейс на 8080, а мост на каждой машине превращает её в управляемую — без него в панели не будет ни чатов, ни терминалов.

Как проверить: см. блок команд ниже и Шаг 3.

Файл ~/coderail/docker-compose.yml:

services:
  coderail:
    image: ghcr.io/wiva-hq/coderail
    container_name: coderail
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data

Внутренний путь тома (/app/data) сверьте с документацией проекта wiva-hq/CodeRail: важен именно он, иначе данные окажутся вне смонтированного каталога.

Запуск:

cd ~/coderail
docker compose pull
docker compose up -d

Ожидаемый вывод: Container coderail Started. Почему это работает: pull забирает образ под вашу архитектуру (amd64 или arm64), up -d запускает его в фоне с автоперезапуском.

Дальше HTTPS. Порт 8080 — единственный опубликованный порт, поэтому TLS ставится перед ним на reverse-proxy. Пример шаблона для Caddy (домен замените на свой):

<ваш-домен> {
    reverse_proxy 127.0.0.1:8080
}

<ваш-домен> — это DNS-имя, которое указывает на IP сервера, например coderail.myteam.dev. Как именно CodeRail ожидает TLS и требуется ли ему знание о внешнем адресе — сверьтесь с документацией проекта.

Затем на каждой машине, которой хотите управлять, установите мост. Точную команду установки и список параметров берите из README репозитория wiva-hq/CodeRail — в посте канала она не приводится, выдумывать синтаксис нельзя. Логика та же, что у любого агента за NAT: мост инициирует исходящее соединение к вашему серверу, поэтому проброс портов на машинах не нужен, а ключи Claude и Codex остаются на компьютерах.

Пример: сервер — ARM-VPS (aarch64), образ берётся под arm64 без отдельного тега; телефон открывает https://coderail.myteam.dev, ноутбук с Claude Code держит исходящее соединение к этому же домену.

Если управляете несколькими агентами сразу, схему «пульт на телефоне + агенты на машинах» удобно расширять по гайду Как превратить чёлку MacBook в пульт управления ИИ-агентами: настройка Claude Code, Codex, Cursor и Copilot.

Шаг 3. Проверить работу с телефона

Иллюстрация к разделу «Шаг 3. Проверить работу с телефона»
Иллюстрация к разделу «Шаг 3. Проверить работу с телефона»

Что сделать: последовательно проверить контейнер, HTTP-ответ локально, HTTPS снаружи и живую сессию с телефона.

Зачем: каждая проверка отсекает свой класс поломок — упавший контейнер, занятый порт, неверный TLS, непривязанный мост.

Как проверить:

docker ps --filter name=coderail --format 'table {{.Status}}\t{{.Ports}}'
docker logs --tail 30 coderail
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8080
curl -sS -I https://<ваш-домен> | head -1
ls -la ~/coderail/data

Что должно появиться на экране:

Финальная проверка глазами: откройте https://<ваш-домен> в браузере телефона, войдите, найдите в списке свою машину, отправьте агенту короткий запрос и подтвердите вызов инструмента прямо из интерфейса.

Чек-лист приёмки:

Возможные проблемы и решения

Проблема. Контейнер не стартует, порт занят

Проблема. С телефона страница не открывается по HTTPS

Проблема. Docker не принимает команды от пользователя

Резюме и следующие шаги

Один контейнер ghcr.io/wiva-hq/coderail с томом ./data, HTTPS перед портом 8080 и мост на каждой машине дают вам пульт управления Claude Code и Codex с телефона. Дальше стоит закрыть доступ по сети (VPN или allowlist на reverse-proxy) и проверить, как встраивать такую схему в командную работу — см. Claude Code для команды: как настроить субагентов и общий ИИ-суперагент.

FAQ

Нужно ли ставить приложение на телефон?

Нет. CodeRail — веб-интерфейс на порту 8080, поэтому достаточно браузера телефона и адреса https://<ваш-домен>.

Где хранятся ключи Claude и Codex?

На компьютерах, где они установлены, — мост ходит только наружу, ключи на сервер не уезжают. При этом история диалогов хранится на вашем сервере.

Есть ли сквозное шифрование истории?

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

На каком железе пойдёт сервер?

Образ ghcr.io/wiva-hq/coderail собран под amd64 и arm64, то есть подходит и обычный x86-VPS, и ARM-машина. Конкретные требования к памяти сверьтесь с документацией проекта.

🤖 Кратко для ИИ

Связанные посты

📚 Связанные гайды

Как превратить чёлку MacBook в пульт управления ИИ-агентами: настройка Claude Code, Codex, Cursor и Copilot

Пошаговая настройка приложения в области чёлки MacBook, чтобы запускать и переключать Claude Code, Codex, Cursor и Copil

Claude Code Desktop: установка, лимиты и чем отличается от терминала

Как поставить настольное приложение Claude Code, чем оно отличается от CLI, какие есть ограничения по токенам и когда лу

Claude Code для команды: как настроить субагентов и общий ИИ-суперагент

Пошаговый гид по настройке Claude Code для нескольких разработчиков: субагенты, MCP-серверы, общие правила и единый супе