AI-агенты с нуля: Claude, Codex, Skills, плагины, MCP и управление проектами

Введение

Большинство людей начинает пользоваться AI неправильно: открывает чат, пишет «создай мне приложение», получает несколько файлов сомнительной жизнеспособности и объявляет себя вайбкодером.

AI-агент работает иначе.

Обычный AI-чат в основном отвечает на вопросы и генерирует текст.

AI-агент может:

• читать файлы проекта;
• искать нужный код;
• изменять несколько файлов;
• запускать команды в терминале;
• устанавливать зависимости;
• запускать тесты;
• проверять результат;
• работать с Git;
• создавать коммиты и Pull Request;
• обращаться к внешним сервисам;
• продолжать работу самостоятельно, пока задача не будет выполнена.

Claude Code и Codex умеют читать кодовую базу, редактировать файлы и запускать инструменты разработки. Codex доступен через приложение, терминал, IDE и облачную среду, а Claude Code работает через терминал, IDE, приложение и браузер.

1. Чем отличаются Chat, Cowork и Code

Chat

Chat нужен для общения с моделью.

Используйте его, когда необходимо:

• придумать идею;
• разобраться в технологии;
• составить план проекта;
• написать текст;
• проанализировать документ;
• обсудить архитектуру;
• попросить объяснить ошибку;
• подготовить техническое задание.

Chat может работать с файлами и подключёнными сервисами, но его лучше воспринимать как консультанта, а не как разработчика, которому уже выдали терминал и ключи от сервера.

Пример задачи для Chat

Я хочу создать сервис, который превращает скриншоты в структурированные заметки. Помоги определить главную функцию, целевую аудиторию, минимальный MVP и подходящий стек.

На этом этапе агент ещё ничего не создаёт. Он помогает понять, что именно нужно создавать.

Cowork

Claude Cowork предназначен для выполнения обычной компьютерной работы, не обязательно связанной с программированием.

Cowork может:

• работать с документами;
• собирать исследования;
• создавать таблицы и презентации;
• работать с файлами;
• использовать браузер;
• обращаться к подключённым сервисам;
• разбивать большую задачу на несколько параллельных частей;
• выполнять запланированные задачи.

Anthropic описывает Cowork как режим, которому можно передать желаемый результат, после чего Claude самостоятельно организует выполнение. Cowork работает на web, desktop и mobile и доступен пользователям платных планов.

Когда использовать Cowork

• Собрать отчёт по конкурентам.
• Найти информацию в Google Drive и оформить документ.
• Разобрать папку с файлами.
• Подготовить таблицу.
• Найти письма и составить ответы.
• Создать презентацию.
• Выполнить многошаговую офисную задачу.

Пример задачи для Cowork

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

Code

Claude Code или Codex используются для работы с программными проектами.

Агент получает доступ к папке и может:

• изучать структуру проекта;
• читать код;
• создавать новые файлы;
• исправлять ошибки;
• запускать приложение;
• устанавливать библиотеки;
• запускать линтер и тесты;
• работать с базой данных;
• создавать Git-коммиты;
• готовить Pull Request;
• проверять интерфейс через браузер.

Когда использовать Code

• Создание сайта или приложения.
• Исправление ошибки.
• Добавление функции.
• Рефакторинг.
• Работа с API.
• Настройка Docker.
• Настройка базы данных.
• Развёртывание проекта.
• Проверка безопасности.
• Code review.

Главное различие

Режим

Основная задача

Chat

Обсуждать и думать

Cowork

Выполнять обычную компьютерную работу

Code

Управлять программным проектом

2. Что выбрать: Claude Code или Codex

Оба агента способны полноценно работать с кодом. Выбирать стоит не по бесконечным рейтингам из соцсетей, а по конкретному рабочему процессу.

Claude Code стоит выбрать, если:

• вам нравится Claude;
• вы хотите работать через терминал;
• вам важны CLAUDE.md, плагины, skills, hooks и subagents;
• вы используете VS Code или Cursor;
• вам нужен агент для длинной последовательной работы;
• вы хотите гибко настраивать правила и разрешения.

Codex стоит выбрать, если:

• у вас уже есть подписка ChatGPT;
• нужен удобный графический интерфейс;
• вы хотите запускать несколько агентов параллельно;
• хотите использовать Git Worktrees;
• хотите переключаться между Local, Worktree и Cloud;
• хотите работать с проектом через приложение, IDE, терминал и телефон;
• вам нужны встроенные плагины, браузер и Computer Use.

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

Практический совет

Новичку не нужно сразу использовать два агента.

Выберите один:

• Codex, если хочется более понятного приложения.
• Claude Code, если хочется глубже разобраться в терминале и инженерном процессе.

Когда освоите Git, ветки, тесты и структуру проекта, можно будет переключаться между моделями. До этого два агента лишь дадут вам в два раза больше способов случайно сломать проект.

3. Как установить Claude

Вариант 1. Claude Desktop

1. Откройте официальную страницу загрузки Claude.
2. Выберите версию для macOS или Windows.
3. Установите приложение.
4. Войдите в аккаунт Claude.
5. Выберите Chat, Cowork или Code в зависимости от задачи.

Официальное приложение Claude Desktop доступно для macOS и Windows. Claude Code также можно использовать через графическое приложение на macOS, Windows и Linux.

Вариант 2. Claude Code через терминал

Установка на macOS, Linux или WSL

Откройте Terminal и выполните:

curl -fsSL https://claude.ai/install.sh | bash

После установки запустите:

claude

Браузер откроет страницу авторизации. Войдите через аккаунт Claude.

Установка через Homebrew на macOS

brew install --cask claude-code

Обновление:

brew upgrade claude-code

Установка на Windows через PowerShell

irm https://claude.ai/install.ps1 | iex

Или через WinGet:

winget install Anthropic.ClaudeCode

Нативная установка Claude Code обновляется автоматически. Homebrew и WinGet необходимо обновлять вручную.

Вариант 3. Claude Code в VS Code или Cursor

1. Откройте раздел Extensions.
2. Найдите официальное расширение Claude Code.
3. Установите его.
4. Откройте панель Claude.
5. Авторизуйтесь через аккаунт Anthropic.
6. Откройте папку проекта.

Расширение позволяет:

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

Расширение содержит собственную версию Claude Code, поэтому для работы через графическую панель отдельно устанавливать CLI необязательно. CLI потребуется, если вы хотите запускать команду claude непосредственно в терминале.

4. Как установить Codex

Вариант 1. Приложение Codex

1. Скачайте официальное приложение Codex или ChatGPT Desktop.
2. Запустите его.
3. Нажмите Continue with ChatGPT.
4. Выберите папку или Git-репозиторий.
5. Создайте первую задачу.

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

Что выбрать при открытии проекта

Codex предлагает несколько сред:

• Local — агент работает прямо в текущей папке.
• Worktree — агент работает в отдельной копии Git-проекта.
• Cloud — агент работает в удалённой среде.

Новичку лучше начинать с:

• Local, если проект тестовый;
• Worktree, если проект уже важный;
• Cloud, когда понятны переменные окружения, зависимости и GitHub.

Вариант 2. Codex CLI

macOS и Linux

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Перейдите в папку проекта:

cd путь-к-проекту

Запустите Codex:

codex

При первом запуске выберите вход через ChatGPT. Codex CLI работает с локальным репозиторием, умеет изменять файлы, запускать установленные инструменты и использоваться в автоматических скриптах через codex exec.

Вариант 3. Codex в VS Code или Cursor

1. Откройте Extensions.
2. Найдите официальное расширение Codex.
3. Установите его.
4. Войдите через ChatGPT.
5. Откройте папку проекта.
6. Откройте панель Codex.

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

5. Что обязательно настроить после установки

5.1 Профиль

Имя, фотография и username не влияют на качество кода.

Заполнить их можно, но это не является настройкой агента. В Codex раздел Profile в основном показывает статистику использования и позволяет изменить публичные данные профиля.

Гораздо важнее следующие настройки.

5.2 Персональные инструкции

Добавьте информацию о том, как агент должен с вами работать.

Пример:

Я начинающий разработчик.

Объясняй важные архитектурные решения простым языком.
Не добавляй новые библиотеки без необходимости.
Перед большой переработкой сначала предложи план.
После изменений запускай линтер и тесты.
Не изменяй файлы вне текущего проекта.
Не удаляй данные и не выполняй destructive-команды без подтверждения.

В Codex персонализация, custom instructions и memories настраиваются через Settings.

5.3 Память

Память нужна, чтобы агент учитывал ваши постоянные предпочтения:

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

Codex

Откройте:

Settings → Personalization → Enable memories

Локальная память Codex по умолчанию может быть отключена, поэтому её необходимо включить вручную.

Claude Code

Claude использует:

• автоматическую память;
• глобальный CLAUDE.md;
• проектный CLAUDE.md;
• локальный CLAUDE.local.md.

Команда:

/memory

показывает, какие файлы памяти загружены.

5.4 Разрешения

Не выдавайте полный доступ сразу.

Начните с режима, в котором агент:

• читает проект;
• редактирует только текущую папку;
• спрашивает разрешение перед опасными командами;
• не имеет автоматического доступа ко всему диску и сети.

Подробная схема разрешений находится ниже в разделе о полном управлении.

5.5 GitHub

GitHub стоит подключить, если вы хотите:

• хранить резервную копию проекта;
• работать через облачного агента;
• создавать Pull Request;
• проводить code review;
• управлять задачами через Issues;
• работать с проектом с разных компьютеров.

Codex Cloud требует подключить GitHub, выбрать репозитории и создать отдельную среду с зависимостями и переменными.

5.6 Коннекторы

Подключайте только сервисы, которые реально нужны.

Например:

• GitHub;
• Google Drive;
• Gmail;
• Slack;
• Linear;
• Figma;
• Notion;
• Sentry;
• Supabase.

Каждый дополнительный коннектор расширяет возможности агента, но одновременно расширяет количество данных и действий, к которым он получает доступ.

6. Что такое проект внутри AI-агента

Проект — это не один диалог.

Обычно проект содержит:

• папку с файлами;
• Git-репозиторий;
• инструкции для агента;
• историю задач;
• зависимости;
• команды запуска;
• тесты;
• переменные окружения;
• подключённые инструменты.

Проект в Claude Chat

Проект объединяет:

• несколько диалогов;
• загруженные документы;
• общие инструкции;
• базу знаний.

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

Проект в Claude Code или Codex

Проектом становится локальная папка или Git-репозиторий.

Агент читает её структуру и выполняет команды внутри неё.

7. Что такое Git, GitHub, репозиторий и Docker

Git

Git хранит историю изменений проекта.

Каждое сохранённое состояние называется commit.

Git позволяет:

• посмотреть, что изменил агент;
• вернуть старую версию;
• создать отдельную ветку;
• сравнить изменения;
• отменить неудачную работу.

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

Без Git

Агент изменил 38 файлов, приложение перестало запускаться, а вы пытаетесь вспомнить, какой именно index-final-v2-real.ts был рабочим.

С Git

Вы выполняете:

git restore .

или возвращаетесь к предыдущему коммиту.

Репозиторий

Репозиторий — папка проекта, в которой Git хранит историю.

Создание репозитория:

mkdir my-project
cd my-project
git init

После появления первых файлов:

git add .
git commit -m "Initial commit"

GitHub

GitHub хранит удалённую копию Git-репозитория.

Git работает локально. GitHub находится в интернете.

Создать репозиторий можно через сайт GitHub или GitHub CLI:

gh repo create

GitHub CLI умеет создать удалённый репозиторий и отправить в него существующий локальный проект.

Docker

Docker запускает приложение и его сервисы в изолированных контейнерах.

Он особенно полезен, когда проект использует:

• PostgreSQL;
• Redis;
• очереди;
• несколько серверов;
• системные библиотеки;
• сложную среду;
• одинаковое окружение для команды и сервера.

Docker предназначен для разработки, доставки и запуска приложений в воспроизводимой среде. Docker Compose позволяет запускать несколько связанных сервисов, например приложение и базу данных.

Docker не обязателен, если:

• вы создаёте простую HTML-страницу;
• делаете небольшой React-сайт;
• используете облачную базу;
• пока изучаете основы;
• проект состоит из одного простого приложения.

Docker полезен, если:

• нужна локальная PostgreSQL;
• проект должен одинаково запускаться у нескольких людей;
• агент постоянно сталкивается с несовпадающими версиями;
• приложение состоит из нескольких сервисов.

8. Минимальная структура нормального проекта

my-project/
├── src/
├── tests/
├── docs/
├── .gitignore
├── .env.example
├── README.md
├── AGENTS.md
├── CLAUDE.md
├── package.json
└── docker-compose.yml

Не каждый файл обязателен. Для простого проекта достаточно:

my-project/
├── src/
├── .gitignore
├── README.md
├── AGENTS.md или CLAUDE.md
└── package.json

Назначение файлов

README.md

Объясняет:

• что делает проект;
• как установить зависимости;
• как запустить приложение;
• какие команды доступны;
• как провести тестирование.

.gitignore

Указывает Git, какие файлы нельзя добавлять в репозиторий:

node_modules/
dist/
.env
.DS_Store
coverage/

GitHub рекомендует хранить правила исключений в .gitignore. Файлы с секретами, например .env, не должны попадать в репозиторий.

.env

Содержит настоящие секреты:

DATABASE_URL=...
OPENAI_API_KEY=...
JWT_SECRET=...

.env.example

Содержит только названия переменных:

DATABASE_URL=
OPENAI_API_KEY=
JWT_SECRET=

Никогда не помещайте настоящие API-ключи в AGENTS.md, CLAUDE.md, README или Git.

Если ключ попал в историю Git, его нужно не просто удалить из файла, а отозвать и создать новый.

9. AGENTS.md и CLAUDE.md

Это одни из самых важных файлов при работе с AI-агентами.

AGENTS.md

Используется Codex.

Codex читает AGENTS.md перед началом работы и применяет содержащиеся там инструкции. Можно создать глобальный файл и отдельные файлы внутри конкретных репозиториев.

CLAUDE.md

Используется Claude Code.

Claude читает CLAUDE.md в начале сессии. В нём хранятся постоянные правила проекта и рабочего процесса.

Что писать в этих файлах

• назначение проекта;
• используемый стек;
• структура папок;
• команды запуска;
• команды тестирования;
• архитектурные правила;
• требования к безопасности;
• ограничения;
• правила работы с Git;
• запрещённые действия;
• критерии завершения задачи.

Пример AGENTS.md или CLAUDE.md

# Project instructions

## Product

This project is a web application for creating structured notes from screenshots.

## Stack

- TypeScript
- React
- Node.js
- Fastify
- PostgreSQL
- Docker Compose

## Commands

Install dependencies:

`npm install`

Start development:

`npm run dev`

Run lint:

`npm run lint`

Run tests:

`npm test`

## Architecture

- Keep routes thin.
- Put business logic in services.
- Put database queries in repositories.
- Do not access PostgreSQL directly from route handlers.
- Reuse existing components before creating new ones.

## Working rules

- Inspect existing code before implementing changes.
- Before large changes, create a short plan.
- Do not add production dependencies without explaining why.
- Do not modify unrelated files.
- Do not delete migrations.
- Do not change public API contracts without approval.
- After every change, run lint and relevant tests.
- Report every command that failed.

## Security

- Never commit `.env`.
- Never print secrets in logs.
- Validate all external input.
- Do not disable authentication to make tests pass.

## Git

- Work on a separate branch.
- Keep commits focused.
- Do not rewrite Git history.
- Do not push directly to main.

## Definition of done

A task is complete only when:

1. The requested behavior works.
2. Relevant tests pass.
3. Lint passes.
4. No unrelated files were changed.
5. Documentation is updated when needed.

Не пытайтесь записать туда всю биографию проекта на 40 страниц. Файл должен помогать агенту принимать решения, а не превращаться в ещё одну священную рукопись, которую никто не читает.

10. Что такое Skills

Skill — это переиспользуемая инструкция для конкретного типа работы.

Можно считать Skill рабочим регламентом для агента.

Примеры:

• как создавать API endpoint;
• как проверять безопасность;
• как оформлять Instagram-карусель;
• как проводить code review;
• как создавать миграции;
• как публиковать приложение;
• как анализировать конкурентов;
• как писать сценарии Reels.

Skill обычно представляет собой папку с обязательным файлом SKILL.md. Дополнительно в неё можно добавить скрипты, шаблоны, документацию и другие ресурсы. Codex и Claude могут загружать Skill автоматически, когда описание соответствует задаче.

Чем Skill отличается от обычного промпта

Промпт

Используется один раз:

После изменения кода запусти тесты.

Skill

Хранит полный повторяемый процесс:

1. Найти затронутые тесты.
2. Запустить линтер.
3. Запустить unit-тесты.
4. Запустить integration-тесты.
5. Проанализировать ошибки.
6. Исправить проблему.
7. Повторить проверку.
8. Подготовить отчёт.

Структура Skill

my-skill/
├── SKILL.md
├── scripts/
├── references/
└── assets/

• SKILL.md — основная инструкция.
• scripts/ — повторяемые команды или программы.
• references/ — документация.
• assets/ — шаблоны и исходные материалы.

Пример простого Skill

---
name: safe-feature-development
description: Use when implementing a new feature in an existing software project. Do not use for simple explanations or documentation-only requests.
---

# Safe feature development

1. Read the relevant project instructions.
2. Inspect the current architecture and similar existing features.
3. Identify files that will need modification.
4. Create a short implementation plan.
5. Check whether the task requires database migrations or new dependencies.
6. Implement the smallest complete version.
7. Add or update tests.
8. Run lint, type checking, and relevant tests.
9. Review the final diff for unrelated changes.
10. Report:
   - files changed;
   - commands run;
   - test results;
   - remaining risks.

Как создать Skill в Codex

Самый простой способ:

$skill-creator

Codex спросит:

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

Skill также можно создать вручную в:

.agents/skills/имя-скила/SKILL.md

Codex может активировать Skill явно через выбор пользователя или автоматически по его описанию.

Как создать Skill в Claude Code

Создайте:

.claude/skills/имя-скила/SKILL.md

Или установите официальный Skill Creator:

/plugin install skill-creator@claude-plugins-official

После установки:

/reload-plugins

Claude Code также содержит встроенные skills, включая команды для отладки и code review.

Каким должен быть хороший Skill

Хороший Skill:

• решает одну конкретную задачу;
• имеет понятные условия запуска;
• описывает входные данные;
• описывает ожидаемый результат;
• содержит этап проверки;
• не даёт агенту лишних прав;
• не повторяет общие инструкции проекта.

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

11. Что такое плагины

Плагин — готовый пакет возможностей.

Он может содержать:

• Skills;
• коннекторы;
• MCP-серверы;
• subagents;
• hooks;
• команды;
• настройки.

