Claude Code: агент, который живёт в терминале (и не только)

Что это простыми словами

Это не «чат про код». Это рабочий, которому вы даёте задачу в проекте, а он сам открывает файлы, пишет патчи, гоняет тесты и спрашивает разрешение на опасные шаги.

Где можно запускать

Одни и те же CLAUDE.md, settings и MCP обычно работают across поверхностей.

Установка CLI

Windows PowerShell

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

macOS / Linux / WSL

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

1. Откройте новый терминал.
2. Проверьте: claude --version.
3. Зайдите в проект: cd ваш-проект.
4. Запустите: claude и залогиньтесь.

Альтернативы: Homebrew (brew install --cask claude-code), WinGet (winget install Anthropic.ClaudeCode).

Карта интерфейса CLI

• Пишете задачу обычным текстом.
• Claude показывает, какие инструменты вызывает (чтение, правка, shell…).
• На опасных действиях просит разрешение (пока вы не настроили allowlist).
• Slash‑команды вроде /help, /compact, skills как /deploy.

Первая задача «для дебилов»

1. cd в папку проекта.
2. Запустите claude.
3. Скажите: «Объясни структуру проекта за 10 буллетов. Ничего не меняй.»
4. Потом: «Найди TODO и предложи план. Пока без правок.»
5. Только потом: «Сделай пункт 1 из плана. Запусти проверку.»

Бесплатные и сторонние модели: можно ли «халявно»?

Короткий ответ: да, Claude Code можно направить не на Anthropic, а на gateway/локальный сервер с Anthropic‑совместимым API. Тогда вы платите (или не платите) тому, кто отдаёт модель — OpenRouter, Ollama, свой прокси.

Три реалистичных бесплатных пути

Как Claude Code вообще понимает «чужую» модель

Он шлёт запросы на адрес из ANTHROPIC_BASE_URL. Если там OpenRouter/Ollama с Anthropic‑compatible API — «думает», что говорит с Anthropic.

• ANTHROPIC_BASE_URL — куда стучаться
• ANTHROPIC_AUTH_TOKEN — Bearer‑токен gateway (ключ OpenRouter / ollama / …)
• ANTHROPIC_API_KEY="" — обязательно пустая строка, иначе Claude Code может уйти на настоящий Anthropic

Пока активен gateway‑credential, запросы идут не с вашей подписки claude.ai. Подписка Anthropic в этот момент не «кормит» сессию.

Вариант A — OpenRouter и бесплатные модели

1. Зарегистрируйтесь на openrouter.ai и создайте API key.
2. Поставьте Claude Code (как в разделе установки).
3. Задайте переменные окружения (см. ниже).
4. Внутри Claude Code один раз выполните /logout, если раньше логинились в Anthropic — иначе будет конфликт auth.
5. Запустите claude и проверьте /status: base URL должен быть https://openrouter.ai/api.

Windows PowerShell (текущее окно)

$env:OPENROUTER_API_KEY="sk-or-v1-ВАШ_КЛЮЧ"
$env:ANTHROPIC_BASE_URL="https://openrouter.ai/api"
$env:ANTHROPIC_AUTH_TOKEN=$env:OPENROUTER_API_KEY
# важно: ключ должен быть именно пустой строкой
$env:ANTHROPIC_API_KEY=""
$env:ANTHROPIC_MODEL="openrouter/free"
claude

macOS / Linux

export OPENROUTER_API_KEY="sk-or-v1-ВАШ_КЛЮЧ"
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY=""
export ANTHROPIC_MODEL="openrouter/free"
# опционально: показать picker моделей gateway
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
claude

Навсегда для одного проекта (удобно)

Файл .claude/settings.local.json в корне проекта (в git обычно не коммитят — там ключ):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "sk-or-v1-ВАШ_КЛЮЧ",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_MODEL": "openrouter/free",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

Какие free‑модели брать

Список на OpenRouter меняется. Ищите модели с суффиксом :free и с поддержкой tools / function calling — без tool‑use агент почти бесполезен.

Закрепить конкретную модель:

# пример: подставьте актуальный ID из каталога OpenRouter
export ANTHROPIC_MODEL="qwen/qwen3-coder:free"
# или внутри сессии / через --model, если поддерживается вашей версией
claude --model "qwen/qwen3-coder:free"

Лимиты OpenRouter free (ориентир)

