Как пользоваться Amp: пошаговое руководство по Amp CLI

Чтобы пользоваться Amp, установите CLI командой curl -fsSL https://ampcode.com/install.sh | bash, войдите через amp login, запустите amp в папке проекта и опишите задачу. До первого сообщения выберите режим на Dial клавишами Ctrl+S: low, medium, high или ultra. Дальше Amp читает код, правит файлы и запускает команды, а весь разговор сохраняется как thread, который можно открыть снова или отправить коллегам.

Это основной цикл. В руководстве разобрано всё остальное: вход для скриптов и CI, горячие клавиши на каждый день, режимы, субагенты вроде oracle, settings.json, AGENTS.md, MCP-серверы, режим execute, стоимость Amp и запуск рядом с другими CLI-агентами. Всё здесь основано на официальной документации Amp по состоянию на октябрь 2026 года.

Что такое Amp

Amp — это агент для программирования и среда разработки. Он появился внутри Sourcegraph, а с выделения в декабре 2025 года его развивает независимая компания. Amp не привязан к одному поставщику моделей: модель он выбирает сам в зависимости от режима, а платить за неё можно подпиской ChatGPT, подпиской Claude (в режиме Claude Code) или своими API-ключами.

Пользоваться им можно в трёх местах: веб-приложение на ampcode.com (без установки), приложения для macOS, iPhone, iPad и Android и CLI в терминале, которому посвящено это руководство. Каждый разговор — это thread со своим URL. Amp может выполнять thread и на orb — машине, которую Amp создаёт для этого thread на своих серверах, — или на runner, который вы размещаете сами.

Шаг 1: установите CLI

CLI работает на macOS, Linux и Windows через WSL. Для Windows документация советует WezTerm или Alacritty вместо Windows Terminal: там лучше работает буфер обмена. На странице установки есть также вкладки Windows и Homebrew.

Amp обновляется сам в фоне. amp update обновляет вручную, amp version показывает установленную версию, amp --help выводит все команды. Автодополнение для оболочки — одна строка, например source <(amp completions zsh) (bash и pwsh тоже поддерживаются; для fish — amp completions fish | source).

Шаг 2: войдите

amp login

amp login открывает браузер и добавляет аккаунт. CLI может хранить несколько: amp account list показывает их, amp account switch <email-or-user-id> выбирает аккаунт для следующих команд, а amp logout удаляет активный (--all удаляет все).

Для скриптов, CI и машин без браузера используйте токен доступа:

export AMP_API_KEY=sgamp_your-token-here

Токен создаётся в настройках на ampcode.com и начинается с sgamp_. Сессионный токен, который сохраняет amp login, истекает меньше чем через час и не обновляется, поэтому здесь CLI его не принимает.

Две необязательные привязки меняют, кто платит за модели:

• Подписка ChatGPT: amp config model-providers add-chatgpt-subscription (или короче amp add-chatgpt-sub) привязывает план ChatGPT, и использование моделей OpenAI идёт в счёт него.
• Подписка Claude: работает только в режиме Claude Code, который выбирается на Dial. Собственные режимы Amp никогда не расходуют ваш план Claude.

Шаг 3: основы CLI

Запустите amp в проекте и пишите. Ввод через pipe становится первым сообщением, так что echo "commit all my changes" | amp тоже работает. Чаще всего вам понадобится Ctrl+O — палитра команд.

Если писать, пока Amp работает, Enter корректирует его курс: сообщение придёт после текущего шага, а не после всего хода. Чтобы поставить сообщение в очередь до завершения работы агента, выполните prompt: queue message из палитры. Shift+Enter добавляет перенос строки в терминалах, которые это поддерживают; Ctrl+J работает везде. В tmux выполните tmux set -s extended-keys on, чтобы заработал Shift+Enter.

Команда ide connect в палитре подключает Amp к VS Code, Cursor, Windsurf, Zed или Neovim (для Neovim нужен плагин). amp config keymap выводит все сочетания клавиш.

Шаг 4: выберите режим на Dial

Amp спрашивает не модель, а режим. Каждый режим — это сочетание модели, уровня рассуждений, системного промпта и инструментов, настроенное под определённую сложность:

Нажмите Ctrl+S до первого сообщения, чтобы повернуть Dial, или откройте палитру и введите mode. Thread сохраняет режим, с которым начался; если выбрали не тот, начните новый thread, а не боритесь с текущим. Слишком высокий режим тратит время и кредиты на простую правку, слишком низкий может обойтись дороже, если понадобится несколько попыток.

