К основному содержанию
правило CX Codex

start-environment — правило для Claude Code: что делает и установка

Правило start-environment для Claude Code описывает запуск локального окружения через dev docker up: ожидание готовности сервисов и определение назначенных портов.

Apache-2.0 ★ 1 216 обновлён 2026-10-24

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install polar-skills@claude-settings
Открыть на GitHub

Что делает 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-settings

2Вручную: положить файлы

.claude/rules/start-environment.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: 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

Похожие правила IDE

Все правила IDE по теме «DevOps и инфраструктура» →
capture-environment pedrohcgs Скилл capture-environment собирает версии языков, пакетов и сиды в lockfile, чтобы расчёт воспроизводился на чужой машине. Нужен перед выкладкой replication package. CX Codex +1 ★ 1 729звёзд репо setup-development-environment davila7 Команда setup-development-environment для Claude Code разворачивает на новой машине окружение разработки: рантаймы, инструменты, сборку, линтеры и конфиги. CX Codex +1 651установок test-environment-management proffesor-for-testing Скилл test-environment-management для Claude Code помогает настраивать тестовую инфраструктуру и сближать её с production. Он включается при подготовке окружений, поиске различий между средами и сокращении расходов на тесты. CX Codex +1 117установок magento-local-environment-specialist maxnorm Скилл magento-local-environment-specialist ставит и настраивает локальное окружение Magento 2: Docker, PHP, база, кеш, Xdebug. Разбирает и поломки при локальном запуске. CX Codex +1 164установок devcontainer-setup trailofbits Скилл devcontainer-setup для Claude Code создаёт изолированный devcontainer с предустановленным Claude Code, инструментами для Python, Node, Rust или Go и постоянными томами. Контейнер изолирует запуск агента в песочнице проекта. CX Codex +1 5 800установок environment-setup akillness Скилл environment-setup разбирает конфигурацию приложения по полочкам: какие переменные держать в .env, что коммитить, как проверять обязательные значения и где граница с секретами. CX Codex +1 354установок

Из того же набора113

Весь набор →
list-performance-item-types Правило list-performance-item-types для Claude Code задаёт типы элементов в списках с разной разметкой. Оно подключается при работе с такими списками и настраивает раздельное переиспользование компонентов. CX Codex +1 ★ 1 216звёзд репо manage-instances Правило manage-instances для параллельного запуска нескольких изолированных стеков приложения в отдельных worktree, каждый со своей БД, Redis и портами. CX Codex +1 ★ 1 216звёзд репо test-audit Скилл test-audit проверяет новые и изменённые тесты, а также помогает находить дубли и низкоценные проверки. Пригодится перед добавлением тестов и при аудите тестового набора. CX Codex +1 ★ 1 216звёзд репо webmcp-gen Скилл webmcp-gen собирает рабочий процесс сайта в WebMCP-инструмент и проверяет, что он ведёт себя так же, как существующий интерфейс. CX Codex +1 ★ 1 216звёзд репо service-architecture Правило service-architecture описывает архитектуру Docker-сервисов Polar: общую инфраструктуру и отдельный стек приложения для каждого worktree. Помогает агенту учитывать связи между контейнерами и их адреса. CX Codex +1 ★ 1 216звёзд репо openship-config Скилл openship-config, который готовит репозиторий к деплою на OpenShip: осматривает проект и создаёт openship.json с минимально необходимыми настройками. Пригодится перед первым запуском конфигурации или когда валидатор ругается. CX Codex +1 ★ 1 216звёзд репо app-auth Скилл app-auth для Claude Code проектирует и настраивает аутентификацию. Включается при запросах на вход через соцсети, восстановление пароля, переключение аккаунтов и сохранение профиля. CX Codex +1 ★ 1 216звёзд репо gcloud-usage Скилл gcloud-usage помогает разбирать логи, метрики и трассировки Google Cloud, а также настраивать фильтры и алерты. Пригодится при отладке проблем в GCP. CX Codex +1 ★ 1 216звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой