Конфигурация

Два места, и только два

	где	что
Локально	`~/.bee/config.json` (`0600`)	одна строка подключения к Mongo. Больше ничего.
Общее	ваше хранилище MongoDB	ключи провайдеров, эндпоинты, правила, память, soul-ы

Поставляемый бинарник не содержит ни одного секрета. Ротация происходит в одном месте, а новой машине для полной настройки нужна одна строка.

bee config path      # где локальный файл
bee config show      # локальное + удалённое, секреты замаскированы
bee config get <key> # сырое значение в stdout, можно направить в конвейер
bee config set <key> <value> [--secret]

Ключи

Провайдер модели — для `bee ask`

bee config set ask.provider deepseek        # deepseek | openai | anthropic
bee config set deepseek.apiKey sk-... --secret
bee config set deepseek.model deepseek-chat

Эмбеддинги — для `remember search --semantic`

bee config set embedding.provider local     # local (по умолчанию) | gemini
bee config set embedding.model <model-id>
bee config set gemini.apiKey ... --secret   # только для бэкенда gemini

Один бэкенд на хранилище — смена меняет размерность вектора, и старые факты перестают совпадать с новыми.

Skill bridge — для `bee skill`

bee config set skill.endpoint https://skill-bridge.example.com/mcp

Переменные окружения

переменная	эффект
`BEE_HOME`	Заменяет для bee домашний каталог. bee всё равно добавляет `.bee`, поэтому `BEE_HOME=/x` → `/x/.bee/config.json`.
`BEE_SESSION`	Задаёт имя текущей сессии для `handover --session`, если среда неизвестна bee.
`BEE_EMBEDDING_MODEL`	Переопределяет идентификатор локальной модели эмбеддингов.

bee также читает идентификаторы сессий, которые среда уже экспортирует — CLAUDE_CODE_SESSION_ID, CODEX_SESSION_ID — поэтому для Claude Code или Codex дополнительная настройка не нужна.

Идентичность проекта

Правила и записи памяти привязаны к проекту, который определяется по git remote. Та же копия на другой машине — тот же проект; два несвязанных каталога — нет. --global (правила) и --all-projects (поиск) намеренно пересекают эту границу.

Связанные рабочие деревья git учтены: .git там — это файл, указывающий на основной репозиторий, и личность читается оттуда, где git её действительно хранит.