Если Skill является одной инструкцией, то Plugin является целым набором функций.

Пример

Плагин для GitHub может содержать:

• коннектор к GitHub;
• Skill для создания Issues;
• Skill для Pull Request;
• Skill для code review;
• MCP-инструменты для чтения репозитория;
• специальные агенты для проверки безопасности.

В Codex плагины могут объединять skills, коннекторы и MCP-инструменты. Они устанавливаются через раздел Plugins, команду /plugins в CLI или настройки IDE. После установки обычно нужно открыть новую сессию.

В Claude плагины также объединяют skills, connectors и subagents, а плагины Claude Code могут включать agents, hooks и MCP servers.

Когда использовать готовый плагин

Используйте плагин, если:

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

Когда лучше создать свой Skill

Создавайте Skill, если:

• процесс относится только к вашему проекту;
• не нужны внешние сервисы;
• достаточно инструкции и нескольких скриптов;
• вы ещё экспериментируете с процессом.

Когда создавать свой плагин

Создавайте плагин, если:

• набор функций нужен нескольким проектам;
• его будет использовать команда;
• необходимо объединить skills и MCP;
• требуется распространять готовую конфигурацию;
• процесс уже стабилен.

12. Что такое коннекторы

Connector подключает AI к внешнему сервису.

Примеры:

• Gmail;
• Google Drive;
• Calendar;
• GitHub;
• Slack;
• Linear;
• Notion;
• Figma;
• Microsoft 365.

После подключения агент может:

• читать разрешённые данные;
• искать информацию;
• создавать новые объекты;
• изменять существующие данные;
• запускать действия.

Claude наследует права пользователя в подключённом сервисе. Если у пользователя нет доступа к документу или каналу, коннектор также не сможет получить доступ.

Важное правило

Коннектор не равен полному доступу ко всему аккаунту.

Он работает только:

• в рамках выданных OAuth-разрешений;
• в рамках прав текущего пользователя;
• через инструменты, которые реализовал разработчик коннектора.

Тем не менее перед подключением проверяйте:

• какие данные разрешено читать;
• разрешена ли запись;
• может ли агент удалять данные;
• может ли отправлять сообщения;
• может ли публиковать изменения.

13. Что такое MCP-сервер

MCP расшифровывается как Model Context Protocol.

Это открытый стандарт, через который AI-приложения подключаются к внешним данным и инструментам.

MCP может предоставить агенту:

• доступ к локальным файлам;
• доступ к базе данных;
• поиск по документации;
• работу с GitHub;
• управление браузером;
• работу с Figma;
• запросы к API;
• доступ к логам;
• управление облачной инфраструктурой.

Claude и Codex поддерживают MCP для подключения инструментов и контекста.

Как MCP работает

Система состоит из трёх частей:

AI-приложение → MCP-клиент → MCP-сервер → внешний сервис

Например:

Claude Code → MCP → GitHub

Claude вызывает инструмент:

get_pull_request

MCP-сервер GitHub получает запрос, обращается к GitHub API и возвращает результат агенту.

MCP-сервер может предоставлять

Resources

Данные для чтения:

• документация;
• файлы;
• схемы базы;
• записи;
• логи.

Tools

Действия:

• создать Issue;
• выполнить SQL;
• отправить сообщение;
• развернуть приложение;
• сделать скриншот;
• запустить тест.

Prompts или workflows

Подготовленные сценарии работы.

Локальный и удалённый MCP

Локальный MCP

Запускается на вашем компьютере.

Плюсы:

• может работать с локальными файлами;
• удобно для разработки;
• данные могут оставаться локально.

Минусы:

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

Удалённый MCP

Работает на внешнем сервере.

Плюсы:

• доступен с разных устройств;
• не требует локального процесса;
• удобнее для команд.

Минусы:

• данные проходят через внешний сервис;
• нужно внимательно проверять разработчика;
• требуется авторизация.

Claude поддерживает custom connectors через удалённые MCP-серверы, а Claude Code может подключаться к внешним системам напрямую через MCP.

Когда MCP действительно нужен

Подключайте MCP, когда вы регулярно:

• копируете данные из одного сервиса в чат;
• просите агента работать с системой, для которой нет встроенного коннектора;
• используете внутреннее API;
• хотите дать агенту специализированный инструмент;
• хотите автоматизировать повторяющуюся последовательность действий.

Не нужно устанавливать 40 MCP-серверов «на будущее». Каждый инструмент занимает контекст, усложняет выбор и увеличивает поверхность риска.

OpenAI также рекомендует начинать с одного-двух инструментов, которые устраняют реальный повторяющийся ручной процесс.

14. Как создать первый проект с AI-агентом

Рассмотрим безопасный универсальный процесс.

Шаг 1. Опишите проект

