Материал модуля 1

Словарь терминов: Codex, Claude Code, Git и GitHub

Объяснить простыми словами слова, которые встречаются в работе с агентом.

Есть подключение к ClaudeBase? Этот материал агент достанет и применит сам. Скажите ему: «найди в ClaudeBase материал „Словарь терминов: Codex, Claude Code, Git и GitHub“».

К урокам: урок 1. Агент и чат: в чём разница, урок 2. Какие бывают агенты и как агент работает на деле, урок 3. Четыре способа работать с Claude: сайт, приложение, терминал, VS Code

Этот словарь нужен, чтобы слова из курса не мешали работе. Запоминать все сразу не нужно. Увидел незнакомое слово - открыл словарь, прочитал объяснение и пошел дальше.

Если после объяснения слово все равно непонятно, спроси Codex: Объясни это еще проще и приведи пример на моем проекте.

Самое начало

Проект

Вся работа, собранная в одной папке: код, картинки, настройки, описание и проверки. Сайт, бот или приложение - это разные виды проектов.

Код

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

Программа или приложение

То, чем пользуется человек: сайт, бот, мобильное приложение, интернет-магазин или внутренняя рабочая система.

Разработчик

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

Пользователь

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

Файл

Один отдельный документ на компьютере. Код, текст, картинка и настройки хранятся в разных файлах.

Папка

Место, где лежат файлы и другие папки. Папка проекта содержит все, что относится к проекту.

Путь

Точный адрес файла или папки на компьютере. Например: /Users/ivan/Projects/my-app.

Корень проекта

Главная папка проекта. Обычно именно в ней лежат README.md, AGENTS.md и основные настройки.

Расширение файла

Часть имени после точки. Она помогает понять формат файла: .md, .json, .html, .py.

Codex, Claude Code и искусственный интеллект

Искусственный интеллект

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

Модель

Основная система, которая понимает запрос и создает ответ. Разные модели отличаются скоростью, качеством и стоимостью работы.

LLM

Сокращение от Large Language Model, то есть большая языковая модель. Это модель, которая работает с обычным языком и кодом.

Инференс

Момент, когда модель получает твой запрос и вычисляет ответ. Проще: это сама работа модели прямо сейчас.

Токен модели

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

Контекст

Информация, которую Codex видит и учитывает сейчас: твой запрос, правила проекта и прочитанные файлы.

Контекстное окно

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

Агент

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

Кодинг-агент

Агент для разработки программ. Он умеет работать с кодом, Git, тестами и файлами проекта.

Codex

Кодинг-агент OpenAI. Он может изучать проект, писать и исправлять код, запускать проверки и объяснять результат.

Claude Code

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

Harness, произносится “харнесс”

Обвязка вокруг модели: программа, которая дает ей доступ к файлам, терминалу, правилам, инструментам и проверкам. Codex и Claude Code - примеры такой рабочей оболочки для модели.

CLI, произносится “си-эл-ай”

Способ управлять программой через текстовые команды в терминале. Codex CLI - версия Codex, которую запускают командой codex.

Codex App

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

Prompt, или промпт

Задание для AI. Хороший промпт объясняет цель, ограничения, порядок работы и ожидаемый результат.

Workflow, или порядок работы

Повторяемая последовательность шагов. Например: понять задачу, составить план, написать проверку, изменить код, снова проверить.

Skill, или скилл

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

Plugin, или плагин

Устанавливаемое дополнение к программе. Один плагин может добавить сразу много скиллов и других возможностей.

Superpowers

Набор скиллов для правильной разработки. Он заставляет сначала понять задачу и составить план, а перед словом “готово” запустить проверки.

Skill Creator

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

MCP

Способ подключить к AI внешний сервис или инструмент. Например, браузер, базу данных, Figma или систему с документами.

API

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

API-ключ

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

Git и GitHub

Git

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

GitHub

Сайт, где хранят Git-репозитории. Через GitHub можно хранить резервную копию проекта и работать вместе с другими людьми.

Репозиторий

Папка проекта вместе с историей изменений Git. Репозиторий может лежать на компьютере и на GitHub.

Публичный репозиторий

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

Приватный репозиторий

Репозиторий, доступ к которому есть только у владельца и приглашенных людей. Секреты все равно не нужно хранить даже там.

Локально

На твоем компьютере. Локальный файл еще не обязательно находится на GitHub.

Remote

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

Origin

Обычное имя главного remote. Когда видишь origin, чаще всего речь идет о твоем основном репозитории GitHub.

Clone, или клонирование

Скачивание полной копии репозитория с GitHub на компьютер вместе с его историей.

Fork

Отдельная копия чужого репозитория в твоем GitHub. Ее можно менять независимо от оригинала.

Branch, или ветка

Отдельная линия работы внутри Git. В ветке можно делать изменения, не затрагивая основную рабочую версию.

Main

Обычное имя главной ветки проекта. В ней обычно лежит текущая рабочая версия.

Git status

Команда, которая показывает состояние проекта: какие файлы изменены, добавлены или еще не сохранены в Git.

Изменение

Любая разница между текущим файлом и последней сохраненной версией Git.

Stage и git add

Подготовка выбранных файлов к commit. Это еще не сохранение истории, а список того, что войдет в следующий commit.

Commit, или коммит

Сохраненная точка в истории Git. У commit есть название, автор, дата и точный набор изменений.

Push, или пуш

Отправка локальных commit с компьютера в GitHub. После успешного push сохраненная версия есть и на удаленном сервере.

Pull

Получение новых изменений из GitHub на компьютер.

История Git

Последовательность commit проекта. По ней можно увидеть, что менялось и вернуться к прошлому состоянию.

Diff

Точное сравнение двух версий. Diff показывает добавленные, измененные и удаленные строки.

