start-environment — правило для Claude Code: что делает и установка
Правило start-environment для Claude Code описывает запуск локального окружения через dev docker up: ожидание готовности сервисов и определение назначенных портов.
Apache-2.0 ★ 1 216 обновлён 2026-10-24
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install polar-skills@claude-settingsЧто делает start-environment
Правило описывает команды утилиты dev docker up, которая поднимает общую инфраструктуру и сервисы текущего воркспейса. По умолчанию контейнеры стартуют в фоновом режиме (-d). Инструкция учит агента использовать флаг --wait, чтобы дождаться ответа /healthz у API и проверки фронтенда, а не считать запуск завершённым сразу после создания контейнеров.
Внутри зафиксированы флаги сборки: -b для создания образов и --pull для обновления базовых слоёв, что спасает от застрявших кэшей после смены .python-version. Также расписан первый запуск с шагами uv sync, pnpm install, миграциями и заполнением базы сидами.
Порты сервисов зависят от номера инстанса, поэтому агент не должен угадывать адреса, а обязан проверять их вызовом dev docker ports или dev docker ports --json.
Какие задачи решает
- запустить локальные сервисы и общую инфраструктуру в Docker
- дождаться готовности API и веб-интерфейса через флаг
--wait - обновить базовые образы при смене версии Python
- определить назначенные порты контейнеров для текущего инстанса
Примеры запросов агенту
- Запусти локальное окружение и подожди, пока API начнёт отвечать
- Пересобери образы с обновлением базовых слоёв и запусти контейнеры в фоне
- Узнай порты запущенных сервисов для текущего инстанса
Как установить start-environment
1Через маркетплейс плагинов
/plugin marketplace add fcakyon/claude-codex-settings/plugin install polar-skills@claude-settings2Вручную: положить файлы
.claude/rules/start-environment.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/start-environment.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/start-environment.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/start-environment.mdВручную: положить файлы
.clinerules/start-environment.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о start-environment
Как установить start-environment в Claude Code?
Для установки через маркетплейс выполните /plugin marketplace add fcakyon/claude-codex-settings, затем /plugin install polar-skills@claude-settings. Также можно просто сохранить файл правила по пути .claude/rules/start-environment.md.
Что делает правило start-environment?
Оно задаёт для Claude Code и Codex стандарты работы с локальной средой на базе dev docker up. Агент понимает флаги запуска, фоновый и консольный режимы, а также шаги первой инициализации с миграциями.
Зачем использовать флаг --wait при старте?
На первом запуске приложение компилируется, выполняет uv sync, pnpm install и миграции. Флаг --wait блокирует выполнение, пока эндпоинт /healthz не ответит успехом, поэтому следующие команды не упадут на неготовом сервисе.
Исходный текст
start-environment.md · Apache-2.0
--- title: Starting the Local Environment category: Operations tags: docker, start, development --- # Starting the Local Environment `dev docker up` starts shared infra (if it isn't already running) plus this worktree's app stack. It **defaults to detached** (`-d` is on by default), so plain `dev docker up` returns once containers are created. ## Basic commands **Start in background (the default):** ```bash dev docker up -d ``` **Start and block until app services are healthy:** ```bash dev docker up -d --wait ``` `--wait` returns only once api answers `/healthz` and web responds. Prefer it in scripts and tooling so "up finished" means "actually serving" rather than "the container was created" — on first boot the app keeps compiling and migrating for a while after the container starts. **Start in the foreground and stream logs:** ```bash dev docker up --no-detach ``` Shared infra still starts detached; only the app stack is attached, so Ctrl+C stops the app stack. **Start specific services:** ```bash dev docker up -d api # api (+ shared infra) dev docker up -d web # web (+ shared infra) dev docker up -d api worker # api and worker ``` ## Options | Flag | Description | | ----------------- | ---------------------------------------------------- | | `-d` / `--detach` | Detached / background (default) | | `--no-detach` | Foreground; stream app logs until you stop it | | `--wait` | Block until app services are healthy (detached only) | | `-b` / `--build` | Rebuild images before starting | | `--pull` | Refresh base images before building (see below) | | `--monitoring` | Include Prometheus and Grafana in shared infra | | `-i N` | Target instance N explicitly (usually auto-detected) | ## Rebuilding with fresh bases ```bash dev docker up -b --pull -d ``` `-b` rebuilds the images, and `--pull` refreshes the base images first. Use `--pull` after a `.python-version` bump or when a rebuild alone still boots the old interpreter — a cached `FROM` layer can otherwise pin you to a stale base. See troubleshooting for the "No interpreter found for Python X" symptom. ## First-time startup First run is slow because it does real work inside the containers: 1. Build the api/web images 2. `uv sync` (api/worker) and `pnpm install` (web) — several minutes 3. Bootstrap the per-instance DB and MinIO buckets 4. Run migrations and load seed data 5. Services become healthy `dev docker up -d --wait` is the cleanest way to wait this out. ## Finding the URLs Ports are per-instance, so don't assume 3000/8000. Ask: ```bash dev docker ports # human-readable dev docker ports --json # for tooling ``` For instance 0 the app is at http://localhost:3000 (web) and http://localhost:8000 (api, docs at `/docs`). MinIO exposes ports 9000 (API) and 9001 (console) on localhost; db and redis have no host port — reach them with `dev docker exec <service> ...`.
© fcakyon · Apache-2.0 · fcakyon/claude-codex-settings