AI
АНКИИ - обучение ИИ-компетенциям / A+I - внедрение ИИ для бизнеса
Codex CLI · Hermes · Claude Code
Инструкция

Claude Code на VPS: установка, настройка и Telegram bridge

Как поставить Claude Code на сервер, войти через Claude.ai или Console, настроить CLAUDE.md, запускать задачи через claude -p и подключить Telegram.

VPS · Telegram · рабочая папка · проверка результата
01 / ЧТО ЭТО

Как работает Claude Code

Claude Code - агент Anthropic в терминале. Он понимает проект, работает с файлами, запускает команды, подключает MCP и хранит проектные инструкции в CLAUDE.md.

слой 1

Сервер хранит рабочую среду

Файлы, папки, логи, команды и готовые материалы лежат в одном месте.

слой 2

Telegram дает быстрый интерфейс

Пользователь ставит задачу обычным сообщением, голосом или файлом.

слой 3

Правила фиксируют границы

Агент знает, куда сохранять результат и где остановиться для подтверждения.

02 / УСТАНОВКА

Базовый сценарий установки

Команды ниже дают практический каркас. Перед production-запуском проверьте актуальную документацию выбранного инструмента.

Подготовка VPS

sudo apt update
sudo apt install -y curl git build-essential ca-certificates tmux ufw

Установка Claude Code

curl -fsSL https://claude.ai/install.sh | bash
source ~/.bashrc
claude --version
claude doctor

Вход

claude
# открыть URL на своем компьютере и вставить code в SSH

Рабочая папка

mkdir -p /opt/ai-agents/claude-team
cd /opt/ai-agents/claude-team
mkdir -p workspace/inbox workspace/output workspace/tmp logs

Запуск из bridge

claude -p \
  --output-format text \
  --max-turns 6 \
  --permission-mode default \
  "USER_TASK_HERE"
03 / ВХОД И ПРАВА

Аутентификация и ограничения

Для личного сервера важнее не “подключить модель любой ценой”, а сделать управляемый контур с понятными правами.

ВажноОсновной сценарий - browser login через Claude.ai или Console.
ВажноНужен Claude Pro, Max, Team, Enterprise или Console.
ВажноANTHROPIC_API_KEY - альтернатива для API-billing и автоматизаций.
04 / ПРАВИЛА

Файл или слой правил: CLAUDE.md

Правила нужны, чтобы агент работал как исполнитель: сохранял файлы в правильные папки, делал чекпоинты и не отправлял ничего наружу без подтверждения.

# AI Agent Server

You are an AI agent running on a VPS and controlled by the owner through Telegram.

Rules:
- Reply in the user language.
- Save inbound files under workspace/inbox/.
- Save generated files under workspace/output/.
- Ask before external sends.
- Do not use dangerous permission mode by default.
- At the end, report what was done and what was checked.
05 / TELEGRAM

Как подключается Telegram

Для личного VPS чаще всего достаточно polling и проверки ALLOWED_CHAT_ID. Webhook нужен при домене, HTTPS и production-нагрузке.

ШАГ 1

Telegram Bot API принимает сообщение.

ШАГ 2

Node.js bridge проверяет ALLOWED_CHAT_ID.

ШАГ 3

Файлы сохраняются в workspace/inbox/.

ШАГ 4

Bridge запускает claude -p.

ШАГ 5

Ответ возвращается в Telegram.

06 / ЗАПУСК

Автозапуск и проверка

Bridge должен переживать перезагрузку сервера и давать понятные логи.

PM2

npm install -g pm2
pm2 start ecosystem.config.cjs --update-env
pm2 save
pm2 startup
pm2 status

Проверка

pm2 logs --lines 100
# В Telegram:
/ping
Скажи коротко, кто ты и где сохраняешь файлы
07 / ИСТОЧНИКИ

Что проверить перед внедрением

Технологии быстро обновляются, поэтому перед установкой всегда сверяйте команды с официальными страницами.

https://code.claude.com/docs/en/setup
https://code.claude.com/docs/en/cli-reference
https://code.claude.com/docs/en/settings
https://code.claude.com/docs/en/memory
https://code.claude.com/docs/en/remote-control
Telegram Bot API: https://core.telegram.org/bots/api
PM2 startup: https://pm2.keymetrics.io/docs/usage/startup/

Главное: агент на VPS должен быть не “умным ботом”, а управляемым исполнителем с папками, правилами, доступами, проверками и отчетом.

Посмотреть общую инфографику про команду ИИ-агентов