Если хотите управлять моделями, в Settings → Mode Dial → Tune Modes можно закрепить модели за каждым режимом и подключить свои API-ключи. Если же вы привыкли выбирать конкретную модель на каждую сессию, мультипровайдерный агент вроде opencode подойдёт лучше.

Шаг 5: субагенты, oracle и librarian

Amp может передавать узкие задачи субагентам, у каждого из которых своё окно контекста:

• Task выполняет делегированную работу от начала до конца и отчитывается. Он может править файлы и запускать команды, а ещё у него есть read-only skills для поиска по коду, изучения другого репозитория, ревью изменений и планирования.
• Read Thread читает и пересказывает другие threads Amp.

Оба работают на той же модели, что и thread, который их запустил. Amp сам подключает их, когда задача подходит, чаще всего в режиме medium, но можно попросить и напрямую: «раздели это между субагентами».

Oracle (ревьюер, который никогда не правит файлы), librarian (клонирует другие репозитории в /tmp и объясняет их) и finder (быстрый поиск по коду) теперь входят в Task. Чтобы запускать их как отдельные инструменты на выбранной модели, установите их как плагины:

amp plugins add @amp/oracle
amp plugins add @amp/librarian
amp plugins add @amp/finder

Шаг 6: настройки

Amp читает два файла настроек, и значения workspace имеют приоритет:

• Пользовательский: ~/.config/amp/settings.json (или .jsonc).
• Workspace: .amp/settings.json в проекте.

amp config edit открывает пользовательский файл, amp config edit --workspace — файл проекта. Все ключи начинаются с amp.:

{
  "$schema": "https://ampcode.com/cli-settings.schema.json",
  "amp.showCosts": true,
  "amp.git.commit.coauthor.enabled": true,
  "amp.notifications.enabled": true
}

• amp.showCosts показывает стоимость каждого thread.
• amp.tools.disable отключает инструменты по имени, поддерживает шаблоны *; amp tools list выводит встроенные инструменты.
• amp.git.commit.ampThread.enabled и amp.git.commit.coauthor.enabled управляют тем, что Amp добавляет в сообщения коммитов, например трейлер Amp-Thread-ID, который связывает коммит с его thread.

Важно знать заранее: по умолчанию Amp не спрашивает подтверждения перед запуском инструментов. Работайте в ветке, почаще коммитьте и используйте amp.tools.disable или плагин, если нужны ограничения. Если вам нужен агент, который по умолчанию сначала спрашивает, Claude Code и Codex CLI построены вокруг запросов на подтверждение.

Skills устроены так же, как у других агентов: папка с файлом SKILL.md. Amp загружает skills проекта из .agents/skills/, личные — из ~/.config/amp/skills/ и ~/.config/agents/skills/, а также из папок Claude Code .claude/skills/ и ~/.claude/skills/.

Шаг 7: AGENTS.md

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

# Project rules

- Package manager: pnpm. Run `pnpm test` before you finish a task.
- TypeScript strict mode; no `any` in new code.
- API handlers live in src/api/; one file per route.
- See @docs/architecture.md for the module layout.

Несколько полезных деталей:

