architect/ai/runtime/claude/SETUP.md

Claude Code — Установка и настройка

Два типа установки: прямо на сервер или в Docker-контейнер.


Тип 1: Прямо на сервер

Когда: dev-машина, сервер без Docker, быстрая установка.

# Установка
npm install -g @anthropic-ai/claude-code

# Настройки
cat > /root/.claude/settings.json <<EOF
{
  "outputStyle": "default",
  "model": "sonnet",
  "alwaysThinkingEnabled": true,
  "env": {
    "CLAUDE_SERV": "<имя>",
    "CLAUDE_WORKSPACE": "/opt/claude-workspace"
  }
}
EOF

# Воркспейс
git clone https://<token>@git.aipd.ru/platform/workspace /opt/claude-workspace
cd /opt/claude-workspace && claude

Что нужно:
- Node.js 18+
- GIT_TOKEN (для клонирования воркспейса)
- ANTHROPIC_API_KEY (в env или через claude auth)


Тип 2: В Docker-контейнере

Когда: production-сервер, изоляция, автовосстановление после ребута.

/opt/platform/claude/
├── .env                 ← GIT_TOKEN, ANTHROPIC_API_KEY
├── docker-compose.yml
├── Dockerfile
├── entrypoint.sh
└── secrets/             ← резервные копии credentials

Запуск:

cd /opt/platform/claude
docker compose up -d

Entrypoint делает автоматически:
1. git clone/pull воркспейса → стиль актуален из git
2. Создаёт /root/.claude/settings.json
3. Удаляет /root/.claude/output-styles/ (нет конфликта с git-стилем)
4. Восстанавливает .claude.json из volume

Volumes:
| Volume | Путь | Что хранит |
|--------|------|-----------|
| claude-auth | /root/.claude/ | credentials, settings, .claude.json |
| claude-workspace | /opt/claude-workspace/ | воркспейс (git) |

Пересборка без потери данных:

docker compose up --build --force-recreate
# volumes сохраняются — credentials и .claude.json не теряются

Полный сброс (осторожно):

docker compose down -v   # удаляет volumes — потеря credentials!

Стиль (Output Style)

Единственный источник: .claude/output-styles/default.md в git.

Никогда не хранить стиль в /root/.claude/output-styles/.


Настройки по серверам

Сервер Тип Документация
91.218.142.168 (dev-pro-eu) Тип 1 infra/@dev-pro-eu.server/ai.md
155.212.142.142 (aipd) Тип 2 infra/@aipd.server/ai.md