Конфигурация и кастомизация Codex

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

По умолчанию приложение Codex использует язык ваших системных настроек. Если это не так, вы можете использовать Настройки:

Выберите «Общие», чтобы изменить нужный вам язык в параметрах «Общие»:

Аналогично, чтобы переключиться с китайского на английский, просто установите флажок English:

Настройки приложения Codex

Как открыть: Нажмите Настройки в меню приложения или нажмитеCmd + ,：

Интерфейс настроек показан ниже:

Общие:Способ открытия файлов конфигурации и объём отображаемого вывода команд в ветке диалога. Вы также можете настроить многострочные запросы с подтверждением по Cmd+Enter и предотвратить переход системы в спящий режим во время выполнения задачи.

Уведомления:Настройте момент срабатывания уведомлений о завершении задачи и то, запрашивает ли приложение разрешение на системные уведомления по своей инициативе.

Конфигурация агента (Agent Configuration):Агент Codex в приложении использует ту же конфигурацию, что и расширения для IDE и CLI. Общие параметры можно настроить прямо в приложении, а для продвинутых параметров требуется редактирование файла config.toml (описано далее).

Внешний вид:Поддерживается выбор базовой темы, настройка акцентного цвета, цвета фона и цвета переднего плана, а также изменение шрифта интерфейса и шрифта кода. Вы можете делиться пользовательскими темами с другими.

Питомцы Codex (Codex Pets):Необязательные динамические персонажи-компаньоны, путь:Settings > Appearance > PetsВы можете выбрать встроенных питомцев или загрузить пользовательских питомцев из локального домашнего каталога Codex.

Способ выполнения:

Введите в поле ввода/pet
используйтеSettings > AppearanceвWake PetилиTuck Away Pet
нажмитеCmd+K / Ctrl+Kзатем выполните команду с тем же именем

Плавающее окно питомца может постоянно отображать текущий рабочий статус Codex (Выполняется / Ожидание ввода / Ожидает проверки) при использовании других приложений и включает краткую подсказку о ходе выполнения.

Пользовательские питомцы (процесс создания):

$skill-installer hatch-pet

После установки выберите в меню командForce Reload Skills, затем выполните:

$hatch-pet create a new pet inspired by my recent projects

Git: унифицируйте соглашения об именовании веток, настройте, включать ли принудительный push, и задайте текст подсказки, используемый, когда Codex автоматически генерирует сообщения коммитов и описания PR.

Среда:Вы можете просматривать каталоги проектов и добавлять проекты.

Рабочее дерево:Используйте Git worktree, чтобы Codex мог параллельно выполнять несколько задач в рамках одного проекта.

Использование браузера:Установите или включите встроенный плагин Browser, чтобы управлять белыми и черными списками веб-сайтов. По умолчанию Codex спрашивает пользователя перед использованием любого веб-сайта; после удаления веб-сайта из черного списка Codex снова начнет запрашивать разрешение. Подробности см. в документации по встроенному браузеру.

Использование компьютера:Только macOS. Вы можете просматривать разрешения доступа для настольных приложений и связанные настройки. Чтобы отозвать разрешения системного уровня, перейдите в раздел «Конфиденциальность и безопасность» macOS и измените разрешения для «Записи экрана» или «Универсального доступа».

Архивные чаты:
Показывает все архивные беседы, отображая дату и контекст проекта. Нажмите «Разархивировать», чтобы восстановить конкретную беседу.

Расположение файла конфигурации

Файлы конфигурации Codex управляются по уровням:

Уровень	Путь	Область действия
Пользовательский уровень	`~/.codex/config.toml`	Глобальная конфигурация по умолчанию
Уровень проекта	`.codex/config.toml`	Конфигурация для конкретного проекта
Управляемый уровень	Корпоративное распространение	Единая корпоративная конфигурация

Правила слияния конфигурации

Конфигурация объединяется по приоритету:

Управляемая конфигурация имеет наивысший приоритет
Конфигурация проекта переопределяет пользовательскую конфигурацию
Пользовательская конфигурация служит значением по умолчанию

Базовые элементы конфигурации

Базовая конфигурация

AGENTS.md

AGENTS.md — это файл инструкций агента уровня проекта, который определяет спецификации поведения Codex в этом проекте.

Порядок обнаружения файлов

Чтение глобального~/.codex/AGENTS.md
Искать в каждом каталоге вниз от корня проекта
Правила в более близких каталогах переопределяют правила в более далёких

Пример AGENTS.md

AGENTS.md проекта

# Стандарты разработки проекта

## Технологический стек
- Фронтенд: React + TypeScript
- Бэкенд: Python FastAPI
- База данных: PostgreSQL

## Стандарты кода
- Используйте отступ в 4 пробела
- Максимум 100 символов в строке
- Все функции должны иметь аннотации типов

## Требования к тестированию
- Новые функции должны включать тесты
- Запускайте тесты с pytest

## Git-коммиты
- Используйте формат Conventional Commits
- Сообщения коммитов описывают «почему»

## Рекомендации по ревью
- Не логируйте PII
- Проверьте промежуточное ПО аутентификации
- Проверьте на SQL-инъекции

Переопределение в подкаталоге

Вы можете поместить AGENTS.override.md в подкаталог:

Правила для подкаталогов

# src/auth/ Правила модуля