До запуска Code сформулируйте:

• для кого проект;
• какую проблему он решает;
• одну главную функцию;
• платформу;
• ограничения;
• критерий готовности.

Пример:

Создай простой веб-сервис.

Пользователь вводит текст.
Сервис сокращает текст до трёх пунктов.
Данные не сохраняются.
Нужна одна адаптивная страница.
Стек: React, TypeScript и Vite.

Шаг 2. Попросите составить план

Пока не изменяй файлы.

Сначала:
1. предложи структуру проекта;
2. перечисли необходимые зависимости;
3. опиши основные компоненты;
4. предложи этапы реализации;
5. укажи основные риски.

Не просите сразу создать авторизацию, платежи, мобильное приложение, админку, аналитику и метавселенную. Сначала создаётся одна рабочая функция. У людей удивительная способность превращать MVP в техническое завещание.

Шаг 3. Создайте папку и Git

mkdir text-shortener
cd text-shortener
git init

Шаг 4. Откройте папку в Claude Code или Codex

Для Claude:

claude

Для Codex:

codex

Или добавьте папку через приложение.

Шаг 5. Создайте инструкции

Попросите агента:

Создай AGENTS.md и CLAUDE.md для этого проекта.

Добавь:
- описание продукта;
- стек;
- команды запуска;
- архитектурные правила;
- требования к тестам;
- правила безопасности;
- definition of done.

Перед сохранением покажи мне содержимое.

Шаг 6. Создайте начальный коммит

После создания базового проекта:

git add .
git commit -m "Initial project setup"

Codex прямо рекомендует создавать Git-контрольные точки до и после задач, чтобы изменения можно было откатить.

Шаг 7. Реализуйте только первый этап

Реализуй только базовый интерфейс без AI API.

Требования:
- поле для текста;
- кнопка;
- блок результата;
- адаптивная мобильная версия;
- понятное состояние загрузки;
- обработка пустого ввода.

После реализации:
- запусти проект;
- проверь ошибки;
- запусти lint;
- перечисли изменённые файлы.

Шаг 8. Проверьте результат

Попросите:

Проведи ревью собственных изменений.

Проверь:
- соответствует ли результат задаче;
- нет ли лишних зависимостей;
- нет ли дублирования;
- работает ли мобильная версия;
- обработаны ли ошибки;
- проходят ли проверки.

Ничего не меняй. Сначала выдай отчёт.

Шаг 9. Создайте коммит

git add .
git commit -m "Build initial interface"

Шаг 10. Отправьте проект в GitHub

gh repo create

Или создайте репозиторий через сайт и выполните:

git remote add origin https://github.com/USER/REPOSITORY.git
git branch -M main
git push -u origin main

15. Как правильно ставить задачи агенту

Хорошая задача содержит семь частей.

1. Контекст

Это React-приложение для работы с заметками.

2. Проблема

После обновления страницы выбранная категория сбрасывается.

3. Желаемый результат

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

4. Ограничения

Не добавляй новые библиотеки и не меняй API.

5. Область работы

Проверь компоненты фильтра и существующее хранилище настроек.

6. Проверка

Добавь тест и запусти существующие тесты.

7. Формат отчёта

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

Итоговый промпт

В React-приложении после обновления страницы сбрасывается выбранная категория.

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

Ограничения:
- не добавляй новые библиотеки;
- не меняй API;
- не перерабатывай несвязанные компоненты.

Сначала найди причину и составь короткий план.
После этого исправь ошибку, добавь тест и запусти существующие проверки.

В конце сообщи:
- причину ошибки;
- изменённые файлы;
- выполненные команды;
- результаты тестов.

Для крупных задач официальные рекомендации также советуют разделять работу на этапы, а не объединять планирование, реализацию, авторизацию, развёртывание и полировку в один гигантский запрос.

16. Как передать агенту полное управление проектом

Сначала определим, что означает «полное управление»

Полный доступ может включать:

• чтение всех файлов проекта;
• изменение файлов;
• создание и удаление файлов;
• запуск терминальных команд;
• установку библиотек;
• доступ к интернету;
• доступ к Git;
• доступ к GitHub;
• доступ к переменным окружения;
• запуск Docker;
• работу с браузером;
• выполнение миграций;
• развёртывание приложения.

Это не одна кнопка. Это набор отдельных разрешений.

Безопасная лестница доступа

Уровень 1. Только чтение

Агент:

• изучает проект;
• объясняет архитектуру;
• составляет план;
• ничего не меняет.

Используйте при первом знакомстве агента с проектом.

Уровень 2. Запись только в проект

Агент:

• изменяет файлы текущего проекта;
• не работает за пределами папки;
• спрашивает разрешение на команды.

Это лучший режим для новичка.

Уровень 3. Автоматическая работа внутри проекта

Агент:

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

Подходит после того, как проект находится под Git.

