Правила

Установите пользовательские инструкции для opencode.

Вы можете предоставить opencode пользовательские инструкции, создав файл AGENTS.md. Это похоже на rules в Cursor. Он содержит инструкции, которые будут включены в контекст LLM для настройки его поведения под ваш конкретный проект.

Инициализация

Чтобы создать новый файл AGENTS.md, вы можете выполнить команду /init в opencode.

Совет: Вам следует зафиксировать файл AGENTS.md вашего проекта в Git.

Это просканирует ваш проект и всё его содержимое, чтобы понять, о чём проект, и сгенерирует файл AGENTS.md. Это помогает opencode лучше ориентироваться в проекте.

Если у вас уже есть файл AGENTS.md, будет предпринята попытка дополнить его.

Пример

Вы также можете просто создать этот файл вручную. Вот пример того, что можно поместить в файл AGENTS.md.

Мы добавляем здесь инструкции, специфичные для проекта, и они будут доступны вашей команде.

Типы

opencode также поддерживает чтение файла AGENTS.md из нескольких мест. И это служит разным целям.

Проект

Поместите AGENTS.md в корень вашего проекта для правил, специфичных для проекта. Они применяются только когда вы работаете в этой директории или её поддиректориях.

Глобальный

Вы также можете иметь глобальные правила в файле ~/.config/opencode/AGENTS.md. Они применяются ко всем сессиям opencode.

Поскольку это не фиксируется в Git и не передаётся вашей команде, мы рекомендуем использовать это для указания любых личных правил, которым должен следовать LLM.

Совместимость с Claude Code

Для пользователей, мигрирующих с Claude Code, OpenCode поддерживает соглашения о файлах Claude Code в качестве запасных вариантов:

• Правила проекта: CLAUDE.md в директории вашего проекта (используется, если нет AGENTS.md)
• Глобальные правила: ~/.claude/CLAUDE.md (используется, если нет ~/.config/opencode/AGENTS.md)
• Skills: ~/.claude/skills/ — см. Agent Skills для подробностей

Чтобы отключить совместимость с Claude Code, установите одну из этих переменных окружения:

Приоритет

Когда opencode запускается, он ищет файлы правил в следующем порядке:

• Локальные файлы путём обхода вверх от текущей директории (AGENTS.md, CLAUDE.md)
• Глобальный файл в ~/.config/opencode/AGENTS.md
• Файл Claude Code в ~/.claude/CLAUDE.md (если не отключён)

Первый найденный файл побеждает в каждой категории. Например, если у вас есть и AGENTS.md, и CLAUDE.md, используется только AGENTS.md. Аналогично, ~/.config/opencode/AGENTS.md имеет приоритет над ~/.claude/CLAUDE.md.

Пользовательские инструкции

Вы можете указать файлы пользовательских инструкций в вашем opencode.json или глобальном ~/.config/opencode/opencode.json. Это позволяет вам и вашей команде повторно использовать существующие правила вместо их дублирования в AGENTS.md.

Пример:

Вы также можете использовать удалённые URL для загрузки инструкций из интернета.

Удалённые инструкции загружаются с тайм-аутом 5 секунд.

Все файлы инструкций объединяются с вашими файлами AGENTS.md.

Ссылки на внешние файлы

Хотя opencode не анализирует автоматически ссылки на файлы в AGENTS.md, вы можете достичь аналогичной функциональности двумя способами:

Использование opencode.json

Рекомендуемый подход — использовать поле instructions в opencode.json:

Ручные инструкции в AGENTS.md

Вы можете научить opencode читать внешние файлы, предоставив явные инструкции в вашем AGENTS.md. Вот практический пример:

Этот подход позволяет вам:

• Создавать модульные, многоразовые файлы правил
• Делиться правилами между проектами через символические ссылки или git-подмодули
• Сохранять AGENTS.md кратким, ссылаясь на подробные руководства
• Гарантировать, что opencode загружает файлы только когда это необходимо для конкретной задачи

Совет: Для монорепозиториев или проектов с общими стандартами использование opencode.json с glob-шаблонами (например, packages/*/AGENTS.md) более удобно в поддержке, чем ручные инструкции.