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

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

Как поставить Codex CLI на сервер, войти через ChatGPT, создать рабочую папку агента, задать AGENTS.md и подключить управление через Telegram.

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

Как работает Codex CLI

Codex CLI - агент OpenAI в терминале. Он работает в папке проекта, читает файлы, запускает команды, вносит изменения, пишет отчеты и может использовать non-interactive режим для Telegram bridge.

слой 1

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

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

слой 2

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

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

слой 3

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

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

02 / УСТАНОВКА

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

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

Подготовка VPS

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

Установка Codex CLI

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version
codex --help

Вход

codex login
codex login status

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

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

Запуск из bridge

codex exec \
  --json \
  --skip-git-repo-check \
  -C /opt/ai-agents/codex-team \
  "USER_TASK_HERE"
03 / ВХОД И ПРАВА

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

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

ВажноОсновной сценарий - `codex login` через ChatGPT.
ВажноAPI key можно использовать для CI, скриптов и автоматизаций.
ВажноНе выставляйте агента в публичный доступ и ограничивайте Telegram по chat id.
04 / ПРАВИЛА

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

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

# AI Agent Server

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

Rules:
- Reply in the user language.
- Save inbound files under workspace/inbox/.
- Save generated files under workspace/output/.
- Ask before external sends.
- For long tasks, create checkpoints.
- 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 запускает codex exec в рабочей папке.

ШАГ 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://learn.chatgpt.com/docs/codex/cli
https://learn.chatgpt.com/docs/auth
https://learn.chatgpt.com/docs/non-interactive-mode
https://learn.chatgpt.com/docs/agent-configuration/agents-md
Telegram Bot API: https://core.telegram.org/bots/api
PM2 startup: https://pm2.keymetrics.io/docs/usage/startup/

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

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