Уровень 4. Полный доступ

Агент:

• может работать вне папки;
• может выполнять команды без подтверждения;
• может использовать сеть;
• может затронуть другие файлы и сервисы.

Используйте только в:

• отдельном Worktree;
• dev container;
• виртуальной машине;
• тестовом компьютере;
• изолированном проекте без production-секретов.

17. Полный доступ в Codex

Codex предоставляет три встроенных профиля разрешений:

:read-only
:workspace
:danger-full-access

• :read-only — только чтение.
• :workspace — запись внутри активной рабочей области.
• :danger-full-access — снимает локальные ограничения песочницы.

OpenAI прямо указывает, что :danger-full-access следует использовать только тогда, когда широкий доступ выдан намеренно.

Рекомендуемый вариант

Используйте:

:workspace

И разрешайте конкретные действия при необходимости.

Для CLI безопасный рабочий режим выглядит примерно так:

codex --sandbox workspace-write --ask-for-approval on-request

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

Local или Worktree

Local

Codex меняет вашу настоящую рабочую папку.

Используйте, если:

• проект небольшой;
• вы наблюдаете за изменениями;
• перед задачей создан коммит.

Worktree

Codex создаёт отдельную Git-копию проекта.

Преимущества:

• агент не мешает вашей текущей работе;
• несколько задач можно выполнять параллельно;
• изменения легче проверить;
• неудачный результат проще удалить.

Worktree требует, чтобы проект уже был Git-репозиторием.

Лучший вариант для автономной работы

Git repository
→ отдельная ветка
→ Worktree
→ workspace permissions
→ тестовые секреты
→ обязательный review перед merge

18. Полный доступ в Claude Code

Claude Code предоставляет несколько режимов.

Plan

Claude:

• изучает проект;
• составляет план;
• не редактирует файлы.

Используйте перед большой задачей.

Manual

Claude спрашивает подтверждение перед изменениями и большинством команд.

Лучший режим для первого знакомства.

Accept Edits

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

Подходит для обычной разработки.

Auto

Claude самостоятельно определяет, какие действия безопасны, в рамках настроенных правил. Доступность может зависеть от версии и конфигурации.

Bypass Permissions

Claude выполняет действия без обычных запросов разрешений.

В CLI этот режим связан с параметрами вроде:

claude --dangerously-skip-permissions

или конфигурацией bypassPermissions.

Название команды хотя бы честное. Редкий случай, когда программа заранее сообщает, что пользователь собирается сделать нечто сомнительное.

Anthropic рекомендует использовать Bypass Permissions только в изолированной среде без доступа к интернету.

19. Как безопасно дать агенту максимум автономности

Перед запуском

1. Создайте Git-репозиторий.
2. Сделайте чистый коммит.
3. Создайте отдельную ветку.
4. Уберите production-ключи.
5. Проверьте .gitignore.
6. Создайте AGENTS.md или CLAUDE.md.
7. Добавьте команды тестирования.
8. Ограничьте область работы.
9. Используйте Worktree или контейнер.
10. Укажите запрещённые действия.

Пример подготовительных команд

git status
git add .
git commit -m "Checkpoint before agent task"
git switch -c agent/feature-name

Пример задачи для автономного агента

Ты работаешь автономно в отдельной Git-ветке.

Цель:
реализовать функцию импорта заметок из JSON.

Перед началом:
1. прочитай AGENTS.md;
2. изучи существующую архитектуру;
3. найди похожие функции;
4. составь план.

Ограничения:
- работай только внутри текущего репозитория;
- не меняй публичный API;
- не добавляй зависимости без необходимости;
- не изменяй файлы авторизации;
- не запускай production-команды;
- не отправляй изменения в main;
- не удаляй пользовательские данные.

Процесс:
1. реализуй функцию;
2. добавь валидацию;
3. добавь тесты;
4. запусти lint;
5. запусти typecheck;
6. запусти relevant tests;
7. исправь найденные ошибки;
8. проверь итоговый diff.

Заверши работу только когда проверки проходят.

В финальном отчёте укажи:
- что было сделано;
- какие файлы изменены;
- какие команды запускались;
- результаты тестов;
- известные ограничения;
- что мне нужно проверить вручную.

20. Что агенту нельзя разрешать без контроля

Даже при полном управлении оставьте ручное подтверждение для:

• удаления базы данных;
• production-миграций;
• публикации приложения;
• изменения DNS;
• оплаты сервисов;
• отправки массовых писем;
• удаления облачных ресурсов;
• изменения прав доступа;
• работы с криптокошельками;
• публикации в социальных сетях;
• слияния в main;
• изменения billing;
• выполнения rm -rf;
• изменения настоящих пользовательских данных.

AI хорошо пишет код. Это не означает, что ему необходимо разрешить самостоятельно удалить production-базу в три часа ночи, а затем подготовить убедительный отчёт о полученном опыте.

