Основы Codex

Запуск Codex

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

Запустите приложение Codex, добавьте проект из левого меню и введите свои требования в поле ввода в среднем столбце:

Вы можете настроить модель или загрузить файлы и т. д.:

Запуск Codex CLI

После установки и настройки учетной записи откройте терминал в каталоге проекта и введитеcodexчтобы запустить интерактивный интерфейс:

# 进入你的项目目录
cd ~/my-project

# 启动 Codex 交互界面
codex

# 带初始提示词直接启动
codex "帮我分析这个项目的结构"

# 启动时指定模型
codex --model gpt-5

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

Интерфейс Codex очень чистый. Курсор находится в поле ввода; просто введите свои требования напрямую.

Например, мы переходим в каталогcodex-example-testЗатем используемcodexЗапускаем командой:

cd codex-example-test
# 启动 Codex 交互界面
codex

Затем вы можете напрямую ввести свои требования в интерактивном интерфейсе, например, попросить его объяснить код в файле test.py. Результат выглядит следующим образом (эти записи также появятся в Codex App):

Три режима одобрения (Approval Mode)

Codex CLI предоставляет три режима работы с разными уровнями разрешений. Вы можете выбрать подходящий режим в зависимости от потребностей вашей задачи:

Mode Описание Применимые сценарии
ask(По умолчанию) Режим только для чтения: вы можете читать файлы и создавать планы, но перед выполнением любой операции требуется подтверждение. Исследование неизвестной кодовой базы, оценка рисков
auto-edit Авторедактирование: может читать и изменять файлы в текущем каталоге, но сетевые операции по-прежнему требуют подтверждения Ежедневная разработка кода, задачи по рефакторингу
full-auto Полностью автоматический режим: работает полностью автоматически в песочнице с отключённой сетью, подтверждение не требуется Пакетные задачи, автоматизация CI/CD
# 指定审批模式启动
codex --approval-mode ask        # 默认只读模式
codex --approval-mode auto-edit  # 自动编辑模式(缩写 -a auto-edit)
codex --approval-mode full-auto  # 完全自动模式

# 在交互界面中切换
/approvals  # 输入此命令切换审批模式

Ваш первый диалог

Пример 1: анализ структуры проекта

codex "分析这个项目的目录结构,告诉我主要文件的作用"

# Codex 会自动读取文件,输出类似:
# ✓ 读取 package.json
# ✓ 扫描 src/ 目录(23 个文件)
#   项目结构分析:
# - src/index.ts:应用入口,初始化 Express 服务器
# - src/routes/:API 路由定义(共 5 个端点)
# ...

Пример 2: исправление ошибок

codex "我的 login 函数有 bug,用户登录后 token 没有正确保存,帮我找出问题并修复"

# Codex 会:
# 1. 读取相关文件
# 2. 分析代码逻辑
# 3. 提出修改方案
# 4. 等待你确认后执行修改

Пример 3: генерация новых функций

codex "给我的 Express 应用添加一个用户注册接口,需要验证邮箱格式,密码至少8位,并把用户信息存入数据库"

# 传入图片上下文
codex -i design.png "按照这个设计图,实现对应的 React 组件"

Ввод изображений

Codex CLI поддерживает использование изображений в качестве входных данных контекста, что особенно полезно в следующих сценариях:

  • Анализ скриншота с ошибкой
  • Генерация frontend-кода по макетам UI-дизайна.
  • Интерпретация схемы архитектуры и реализация функций в соответствии с ней
# 方法一:命令行传入图片路径
codex -i screenshot.png "解释这个报错信息,并告诉我如何修复"

# 方法二:传入多张图片
codex --image img1.png,img2.jpg "对比这两个界面的区别,实现图一的设计"

# 方法三:在交互界面中粘贴图片(macOS)
# 复制图片后,在 Codex 输入框中直接按 Cmd+V 粘贴

# 方法四:Shift + 拖拽图片到终端窗口
Другие расширения