Руководство по настройке 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 --name <machine> -o json
- Deploy: rdc repo up --name <repo> -m <machine> --yes
- Containers: rdc machine containers --name <machine> -o json
- Health: rdc machine health --name <machine> -o json
- SSH: rdc term connect -m <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 --name prod-1 -o json
→ Shows machine status, repositories, containers, services

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

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

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

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

You: "Why is the nextcloud container unhealthy?"

Claude Code runs: rdc machine containers --name 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 помогает снизить использование контекстного окна, когда нужны только определённые данные