Руководство по настройке Claude Code

Claude Code нативно работает с Rediacc через CLI rdc. Это руководство охватывает настройку, разрешения и типичные рабочие процессы.

Быстрая настройка

Установите CLI: curl -fsSL https://www.rediacc.com/install.sh | bash
Скопируйте шаблон AGENTS.md в корень проекта как CLAUDE.md
Запустите Claude Code в директории проекта

Claude Code читает CLAUDE.md при запуске и использует его как постоянный контекст для всех взаимодействий.

Настройка CLAUDE.md

Разместите файл в корне проекта. Полную версию см. в шаблоне AGENTS.md. Ключевые разделы:

# Rediacc Infrastructure

## CLI Tool: rdc

### Common Operations
- Status: rdc machine query <machine> -o json
- Deploy: rdc repo up <repo> -m <machine> --yes
- Containers: rdc machine containers <machine> -o json
- Health: rdc machine health <machine> -o json
- SSH: rdc term <machine> [repo]

### Rules
- Always use --output json when parsing output
- Always use --yes for automated confirmations
- Use --dry-run before destructive operations

Разрешения инструментов

Claude Code запрашивает разрешение на выполнение команд rdc. Вы можете предварительно авторизовать частые операции в настройках Claude Code:

Разрешить rdc machine query * — проверка статуса только для чтения
Разрешить rdc machine containers * — список контейнеров
Разрешить rdc machine health * — проверки состояния
Разрешить rdc config repository list — список репозиториев

Для деструктивных операций (rdc repo up, rdc repo delete) Claude Code всегда запрашивает подтверждение, если вы явно их не авторизовали.

Примеры рабочих процессов

Проверка статуса инфраструктуры

You: "What's the status of prod-1?"

Claude Code runs: rdc machine query prod-1 -o json
→ Shows machine status, repositories, containers, services

Развёртывание репозитория

You: "Deploy the mail repo to prod-1"

Claude Code runs: rdc repo up mail -m prod-1 --dry-run -o json
→ Shows what would happen
Claude Code runs: rdc repo up mail -m prod-1 --yes
→ Deploys the repository

Диагностика проблем с контейнерами

You: "Why is the nextcloud container unhealthy?"

Claude Code runs: rdc machine containers prod-1 -o json --fields name,status,repository
→ Lists container states
Claude Code runs: rdc term prod-1 -c "docker logs nextcloud-app --tail 50"
→ Checks recent logs

Синхронизация файлов

You: "Upload the local config to the mail repo"

Claude Code runs: rdc repo sync upload -m prod-1 -r mail -l ./config --dry-run
→ Shows files that would be synced
Claude Code runs: rdc repo sync upload -m prod-1 -r mail -l ./config
→ Syncs the files

Советы

Claude Code автоматически определяет не-TTY среду и переключается на JSON вывод — в большинстве случаев указывать -o json не нужно
Используйте rdc agent capabilities, чтобы Claude Code мог обнаружить все доступные команды
Используйте rdc agent schema "command name" для получения подробной информации об аргументах и опциях
Флаг --fields помогает снизить использование контекстного окна, когда нужны только определённые данные