• Без купленных кредитов: порядка 50 запросов/день, ~20 RPM
• После покупки кредитов от ~$10: лимит free часто растёт до ~1000 req/день (даже если баланс потом сядет — уточняйте актуальные правила в кабинете OpenRouter)
• Неудачные/429 запросы тоже могут съедать квоту
• Очереди и «модель недоступна» на пике — нормальная боль free‑тира

Вариант B — Ollama локально (по‑настоящему бесплатно)

1. Установите Ollama.
2. Скачайте модель с tool‑calling, например: ollama pull qwen3.5 (имя модели сверяйте с актуальным каталогом Ollama).
3. Выставьте контекст 64k+ в настройках Ollama — короткий контекст = агент «забывает» середину задачи.
4. Самый простой старт: ollama launch claude — поднимет Claude Code уже с нужными env.

Ручная настройка

# PowerShell
$env:ANTHROPIC_AUTH_TOKEN="ollama"
$env:ANTHROPIC_BASE_URL="http://localhost:11434"
$env:ANTHROPIC_API_KEY=""
claude --model qwen3.5

# bash
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
export ANTHROPIC_BASE_URL=http://localhost:11434
claude --model qwen3.5

Вариант C — Ollama Cloud

Без локальной установки модели: ключ OLLAMA_API_KEY, base URL https://ollama.com, модель с tool support (пример из доков Ollama: glm-5.3-flash / cloud‑варианты).

ANTHROPIC_BASE_URL=https://ollama.com \
ANTHROPIC_AUTH_TOKEN="$OLLAMA_API_KEY" \
ANTHROPIC_API_KEY="" \
claude --model glm-5.3-flash

Бесплатный план обычно даёт стартовые кредиты на меньшие cloud‑модели; крупные — уже платные. Hosted web search и часть advanced tool controls через cloud могут быть ограничены.

Как проверить, что реально пошло на free‑gateway

1. В сессии: /status → Auth token = ANTHROPIC_AUTH_TOKEN, Base URL = ваш gateway.
2. На OpenRouter откройте Activity Dashboard — должны появиться запросы.
3. Если видите Login method = Claude account или base URL Anthropic — env не подхватились: новый терминал, снова /logout, проверьте что ANTHROPIC_API_KEY пустой.

Что выбрать новичку

OmniRoute + Kiro: гайд по видео (Windows)

Разбор ролика YouTube: как запустить Claude Code бесплатно. Идея: локальный роутер OmniRoute собирает бесплатные лимиты разных провайдеров; в видео берут Kiro AI (Claude Sonnet / Haiku) и подсовывают endpoint в Claude Code.

Шаг 1. Node.js именно 22

OmniRoute чувствителен к версии Node. В ролике: если стоит 24+ — удалить и поставить 22.x с nodejs.org (Windows Installer).

node -v
# нужно что-то вроде v22.x.x

Шаг 2. Установить OmniRoute

npm install -g omniroute
omniroute

