Конфигурация Codex CLI
Codex CLI можно настроить с помощью файлов конфигурации. В этом разделе описывается структура файлов конфигурации, различные параметры конфигурации и способы их настройки в соответствии с вашими потребностями.
Расположение файла конфигурации
Файл конфигурации Codex находится в домашнем каталоге пользователя по пути~/.codex/config.toml：
~/.codex/config.toml
Если файл не существует, его нужно создать вручную. Codex создаст файл конфигурации по умолчанию при первом запуске.
После изменения конфигурации необходимо перезапустить Codex, чтобы изменения вступили в силу.
Структура файла конфигурации
Полный файл конфигурации может включать следующие разделы:
Пример полной конфигурации
# Основные настройки
[model]
default = "o4-mini" # Модель по умолчанию для использования
# Настройки TUI
[tui]
alternate_screen = "auto" # Режим альтернативного экрана: auto/always/never
# Конфигурация навыков
[skills]
enabled = true
# Переключатели функций
[features]
js_repl = false # Включать ли JavaScript REPL
# Конфигурация сервера MCP
[mcp_servers]
# Настройки уведомлений
[notify]
enabled = false
Конфигурация моделей
Codex поддерживает несколько моделей; вы можете выбрать в зависимости от требований задачи:
| Элемент конфигурации | Type | Описание |
|---|---|---|
model.default | string | Модель, используемая по умолчанию |
model.reasoning_effort | string | Уровень рассуждения: low/medium/high |
Доступные модели
Модели, доступные в Codex CLI, включают:
o4-mini- Быстрая и эффективная, подходит для простых задачo4-mini-high- Версия o4-mini с высоким уровнем рассужденийo3- Мощные возможности рассужденияo3-pro- Профессиональная версия o3
Разные модели имеют разную скорость и цену; выбор подходящей модели позволяет оптимизировать пользовательский опыт и затраты.
Конфигурация TUI
Соответствующие настройки для пользовательского интерфейса терминала:
| Элемент конфигурации | Type | Описание | Значение по умолчанию |
|---|---|---|---|
tui.alternate_screen | string | Режим альтернативного экрана: auto/always/never | auto |
tui.width | число | Ширина терминала | 0 (автоматически) |
tui.height | число | Высота терминала | 0 (автоматически) |
Пояснение режима альтернативного экрана
auto- Автоопределение, автоматически отключается в терминальных мультиплексорах, таких как Zellijalways- Всегда использовать альтернативный экран (стандартный режим)never- Никогда не использовать альтернативный экран (сохранять историю прокрутки)
Переопределение во время выполнения
Вы можете переопределить эти параметры во время выполнения с помощью аргументов командной строки:
Конфигурация переопределения из командной строки
codex --no-alt-screen
Конфигурация навыков
Навыки — это механизм расширения Codex, позволяющий настраивать рабочие процессы:
| Элемент конфигурации | Type | Описание |
|---|---|---|
skills.enabled | логическое значение | Включать ли систему навыков |
skills.directory | string | Каталог файлов навыков |
Пользовательский каталог навыков
Настроить каталог навыков
enabled = true
directory = "~/my-codex-skills"
Конфигурация сервера MCP
Серверы MCP (Model Context Protocol) позволяют Codex интегрироваться с внешними инструментами и сервисами:
Настроить сервер MCP
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "./docs"]
# Конфигурация разрешений для инструментов
[mcp_servers.docs.tools.search]
approval_mode = "approve"
Разрешения для инструментов MCP
Вы можете настроить разрешения отдельно для инструментов каждого сервера MCP:
approve- Автоматическое одобрение без запросаdeny- Автоматическое отклонениеask- Спрашивать перед каждым выполнением (по умолчанию)
Будьте осторожны при настройке серверов MCP; включайте только те инструменты, которым доверяете.
Переключатели функций
Включайте или отключайте определённые функции Codex:
| Элемент конфигурации | Type | Описание |
|---|---|---|
features.js_repl | логическое значение | Включить JavaScript REPL |
features.js_repl_tools_only | логическое значение | Ограничить только инструментом js_repl |
Конфигурация JavaScript REPL
Включить JavaScript REPL
js_repl = true
Вы также можете указать путь к Node.js:
Укажите путь к Node.js
Конфигурация уведомлений
Codex может отправлять уведомления по завершении задач:
| Элемент конфигурации | Type | Описание |
|---|---|---|
notify.enabled | логическое значение | Включить уведомления |
Настройка хуков уведомлений
Вы можете настроить пользовательские скрипты уведомлений через переменные среды:
CODEX_NOTIFY_HOOK=/path/to/your/notify-script.sh
База данных состояния SQLite
Codex использует SQLite для хранения внутреннего состояния:
| Переменная окружения | Описание | Значение по умолчанию |
|---|---|---|
CODEX_SQLITE_HOME | Каталог базы данных SQLite | То же, что и CODEX_HOME |
Настройка каталога SQLite
codex
Настройка логирования
Codex использует env_logger из Rust; вы можете настроить уровень логирования:
Настройка вывода логов
tail -f ~/.codex/log/codex-tui.log
# Установить уровень логирования
RUST_LOG=codex_core=info,codex_tui=info,codex_rmcp_client=info codex
| Уровень логирования | Описание |
|---|---|
error | Показывать только ошибки |
warn | Показывать предупреждения и ошибки |
info | Показывать общую информацию, предупреждения и ошибки |
debug | Показывать отладочную информацию |
trace | Показывать подробную информацию трассировки |
По умолчанию уровень логирования в режиме TUI — info, а уровень по умолчанию в неинтерактивном режиме (exec) — error.
Конфигурация Plan Mode
Настройте поведение Codex в Plan Mode:
Настроить Plan Mode
# Необязательные значения: low/medium/high/none
plan_mode_reasoning_effort = "medium"
Примеры типовой конфигурации
Базовая конфигурация
Минимальная конфигурация
# Codex уже предоставляет разумные значения по умолчанию
Высокопроизводительная конфигурация
Конфигурация оптимизации производительности
default = "o4-mini"
[tui]
alternate_screen = "always"
[features]
js_repl = true
Конфигурация разработчика
Конфигурация разработчика
default = "o4-mini"
reasoning_effort = "high"
[tui]
alternate_screen = "never"
[skills]
enabled = true
directory = "~/codex-skills"