Merge

Объединение изменений из одной ветки с другой.

Конфликт Git

Ситуация, когда Git не может сам объединить две версии одного места. Человек должен выбрать правильный вариант.

Откат

Возврат к прошлому рабочему состоянию. Перед откатом нужно точно понимать, какие изменения будут потеряны.

Точка возврата

Проверенный commit, к которому можно вернуться, если следующие изменения сломают проект.

Worktree

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

Главные файлы проекта

README.md, произносится “ридми”

Короткая инструкция для человека: что это за проект, как его установить, запустить и проверить.

AGENTS.md

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

PROJECT_STATE.md

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

AUTOPILOT.md

Пошаговый сценарий первой настройки Codex Starter. Он проводит владельца проекта через вопросы и заполнение нужных файлов.

.gitignore

Список файлов и папок, которые Git не должен сохранять и отправлять в GitHub. Обычно туда добавляют .env, временные файлы и результаты сборки.

.env

Локальный файл для паролей, API-ключей и других секретных настроек. Его нельзя читать вслух, печатать в чат или отправлять в GitHub.

.env.example

Безопасный пример файла .env. В нем оставляют названия настроек, но не настоящие пароли и ключи.

Переменная окружения

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

package.json

Главный файл настроек проекта на JavaScript или Node.js. В нем обычно указаны название проекта, команды запуска и зависимости. package.js - частая оговорка, правильное имя файла обычно package.json.

Lock-файл

Файл с точными версиями установленных зависимостей. Примеры: package-lock.json, pnpm-lock.yaml, yarn.lock. Его не нужно менять без причины.

Config, или файл настроек

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

JSON

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

YAML

Текстовый формат настроек, где структура задается отступами. В YAML неправильный отступ может изменить смысл файла.

TOML

Еще один текстовый формат настроек. Codex использует TOML, например, для некоторых файлов конфигурации.

Markdown и файл .md

Простой текстовый формат с заголовками, списками и ссылками. README.md и AGENTS.md написаны в Markdown.

Script, или скрипт

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

Hook, или хук

Автоматическая проверка, которая запускается перед или после определенного действия. Например, хук может остановить опасную команду или commit с секретом.

Workflow-файл

Файл с последовательностью автоматических действий. На GitHub такие файлы часто запускают тесты после push.

Log-файл, или файл журнала

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

Разработка и проверка

Зависимость

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

Библиотека

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

Фреймворк

Большая основа проекта с готовой структурой и правилами. Примеры: Next.js, Django, Laravel.

Frontend, или фронтенд

Часть программы, которую видит пользователь: страницы, кнопки, формы и сообщения.

Backend, или бэкенд

Часть программы, которая работает на сервере: обрабатывает запросы, проверяет права и работает с данными.

База данных

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

Миграция базы данных

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

Сервер

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

Локальный запуск

Запуск проекта на своем компьютере для разработки и проверки до публикации.

Build, или сборка

Подготовка проекта к запуску или публикации. Во время сборки исходные файлы превращаются в готовую версию программы.

Test, или тест

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

Ручной тест

Проверка, которую человек выполняет сам: открывает страницу, нажимает кнопку и смотрит результат.

Lint, или линтер

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

Проверка типов

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

Bug, или баг

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

Debug, или отладка

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

Refactoring, или рефакторинг

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

CI

Автоматическая проверка проекта после отправки изменений в GitHub. CI может запускать тесты, линтер и сборку.

Deploy, или деплой

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

Production, или продакшен

Настоящая рабочая версия проекта, которой пользуются реальные люди. Ошибка в production может затронуть пользователей и данные.

Release, или релиз

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

Продукт и безопасность

MVP

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

Roadmap

План развития продукта на несколько следующих этапов. Это не обещание точных дат, а порядок крупных задач.

Роль

Тип пользователя в системе. Например: покупатель, менеджер или администратор.

Права доступа

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

Интеграция

Подключение проекта к другому сервису. Например, к платежной системе, Telegram или CRM.

Webhook

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

SaaS

Программа, которой пользуются через интернет, часто по подписке. Например, онлайн-CRM или сервис аналитики.

Open source

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

Лицензия

Юридические правила использования кода. Лицензия объясняет, можно ли копировать, менять и продавать проект.

Пароль

Секретная строка для входа. Пароль нельзя хранить в открытом коде, сообщениях и публичном GitHub.

Секрет

Любые данные, которые дают доступ к системе или раскрывают закрытую информацию: пароль, API-ключ, токен доступа, приватный ключ.

Токен доступа

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

Приватный ключ

Секретный файл или строка для подтверждения личности и защищенного доступа. Файлы часто имеют расширение .pem или .key.

Данные клиента

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

Безопасное действие

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

Опасное действие

Действие, после которого данные сложно вернуть: удаление, перезапись, push не тех файлов, deploy, платеж или изменение production.

Отдельное подтверждение

Явное разрешение человека на конкретное действие. Общая просьба “настрой проект” не означает разрешение удалить файлы, сделать push или deploy.

Пять слов, которые важно не путать

  1. Commit сохраняет точку истории на компьютере.
  2. Push отправляет сохраненные commit в GitHub.
  3. Deploy публикует программу на сервере для пользователей.
  4. Токен модели измеряет объем текста.
  5. Токен доступа является секретом и дает доступ к сервису.

Если незнакомого слова здесь нет, спроси Codex: Объясни термин простыми словами, приведи один пример и скажи, какое действие с ним может быть опасным.


Источник: курс Максима «Разработка с Codex», https://maximsamus.github.io/codex-course/ - перенесено 17.09.2026. Текст не менялся, кроме сокращения: на сайте ClaudeBase принято писать «AI».