# vercel-env-sync

Синхронизирует переменные окружения между локальными файлами .env и проектом на Vercel через Vercel CLI. Помогает выгружать, пушить и проверять секреты.

- команда · `type=command` · Claude Code · 406 установок
- Автор: davila7
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/commands/nextjs-vercel/vercel-env-sync.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/commands/vercel-env-sync

## Что делает

Команда автоматизирует перенос конфигураций между локальными файлами (`.env.local`, `.env.development`, `.env.staging`, `.env.production`) и облаком Vercel. Поддерживаются четыре основных аргумента: `--pull` для скачивания настроек, `--push` для отправки данных, `--validate` для поиска ошибок и `--backup` для сохранения резервных копий.

Перед выгрузкой скрипт делает резервную копию `.env.local` с временной меткой в имени. При отправке переменных локальный staging направляется в окружение preview, а строки очищаются от лишних кавычек перед передачей в `vercel env add --force`. Валидация выявляет отсутствующие обязательные ключи вроде `DATABASE_URL` или `NEXTAUTH_SECRET` и предупреждает о небезопасных значениях по умолчанию вроде `change-me`.

Без установленного Vercel CLI и привязанного к Vercel проекта команда не сможет выполнить ни одну операцию.

## Установка

### Claude Code (родная платформа)

1. **Через claude-code-templates**
```bash
npx claude-code-templates@latest --command nextjs-vercel/vercel-env-sync
```

2. **Вручную: положить файлы**
- Файл: `.claude/commands/vercel-env-sync.md` — Вызов — /vercel-env-sync. Для всех проектов — ~/.claude/commands/

### Codex

**Вручную: положить файлы**
- Файл: `~/.codex/prompts/vercel-env-sync.md` — Вызов — /prompts:vercel-env-sync. В Codex этот формат помечен устаревшим, замена — скиллы

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/prompts/vercel-env-sync.prompt.md`

### Gemini CLI

**Вручную: положить файлы**
- Файл: `.gemini/commands/vercel-env-sync.toml` — Gemini хранит команды в TOML: текст запроса — в поле prompt

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/commands/nextjs-vercel/vercel-env-sync.md

## Когда брать
- скачать переменные окружения из Vercel в локальный `.env.local`
- отправить локальные конфиги в окружения production, preview и development на Vercel
- создать резервную копию файлов окружения перед перезаписью
- проверить переменные на плейсхолдеры и формат строки подключения к базе

## Примеры запросов агенту
- Выгрузи переменные из проекта Vercel с помощью команды `/vercel-env-sync --pull`
- Проверь корректность секретов и формата ключей через `/vercel-env-sync --validate`
- Отправь локальные настройки на Vercel вызовом `/vercel-env-sync --push`

## Похожие
- [status](https://affpapa.org/nevibecode/commands/status.md) — команда · 348 установок
- [maker-setup](https://affpapa.org/nevibecode/commands/maker-setup.md) — команда · ★ 44770
- [modernize-preflight](https://affpapa.org/nevibecode/commands/modernize-preflight.md) — команда · ★ 44770

Из того же набора: [davila7/claude-code-templates](https://affpapa.org/nevibecode/by/davila7/claude-code-templates.md) — 495 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md