Откроется дашборд (обычно http://localhost:20128). Пока OmniRoute не запущен — Claude Code через него работать не будет.

Шаг 3. Подключить Kiro AI

1. В дашборде → Providers → Kiro AI.
2. Add connection → способ Builder ID (как в видео) / Google / GitHub — по актуальному UI.
3. Авторизуйтесь, подтвердите доступ.
4. В карточке провайдера появятся модели вроде kr/claude-sonnet-4.5, kr/claude-haiku-4.5 (ID сверяйте в UI — версии меняются).

Шаг 4. Создать API‑ключ OmniRoute

1. Вкладка API Manager → Create key.
2. Дайте имя (в видео: код / claude).
3. Сразу скопируйте ключ в надёжное место. Полный ключ показывают один раз — потом не восстановить, только пересоздать.
4. В Endpoints посмотрите base URL. Для Claude Code берите корень http://localhost:20128 (без /v1).

Шаг 5. Claude Code

winget install Anthropic.ClaudeCode
# или как в разделе установки выше

Способ А (рекомендуем) — без батников

Современный OmniRoute умеет сам подставить env:

# 1) в одном окне крутится omniroute
omniroute

# 2) в другом:
omniroute launch
# или сразу с моделью / профилем:
omniroute setup-claude
omniroute launch --profile <имя-профиля>

omniroute launch сам проставит ANTHROPIC_BASE_URL, токен, сделает health‑check и запустит claude.

Способ B — как в видео: bat‑файл на Windows

Создайте файл, например C:\bat\freeclaude.bat (ключ и model id подставьте свои):

@echo off
REM Запуск OmniRoute в новом окне, если ещё не поднят
start "OmniRoute" cmd /k omniroute

REM Ждём, пока endpoint оживёт
:wait
curl -sf http://localhost:20128/health >NUL 2>&1
if errorlevel 1 (
  timeout /t 2 /nobreak >NUL
  goto wait
)

set ANTHROPIC_BASE_URL=http://localhost:20128
set ANTHROPIC_AUTH_TOKEN=ВАШ_КЛЮЧ_ИЗ_OMNIROUTE
set ANTHROPIC_API_KEY=
set ANTHROPIC_MODEL=kr/claude-sonnet-4.5

claude
pause

Способ C — settings.local.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:20128",
    "ANTHROPIC_AUTH_TOKEN": "ВАШ_КЛЮЧ_ИЗ_OMNIROUTE",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_MODEL": "kr/claude-sonnet-4.5",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

Файл: .claude/settings.local.json в проекте. OmniRoute при этом всё равно должен быть запущен.

Проверка

1. Запущен ли OmniRoute (дашборд открывается).
2. В Claude Code: /status → base URL http://localhost:20128, auth = token.
3. Напишите «привет» — в ответе/статусе должна светиться модель Kiro (kr/…).
4. Дайте мелкую задачу (todo‑list), как в видео — убедитесь, что tool‑use живой.

Что ещё можно подключить в OmniRoute

Теоретически — десятки free‑тира провайдеров (Gemini CLI, Antigravity, Copilot и т.д.), и роутер делает fallback, когда один лимит кончился. В дашборде смотрите Free Tiers / ToS‑метки: часть провайдеров помечена tos: avoid и по умолчанию не идёт в auto‑route.

Replica: клонируем приложения через Claude (разбор Shorts)

Разбор ролика YouTube Shorts: «Клонируй любое приложение с Claude…». Речь про бесплатный набор skills Replica (Jakeschincariol/replica-skill) — 11 навыков, которые по очереди изучают чужое приложение, собирают вашу версию, ищут баги и даже читают отзывы пользователей, чтобы сделать продукт «лучше оригинала».

Что нужно

• Claude Code (или Claude с поддержкой skills / Desktop).
• Python 3.8+ для хелпер‑скриптов (pip‑зависимости не нужны — только стандартная библиотека).
• Нормальный тариф Claude для агентной работы (на free‑лимитах весь пайплайн тяжеловат).
• Публичные источники: сайт, стор, скрины, ваш аккаунт в приложении. Не обход paywall и не взлом.

Установка — 3 способа

1) Как в шортсе: «вставь ссылку + install skill»

https://github.com/Jakeschincariol/replica-skill

install skill

Вставьте это в Claude Code / Claude. Перед Approve читайте, что агент собирается копировать/ставить.

2) Плагин Claude Code (удобно)

/plugin marketplace add Jakeschincariol/replica-skill
/plugin install replica-skill@replica-skill

Команды будут с префиксом: /replica-skill:replica-recon и т.д. Если не появились — /reload-plugins или перезапуск.

3) Короткие имена /replica-recon — копирование папок

git clone https://github.com/Jakeschincariol/replica-skill.git

# macOS / Linux — глобально:
cp -r replica-skill/replica-* ~/.claude/skills/

# Windows PowerShell — глобально:
Copy-Item -Recurse .\replica-skill\replica-* "$env:USERPROFILE\.claude\skills\"

Только для одного проекта: копируйте те же папки в .claude/skills/ внутри репозитория.

Перед установкой — быстрый security‑чек

Репозиторий относительно новый; скрипты крутятся на вашей машине. Имеет смысл один раз спросить Claude:

Прочитай все файлы репозитория replica-skill. Для каждого .py скажи:
что читает/пишет, есть ли сеть, удаление файлов, shell. Сравни с README.

Ожидаемые утилиты (без сети, stdlib): imgdiff.py, parity.py, reviews.py, contrast.py, sweep.py, listing.py.

Все 11 skills — что делает каждый

Правильный порядок (пайплайн)

Skills читают артефакты предыдущего шага из replica/. Не прыгайте сразу в build.

