Путь новичка
Путь от нуля до рабочего Claude Code с парой базовых MCP.
Первый маршрут — для тех, кто ещё ни разу не запускал ИИ-агента. Идём по шагам и в конце получаем рабочего агента с доступом к задачам в Jira и описаниям фич в Confluence — которому можно задавать вопросы по проекту.
Что в этом роадмепе
- Научишься: понимать токены, выбирать терминал, ставить Claude Code и давать ему задачи.
- Попробуешь: первый промпт и подключение MCP.
- Конечный результат: установленный Claude Code подключенный к Jira/Confluence — агент видит задачи и требования проекта и отвечает на вопросы по нему.
Точные команды меняются — мы объясняем что и зачем, а актуальный синтаксис берём ссылкой на официальную документацию. Не пугайся терминала: это просто окно, куда пишут текстом вместо кликов.
Шаги
Разберись, что такое LLM
Если ты совсем с нуля — начни с «Что такое LLM»: это «мозг» под капотом, языковая модель, которая и генерирует ответы.
Пойми, что такое Claude Code
Если не уверен, чем Claude Code отличается от обычного чат-бота — прочитай короткую статью «Что такое Claude Code». Одно предложение: это та же LLM, которой дали руки — доступ к твоим файлам и терминалу.
Пойми, что такое токены
Агент считает работу в токенах — от них зависит и стоимость, и лимиты. Новичку важно сразу понимать, на что они тратятся: что такое токены.
Получи доступ
Нужен аккаунт и способ оплаты (или бесплатный вариант). Если ты не знаешь, как оплатить подписку — загляни в «Как оплачивать подписки»: там и бесплатные пути (claude.ai, локальные модели и др.).
Выбери терминал
Claude Code живёт в терминале — а их много, и есть удобные под ИИ-агентов. Что выбрать новичку — в статье «Какой терминал выбрать».
Установи Claude Code
Нужен Node.js 22+. Дальше Claude Code ставится одной командой в терминале:
npm install -g @anthropic-ai/claude-codeАктуальную команду и системные требования всегда сверяй с официальным гайдом — они меняются.
Первый запуск и первый промпт
Открой терминал, перйли в папку проекта и напиши команду claude, пройди авторизацию. Дай первую задачу обычным языком — не командой, а как коллеге: «Посмотри файлы в этой папке и объясни, что тут за проект». Не понравился ответ — уточняй, а не начинай заново.
Внутри есть slash-команды (/help, /clear и др.) — короткий обзор в статье «Slash-команды».
Расскажи агенту про проект (память)
Чтобы агент не объяснять каждый раз заново, контекст проекта кладут в файл CLAUDE.md. Это его постоянная память. Как устроено — в статье «Память».
Подключи Jira и Confluence
MCP — это разъём, через который агент получает доступ к внешним штукам (твой трекер задач, браузер, документация). Не знаешь, что это — прочитай короткую статью про MCP.
Первым делом дадим агенту рабочий контекст: задачи в Jira и описания фич в Confluence. После этого ему можно задавать вопросы по проекту — «о чём задача PROJ-123», «какие бизнес-правила у формы оплаты».
Сначала выясни, какой у вас Atlassian — от этого зависит, какой MCP ставить:
- Cloud — живёт у Atlassian, адрес вида
https://компания.atlassian.net. Для него — официальныйatlassian-mcp-server. - Enterprise / Data Center — развёрнут внутри компании на своих серверах (часто свой домен). Для него — community-сервер
mcp-atlassian, который умеет селфхост.
Это два разных MCP под два разных варианта Atlassian — не перепутай, иначе подключение не заведётся. Не уверен, что у вас — глянь на адрес: *.atlassian.net значит Cloud; свой корпоративный домен — обычно Enterprise.
Какой сервер брать, как авторизоваться (OAuth/токен) и что агент сможет читать — пошагово в статье «Доступ к Jira и Confluence».
Перезапусти сессию и проверь, что MCP поднялся
Свежий MCP-сервер не подхватывается на лету — после правки конфига перезапусти Claude Code (заверши сессию и запусти claude заново). Это частая ошибка новичка: «подключил, а агент его не видит» — почти всегда дело в том, что сессию не перезапустили.
Дальше вызови команду /mcp — она покажет список подключённых серверов и их статус. У твоего Atlassian-сервера должен гореть зелёный индикатор (подключён).
Красный статус или ошибка — сервер не поднялся: чаще всего неверный токен, email или URL в конфиге. Вернись к настройке токена и проверь значения, прежде чем идти дальше.
Только когда индикатор зелёный — переходи к боевой проверке ниже.
Проверь, что всё на месте
Спроси у агента, какие инструменты ему доступны, и дай боевую задачу на рабочий контекст: «найди в Confluence описание такой-то фичи» или «о чём задача PROJ-123 в Jira».
Если агент достаёт страницы из Confluence и задачи из Jira — сетап рабочий, можно задавать вопросы по проекту.
Готово ✅
У тебя установлен Claude Code и подключён MCP Atlassian (Jira + Confluence). Теперь агент видит задачи и требования проекта — ему можно задавать вопросы по нему. Это рабочий сетап новичка, дальше только наращивать.
Проверь себя
1. Чем Claude Code отличается от обычного чат-бота?
2. Зачем нужен MCP?
3. Где брать точную команду установки?
4. У вашей компании Atlassian развёрнут на своих серверах (адрес не *.atlassian.net). Какой MCP нужен?
Дальше
Освоился? Следующий маршрут — больше фичей Claude Code: пройдёшь почти все возможности на боевой задаче и в конце соберёшь свой skill.