21. Как проверять работу агента

После каждой серьёзной задачи проверяйте пять вещей.

1. Diff

Посмотрите:

git diff

или встроенную вкладку изменений.

Проверьте:

• какие файлы изменены;
• нет ли лишних изменений;
• не удалён ли важный код;
• не добавлены ли секреты;
• не отключены ли проверки.

2. Запуск

npm run dev

Убедитесь, что приложение действительно открывается.

3. Линтер

npm run lint

4. Typecheck

npm run typecheck

5. Тесты

npm test

Не принимайте фразу агента «всё должно работать» как результат проверки.

Результат проверки выглядит так:

npm run lint — passed
npm run typecheck — passed
npm test — 42 passed, 0 failed

22. Типичные ошибки новичков

Ошибка 1. Один огромный запрос

Создай полный аналог Instagram с AI, оплатами и админкой.

Правильнее:

1. Создать структуру.
2. Сделать авторизацию.
3. Сделать одну сущность.
4. Сделать базовый интерфейс.
5. Добавить тесты.
6. Потом расширять.

Ошибка 2. Работа без Git

Перед каждой серьёзной задачей нужен чистый коммит.

Ошибка 3. Полный доступ к основному компьютеру

Используйте workspace, Worktree или контейнер.

Ошибка 4. Отсутствие инструкций проекта

Без AGENTS.md или CLAUDE.md агент каждый раз заново угадывает ваши правила.

Ошибка 5. Слишком много Skills и MCP

Устанавливайте только то, что решает регулярную проблему.

Ошибка 6. Агент самостоятельно выбирает архитектуру

Сначала попросите варианты и аргументы. Потом утвердите направление.

Ошибка 7. Отсутствие тестов

Если агент не может проверить результат, он завершает задачу на основании собственного оптимизма. Это качество уже достаточно распространено среди людей, машине его прививать необязательно.

Ошибка 8. Секреты внутри проекта

Настоящие ключи должны находиться в .env, secret storage или настройках облачной среды, но не в Git.

23. Рекомендуемый рабочий процесс для новичка

Перед задачей

1. Открыть проект.
2. Проверить git status.
3. Создать checkpoint-коммит.
4. Переключиться на новую ветку.
5. Запустить агента.

Во время задачи

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

После задачи

1. Проверить diff.
2. Запустить приложение.
3. Запустить lint.
4. Запустить typecheck.
5. Запустить тесты.
6. Проверить результат вручную.
7. Создать commit.
8. Отправить в GitHub.

24. Минимальный набор инструментов

Новичку достаточно установить:

1. Claude Desktop или ChatGPT/Codex.
2. VS Code или Cursor.
3. Git.
4. Node.js, если проект на JavaScript или TypeScript.
5. GitHub Desktop или GitHub CLI, необязательно.
6. Docker Desktop, только если нужен Docker.
7. Один AI-агент.

Не нужно сразу устанавливать:

• десять MCP-серверов;
• пять IDE;
• локальные модели;
• Kubernetes;
• отдельный сервер;
• восемь AI-ассистентов;
• терминальную тему, на настройку которой уйдёт больше времени, чем на сам проект.

25. Финальный чек-лист

Установка

• Установлен Claude или Codex.
• Выполнена авторизация.
• Установлен редактор.
• Установлен Git.
• При необходимости установлен Docker.

Настройка агента

• Добавлены персональные инструкции.
• Настроена память.
• Проверены разрешения.
• Подключён GitHub.
• Подключены только нужные коннекторы.
• Не установлены случайные непроверенные плагины.

Настройка проекта

• Создан Git-репозиторий.
• Создан .gitignore.
• Создан .env.example.
• Настоящий .env исключён из Git.
• Создан README.
• Создан AGENTS.md или CLAUDE.md.
• Указаны команды запуска и тестирования.
• Создан первый коммит.

Работа с агентом

• Сначала агент изучает проект.
• Затем составляет план.
• Большая задача разделена на этапы.
• Агент работает в отдельной ветке или Worktree.
• После работы проверяется diff.
• Запускаются тесты.
• Production-действия подтверждаются вручную.

Главное правило

Не пытайтесь управлять AI-агентом как человеком, которому нужно подробно диктовать каждое нажатие клавиши.

Дайте ему:

• понятную цель;
• контекст;
• ограничения;
• инструменты;
• критерии готовности;
• способ проверить результат.

После этого позвольте агенту самостоятельно выбрать конкретные действия, но оставьте Git, sandbox и ручное подтверждение опасных операций.

Хороший AI-процесс выглядит так:

Цель
→ план
→ изолированная среда
→ реализация
→ автоматическая проверка
→ ручной review
→ commit
→ merge

Именно так AI превращается из генератора кода в полноценного рабочего агента.