1. recon — изучить публичное приложение.
2. architect — спланировать стек и данные.
3. design — своя дизайн‑система (не 1:1 чужой бренд).
4. build — собрать экраны.
5. backend — auth / payments / данные.
6. test — прокликать флоу.
7. diff — score «насколько близко к фичам оригинала».
8. entrepreneur — улучшить по отзывам (можно и раньше, как исследование рынка).
9. brand → launch → deploy — своё имя, лендинг, прод.

recon → architect → design → build → backend → test → diff → entrepreneur → brand → launch → deploy

Практический старт (пошагово)

1. Создайте пустую папку проекта и откройте в ней Claude Code.
2. Поставьте Replica (плагин или копирование skills).
3. Запустите разведку:
   /replica-recon https://пример-приложения.com
   (или URL стора / приложите скрины).
4. Дождитесь файлов в replica/ — это «карта» продукта.
5. Дальше по цепочке: /replica-architect, потом design/build…
6. После сборки: /replica-test и /replica-diff.
7. Соберите CSV/файл отзывов (App Store, G2, Reddit…) и гоните /replica-entrepreneur — в примере из гайдов skill разбирал сотни отзывов и ранжировал жалобы.
8. Перебрендируйте и деплойте только после sweep‑проверки, что имя оригинала не торчит в коде/листинге.

Entrepreneur подробнее (самый сильный skill из ролика)

Можно гонять entrepreneur отдельно, ещё до клона — как дешёвый market research: «стоит ли вообще делать конкурента».

Ожидания без розовых очков

• Это не волшебная «1:1 копия любого SaaS за 5 минут». Сложный продукт = много итераций, ручная проверка, свои ключи API.
• Parity‑score 80–90% по фичам ≠ готовый бизнес.
• Платежи, антифрод, модерация, compliance — на вас.
• Шортс упрощает; рабочий путь — пайплайн выше + юридическая гигиена.

Связка с остальным гайдом

CLAUDE.md — мозг проекта

Файл в корне (и/или в ~/.claude), который подгружается в каждую сессию. Сюда пишите:

• стек и команды запуска/тестов;
• «всегда / никогда»;
• архитектурные запреты;
• как оформлять коммиты.

Если в репо уже есть AGENTS.md, Claude Code может читать его вместо/вместе с CLAUDE.md.

Skills — ваши команды‑рецепты

Skill = markdown‑воркфлоу, который вызывается как /имя или подтягивается сам, когда релевантен.

• Примеры: /review-pr, /deploy-staging, «как у нас пишут миграции»
• Могут выполняться в текущем чате или в изолированном subagent‑контексте

Если копируете один и тот же промпт из Notion — это уже skill.

Hooks — железобетонная автоматизация

Hooks срабатывают на события жизненного цикла (до/после tool use и т.д.). В отличие от «попроси ИИ не забыть», hook всегда выполняется.

Subagents и параллельная работа

Subagent — отдельный цикл с изолированным контекстом. Лидер‑агент раздаёт подзадачи и собирает summary.

• Исследование большого кода без засорения основного чата
• Параллельный аудит / ревью
• Dynamic workflows — скрипты, которые гоняют много subagents

MCP в Claude Code

Подключайте Jira, Slack, БД, браузер, внутренние API. Конфиг проекта часто в .mcp.json.

Примеры задач: «возьми тикет ENG‑4521 и сделай PR», «посмотри ошибки в Sentry», «обнови шаблон по макету из Figma/Slack».

Права, allowlist, безопасность

• Настраивайте permissions в settings: что можно без спроса.
• Держите секреты в env, не в чате.
• Для CI используйте отдельные ключи с узкими правами.
• Code intelligence / LSP помогает точнее прыгать по символам в больших typed‑кодовых базах.

Автоматизация и «работа из любой точки»

Скрытые и мощные штуки

Ошибки новичков

• Запуск не из корня проекта → агент не видит структуру.
• Нет CLAUDE.md → каждый раз заново про «мы на pnpm».
• Слишком широкие permissions «разрешить всё».
• Просят гигантский рефактор одним сообщением без плана.
• Игнорируют hook/lint ошибки в логе tool call.
• Ждут «бесплатный Opus» через OpenRouter — free‑модели слабее и с лимитами; агент быстро упирается в 50 req/день.
• Оставляют старый ANTHROPIC_API_KEY в профиле shell → сессия уезжает не на тот backend.

Шпаргалка

Сравните с Cursor: детальное сравнение.