## Требования безопасности
- Все пароли должны быть хешированы с использованием bcrypt
- Добавить журналы аудита
- Проверьте на SQL-инъекции

AGENTS.md ограничен 32 KiB; всё, что превышает этот размер, будет усечено.

Навыки

Навыки — это переиспользуемые пользовательские возможности, которые инкапсулируют логику типовых задач.

Расположение каталога навыков

Расположение	Путь	Назначение
REPO	`.agents/skills/`	Навыки уровня проекта
USER	`~/.agents/skills/`	Навыки уровня пользователя
ADMIN	`/etc/codex/skills/`	Навыки уровня системы
СИСТЕМА	Встроенный	Официальные предустановленные навыки

Структура навыков

skill-name/
├── SKILL.md       # 技能定义（必需）
├── scripts/       # 可选脚本
├── references/    # 可选参考文档
└── assets/        # 可选资源

Создание навыков

Определение навыка

---
name: code-review-standard
description: Выполнить проверку кода по стандартам команды
---

# Стандарты проверки кода

## Пункты проверки
1. Читаемость кода
2. Потенциальные ошибки
3. Уязвимости безопасности
4. Проблемы производительности
5. Покрытие тестами

## Формат вывода
Список проблем (по серьёзности)
Предложения по улучшению
Оценка (1-10)

Активация навыков

Методы активации	Примеры
Явный вызов	`$skill-name`или`/skill-name`
Неявное сопоставление	Описание задачи соответствует описанию навыка

Субагенты

Субагенты позволяют разбивать сложные задачи и обрабатывать их параллельно несколькими агентами.

Встроенные типы агентов

Агент	Функция
default	Агент общего назначения
worker	Ориентирован на выполнение, подходит для реализации и исправлений
explorer	Ориентирован на исследование, подходит для анализа кодовой базы

Настройка субагентов

Конфигурация субагента

# ~/.codex/config.toml

[agents]
# Максимальное количество параллельных потоков
max_threads = 6

# Максимальная глубина вложенности
max_depth = 1

# Тайм-аут одной задачи
job_max_runtime_seconds = 1800

Пользовательские агенты

# ~/.codex/agents/reviewer.toml

name = "reviewer"
description = "Сфокусирован на проверке кода и вопросах качества"
nickname_candidates = ["Рецензент", "Бот качества"]

developer_instructions = """
Сфокусируйтесь на проверке качества кода:
- Проверьте единообразие стиля кода
- Найдите потенциальные ошибки
- Оцените покрытие тестами
"""

Правила

Правила определяют политики выполнения команд, контролируя, какие команды могут выполняться автоматически.

Файл правил

Правила используют язык Starlark (похожий на Python):

Определение правила

# ~/.codex/rules/default.rules

# Разрешить команды Git
prefix_rule(
pattern = ["git"],
decision = "allow",
justification = "Команды Git безопасны"
)

# Запретить rm -rf /
prefix_rule(
pattern = ["rm", "-rf", "/"],
decision = "forbidden",
justification = "Предотвратить повреждение системы"
)

# Спросить о командах npm
prefix_rule(
pattern = ["npm"],
decision = "prompt",
justification = "npm может изменять зависимости"
)

Типы решений

Принятие решений	Поведение
`allow`	Автоодобрение
`prompt`	Запросить подтверждение
`forbidden`	Запретить выполнение

Хуки

Хуки выполняют пользовательские скрипты при определённых событиях.

Включение хуков

[features]
codex_hooks = true

События хуков

Event	Момент срабатывания
`SessionStart`	Начало сессии
`PreToolUse`	Перед вызовом инструмента
`PostToolUse`	После вызова инструмента

Настройка хука

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

{
"hooks": [
{
"event": "PostToolUse",
"matcher": {
"toolName": "Bash"
},
"hooks": [
{
"type": "command",
"command": "echo 'Команда выполнена'",
"timeout": 10
}
]
}
]
}

ЧАВО

В: Как изменения конфигурации вступают в силу?

После изменения конфигурации необходимо перезапустить Codex, чтобы изменения вступили в силу.

В: Где следует размещать AGENTS.md?

В корневом каталоге проекта или в подкаталогах, для которых нужны особые правила.

В: В чём разница между Skills и Rules?

Skills определяют логику выполнения задач, Rules управляют разрешениями команд.

В: Как просмотреть текущую конфигурацию?

Используйте/statusкоманда для просмотра текущей конфигурации сессии.

Другие расширения

Codex Cli

Конфигурация и кастомизация Codex

Настройки приложения Codex

Расположение файла конфигурации

Правила слияния конфигурации

Базовые элементы конфигурации

Базовая конфигурация

AGENTS.md

Порядок обнаружения файлов

Пример AGENTS.md

AGENTS.md проекта

Переопределение в подкаталоге

Правила для подкаталогов

Навыки

Расположение каталога навыков

Структура навыков

Создание навыков

Определение навыка

Активация навыков

Субагенты

Встроенные типы агентов

Настройка субагентов

Конфигурация субагента

Пользовательские агенты

Пользовательские агенты

Правила

Файл правил

Определение правила

Типы решений

Хуки

Включение хуков

Включение хуков

События хуков

Настройка хука

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

ЧАВО

В: Как изменения конфигурации вступают в силу?

В: Где следует размещать AGENTS.md?

В: В чём разница между Skills и Rules?

В: Как просмотреть текущую конфигурацию?