Руководство по AGENTS.md
Конфигурационный файл проекта для Codex — определяет правила поведения AI-ассистента, аналог CLAUDE.md для Claude Code
Руководство по AGENTS.md¶
AGENTS.md для Codex — то же, что CLAUDE.md для Claude Code: файл, который сообщает AI правила вашего проекта.
AGENTS.md vs CLAUDE.md¶
| Параметр | AGENTS.md | CLAUDE.md |
|---|---|---|
| Инструмент | Codex CLI | Claude Code |
| Формат | Markdown | Markdown |
| Уровни | Глобальный → Репозиторий → Директория | Глобальный → Проект |
| Переопределение | Нижний уровень переопределяет верхний | Аналогично |
| Сообщество | 60,000+ проектов | Экосистема Anthropic |
Оба файла могут сосуществовать в одном проекте.
Базовая структура¶
Создайте AGENTS.md в корне проекта:
# Правила проекта
## Стандарты кода
- TypeScript, запрещён тип any
- Имена функций в camelCase
- Обработка ошибок через try-catch
## Тестирование
- Jest для тестов
- Покрытие минимум 80%
- Запуск: `npm test`
## Структура
- src/ — исходный код
- tests/ — тесты
- docs/ — документация
3 уровня конфигурации¶
Уровень 1: Глобальный (~/.codex/AGENTS.md)¶
# Глобальные правила
- Комментарии на русском языке
- Коммиты на английском
- Никаких захардкоженных секретов
Уровень 2: Репозиторий (~/project/AGENTS.md)¶
# Проект: My App
## Стек: Next.js 15 + TypeScript + Tailwind CSS + PostgreSQL
## Правила: функциональные компоненты, Server Components по умолчанию
Уровень 3: Директория (~/project/src/api/AGENTS.md)¶
# Правила API
- Валидация входных данных через Zod
- Ответы об ошибках в формате RFC 7807
Приоритет: Директория > Репозиторий > Глобальный
Шаблоны¶
React фронтенд¶
# Frontend Rules
- React 19 + TypeScript 5.x + Vite + Tailwind CSS v4
- Только функциональные компоненты
- Props через interface (не type)
- Состояние: useState/useReducer (локальное), TanStack Query (серверное)
- Тесты: Vitest + Testing Library
Python бэкенд¶
# Backend Rules
- Python 3.12 + FastAPI + SQLAlchemy 2.0
- Обязательные type hints
- async/await предпочтительнее
- Тесты: pytest + httpx
Миграция с CLAUDE.md¶
80% содержимого CLAUDE.md можно скопировать напрямую:
| Раздел CLAUDE.md | В AGENTS.md |
|---|---|
| Commands | Копировать как есть |
| Code Style | Копировать как есть |
| Project Structure | Копировать как есть |
Инструкции для Claude (/model, /plan) |
Удалить или адаптировать |
Лучшие практики¶
- Конкретность: Не «пиши чистый код», а «следуй правилам ESLint»
- Примеры: Показывайте хорошие и плохие образцы
- Актуальность: Обновляйте при изменении стека
- Версионирование: Добавляйте в Git (не в .gitignore)
- Краткость: До 500 строк (длинные файлы расходуют контекст)
Следующие шаги¶
🚀
Начните с QCode — Claude Code & Codex
Один тариф для Claude Code и Codex, низкая задержка в Азии