• @-упоминания подтягивают другие файлы: относительные пути, пути @~/ и шаблоны вроде @docs/*.md.
• Личные правила лежат в ~/.config/amp/AGENTS.md (или ~/.config/AGENTS.md).
• Запасной вариант: в папке без AGENTS.md Amp читает AGENT.md или CLAUDE.md, так что проект под Claude Code работает с первого дня.
• Правила с областью действия: упомянутый файл может содержать globs: во front matter, и тогда его указания действуют только при работе с подходящими файлами.

Что писать в этот файл, разобрано в статье как написать CLAUDE.md и AGENTS.md.

Шаг 8: MCP-серверы

MCP-серверы дают Amp новые инструменты: браузер, трекер задач, поиск по документации. Быстрее всего добавить сервер через CLI:

amp mcp add context7 -- npx -y @upstash/context7-mcp
amp mcp add linear https://mcp.linear.app/sse

Оба попадут в настройки в раздел amp.mcpServers. Локальный сервер — это команда, удалённый — URL, а ${VAR} подставляет значения из окружения:

{
  "amp.mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest", "--headless"]
    },
    "linear": {
      "url": "https://mcp.linear.app/sse"
    }
  }
}

Серверы из .amp/settings.json workspace не запускаются, пока вы не одобрите их командой amp mcp approve <name>; amp mcp doctor показывает состояние каждого сервера. Если один и тот же сервер описан в нескольких местах, --mcp-config важнее файла workspace, а тот важнее пользовательских настроек. Каждый сервер добавляет свои инструменты в контекст, поэтому документация советует упаковывать редко используемые серверы в skill (через mcp.json), чтобы их инструменты загружались только вместе со skill.

Шаг 9: threads и режим execute

У каждого thread есть URL вида https://ampcode.com/threads/T-…. amp threads continue T-… продолжает его в терминале, amp threads share T-… --visibility unlisted открывает доступ по ссылке, а @T-… в промпте подключает другой thread как контекст. Threads, начатые вне workspace, приватны.

Для скриптов и CI режим execute выполняет один промпт и завершается:

amp -x "what package manager is used here?"
git diff | amp -x "review this diff for bugs"
amp -ox "Investigate why the latest CI run on main failed"

-x работает на вашей машине и включается сам, когда вывод перенаправлен. -ox выполняет промпт на orb. --stream-json выдаёт машиночитаемый вывод, а --mcp-config добавляет MCP-серверы только для этого запуска.

Сколько стоит Amp (на октябрь 2026 года)

Модели оплачиваются из одного из трёх источников: привязанной подписки ChatGPT или Claude, ваших API-ключей или кредитов Amp. Когда включённое использование заканчивается, вы докупаете кредиты, и Amp списывает их по фактической стоимости моделей и инструментов каждого thread, без наценки на API-цены провайдеров для частных пользователей и workspace без enterprise-договора. Платный тариф для покупки кредитов не нужен. Веб-поиск тоже расходует кредиты. Кредиты сгорают через двенадцать месяцев после покупки, а amp usage показывает баланс. Orbs оплачиваются поминутно и ставятся на паузу при простое; runners на вашей машине бесплатны.

Частые ошибки

• Не тот режим, и Ctrl+S его не меняет. В thread уже есть первое сообщение. Начните новый через Ctrl+C Ctrl+N.
• CI пишет, что вход недействителен. Сессионный токен amp login живёт недолго. Укажите в AMP_API_KEY токен доступа sgamp_.
• MCP-сервер из workspace так и не появляется. Его нужно одобрить: amp mcp approve <name>, затем проверьте через amp mcp doctor.
• План Claude не используется. Его расходует только режим Claude Code; режимы от low до ultra работают через собственную маршрутизацию Amp.
• Amp выполнил неожиданную команду. По умолчанию он не спрашивает. Отключите инструмент или работайте в ветке, которую не жалко выбросить.
• В tmux Shift+Enter отправляет промпт. Включите extended-keys или используйте Ctrl+J.

Amp рядом с другими CLI в AgentVera

У Amp есть своё веб-приложение, десктопное приложение и orbs, и если Amp — ваш единственный агент, этого может хватить. Сложнее становится, когда Amp работает рядом с Claude Code, Codex или Gemini CLI в одном проекте. AgentVera — десктопное приложение, которое запускает эти CLI бок о бок в настоящих терминалах, с вашими собственными установками и входами. Поддержка Amp устроена так:

• Ваш вход в Amp. Amp использует собственный вход на ampcode.com; если вы не вошли, терминал агента попросит войти при первом запуске. В Settings → Accounts → Accounts of other agents можно добавить ещё аккаунты Amp, которые работают на API-ключах, и задать каждому агенту упорядоченный список резервных аккаунтов.
• Один thread на агента. Для каждого агента заранее создаётся новый thread через amp threads new, и при следующих запусках агент возвращается к нему через threads continue.
• Режимы, а не модели. Для каждого агента вы выбираете low, medium, high или ultra, выбор передаётся через --mode.
• MCP и браузер. Серверы, добавленные в менеджере MCP AgentVera, и браузер AgentVera передаются через --mcp-config. У Amp нет флага для дополнительных инструкций, поэтому поле роли агента не используется; вместо него действует ваш AGENTS.md.
• Панели, worktrees, ревью и flows. Запускайте Amp в сетке workspace рядом с другими агентами, каждого в своём git worktree, чтобы они не перезаписывали файлы друг друга. Автоматическое код-ревью проверяет их изменения, а во flows (Pro и Team) Amp может быть агентом-источником или агентом-получателем.

Сетка, worktrees, код-ревью и менеджер MCP доступны на бесплатном плане. Чтобы попробовать, скачайте AgentVera.

Итоги

Чтобы пользоваться Amp, установите CLI, выполните amp login, выберите режим через Ctrl+S и опишите задачу. Начинайте большинство threads в medium, для сложных переходите на high или ultra, а поиск и ревью отдавайте субагентам. Правила проекта держите в AGENTS.md, инструменты — в amp.mcpServers, а для скриптов используйте AMP_API_KEY с amp -x. Amp запускает инструменты без вопросов, поэтому держите его в отдельной ветке — так вы получите максимум от агента, который создан, чтобы сразу браться за дело.