01｜Быстрый старт и настройка подключения Claude Code к Crazyrouter

01｜Быстрый старт и настройка Claude Code для подключения к Crazyrouter#

Это первая статья серии Crazyrouter о Claude Code. В ней рассматривается тема «Быстрый старт и настройка Claude Code для подключения к Crazyrouter», с акцентом на первоначальную настройку и запуск Claude Code.

Единый подход к точкам подключения: для Claude Code и нативных клиентов Anthropic используйте ANTHROPIC_BASE_URL=https://cn.crazyrouter.com; для OpenAI-совместимых SDK, HTTP-запросов, frontend- и backend-приложений используйте base_url=https://cn.crazyrouter.com/v1.

Что вы найдете в этой статье#

• Для кого: для разработчиков, которые уже используют Claude Code, планируют подключить китайские модели или хотят унифицировать вызовы в команде через Crazyrouter.
• Чему вы научитесь: как настроить переменные окружения по документации Crazyrouter, организовать рабочий процесс и избежать ошибки с Base URL, из-за которой появляется путь вида /v1/v1/....
• Что рекомендуется подготовить: сначала создайте отдельный API Token в консоли Crazyrouter, затем выполните базовую настройку по документации подключения Claude Code.

Быстрый старт и настройка Claude Code#

Установка Claude Code#

Система должна соответствовать следующим минимальным требованиям:

Операционная система: Linux(Ubuntu 18.04+, CentOS 7+) macOS 10.15+, Windows 10+

Сетевое подключение: стабильное подключение к интернету

Место на диске: не менее 500MB свободного дискового пространства

Установка Node.js#

Перед началом установки проверьте версии Node.js и npm:

node --version
npm --version

Если Node.js еще не установлен на вашем компьютере, рекомендуется установить Node.js 18 LTS или более новую версию:

• Страница загрузки: официальный сайт Node.js
• Документация по установке: официальная документация Node.js

Установка Git#

Перед началом установки проверьте версию Git:

git --version

Если Git еще не установлен на вашем компьютере, выберите способ установки в зависимости от системы:

• Страница загрузки: официальный сайт Git
• Документация по установке: официальная документация Git

Установка в Linux /macOS#

# Глобальная установка Claude Code
sudo npm install -g @anthropic-ai/claude-code

# Проверка установки
claude --version

Установка в Windows#

# Откройте Powershell или командную строку от имени администратора

# Глобальная установка
npm install -g @anthropic-ai/claude-code

# Проверка установки
claude --version

Настройка Crazyrouter API Key#

При подключении Claude Code к Crazyrouter в первую очередь настройте ANTHROPIC_BASE_URL и ANTHROPIC_API_KEY. Обычно нет необходимости указывать в статье пустой адрес прокси.

Windows PowerShell:

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://cn.crazyrouter.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "YOUR_CRAZYROUTER_API_KEY", "User")

macOS / Linux:

export ANTHROPIC_BASE_URL=https://cn.crazyrouter.com
export ANTHROPIC_API_KEY=YOUR_CRAZYROUTER_API_KEY

Если вы хотите, чтобы скрипт автоматически проверил Git, Node.js и Claude Code, можно воспользоваться скриптом быстрой настройки Crazyrouter Claude Code.

Запуск claude code из консоли#

Введите в терминале: claude. После этого нужно войти в claude и пройти аутентификацию с помощью Crazyrouter Token.

1. Базовые операции: команды и конфигурация как точка старта#

Разберитесь с командами справки и откройте все возможности#

Хотите быстро начать? Начните с claude --help. Эта команда покажет все доступные параметры и команды: например, -p для неинтерактивного вывода, -c для продолжения последнего диалога, --model для выбора модели и т. д. Если запомнить часто используемые параметры, работать станет заметно быстрее: например, можно использовать claude -r, чтобы восстановить предыдущую сессию, или --output-format json, чтобы экспортировать структурированный результат.

Бесшовная интеграция с IDE: пишите код без переключения окон#

Чтобы использовать Claude Code в VS Code, Cursor и других IDE, достаточно двух шагов:#

• Установите расширение: найдите “Claude Code”, выберите официальную версию от Anthropic и нажмите установку.

• Быстрый запуск: вызовите его сочетанием клавиш Cmd+Escape (можно настроить) или нажмите значок Claude Code в интерфейсе IDE. Справа сразу откроется рабочая область: она поддерживает автоматическую передачу выделенного кода в контекст, сравнение изменений через diff и даже отправку выделенного фрагмента в поле промпта одним нажатием Alt+Cmd+K.

2. Основные режимы: переключайтесь по ситуации и работайте максимально эффективно#

Режим автоматического редактирования: пакетные операции без подтверждений#

Подходит для создания и изменения файлов, когда не требуется подтверждать каждое действие. Нажмите Shift+Tab один раз, чтобы включить этот режим. После этого Claude будет автоматически выполнять операции редактирования без ручного подтверждения. Например, если написать «создай эффектное приложение todolist», он сразу сгенерирует и изменит файлы, избавляя от необходимости постоянно подтверждать действия.

Plan Mode: мощный инструмент для предварительного планирования#

Когда нужно создать проект или решить сложную задачу, нажмите Shift+Tab дважды, чтобы включить Plan Mode. Сначала он разложит решение по структуре: например, для запроса «todolist для мобильных устройств в пиксельном стиле» автоматически спланирует технологический стек, структуру страниц, подход к адаптации и т. п., а уже после подтверждения приступит к реализации. Если план не устраивает, можно прямо сказать «перепланируй», пока результат не будет соответствовать ожиданиям.

Yolo Mode: полный доступ — пусть делает сам#

При рефакторинге кода, запуске нового проекта или исправлении сложного bug используйте claude --dangerously-skip-permissions, чтобы войти в Yolo Mode. В этом режиме Claude получает более широкие права и может напрямую выполнять больше операций (учитывайте безопасность; рекомендуется использовать в песочнице). После входа в режим по-прежнему можно менять режимы через Shift+Tab, гибко настраивая уровень разрешений.

claude --dangerously-skip-permissions

3. CLAUDE.md: ядро глобальной памяти#

При общении с чат-ботами мы знаем, что «системный промпт» очень важен и постоянно влияет на поведение AI. В CC файл CLAUDE.md занимает похожее место. Типичный рабочий процесс выглядит так:

Создать начальный CLAUDE.md → вести диалог, пока длина не приблизится к переполнению, выполнить /compact, чтобы продлить сессию → при достижении вехи попросить CC обновить CLAUDE.md с учетом прогресса → повторять цикл до завершения

То есть CLAUDE.md — это по сути глобальная переменная, которая действует на протяжении всей работы. Кроме того, когда CC записывает туда информацию, он обычно хорошо ее сжимает, поэтому файл остается удобочитаемым.

Что учитывать при работе с CLAUDE.md

• Файл не должен быть слишком длинным: CC по умолчанию читает его.
• Во время сессии для краткости можно говорить claude.md — CC тоже поймет.
• В файл удобно помещать напоминания, например: «требовать от CC каждый раз при объявлении успеха прикладывать ссылку на файл с доказательствами» и «порт прокси-сервиса — 9890». Затем в диалоге можно попросить CC: «найди соответствующий раздел в claude.md».
• Официальная команда добавления # в документацию, по словам GPT, содержит нестабильный bug.

4. Управление сессией: избегать потери контроля и двигаться эффективно#

Пауза и откат в любой момент#

• Во время работы нажмите Esc, чтобы приостановить текущую операцию. Например, если установка зависимостей в Claude зависла по тайм-ауту или ход рассуждений ушел не туда, своевременное прерывание сократит бесполезные действия.
• Двойное нажатие Esc откатывает к историческому узлу диалога (обратите внимание: redo нет, поэтому перед откатом убедитесь, что это действительно нужно).
• Не нравится код? Просто скажите: «откатись к предыдущей версии кода» — Claude автоматически восстановит прошлую версию.

Что делать при переполнении истории#

Когда в сессии появляется подсказка Context left until auto-compact: 3%, это означает, что история почти заполнена. В этот момент автоматически запускается сжатие (примерно 150 секунд). Также можно вручную использовать команду /compact, чтобы продлить сессию и избежать обрыва диалога.#

Восстановление и просмотр истории#

• Используйте claude -c, чтобы сразу войти в прошлый диалог;
• Используйте claude -r, чтобы выбрать и восстановить историческую сессию — удобно, если вы вышли в середине работы и хотите продолжить.

5. Мониторинг ресурсов и пакетные задачи: контролировать темп и не тратить лишнее#

Мониторинг расхода token в реальном времени#

Хотите понять, сколько ресурсов расходуется в день или в час? Запустите npx ccusage@latest, чтобы посмотреть дневную статистику, или npx ccusage blocks --live, чтобы отслеживать скорость расхода в реальном времени. Если расход слишком быстрый, можно вручную выполнять операции вроде git commit, которые тратят много token, и избежать превышения лимитов.

npx ccusage@latest

Эффективная обработка пакетных задач#

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

1. Запишите задачи построчно в TASK.md — одна строка, одна задача;
2. Выполните команду:

cat TASK.md | while IFS= read -r line; do echo $line; claude -p "$line" --debug; done

Можно добавить timeout, чтобы отдельная задача не зависала навсегда, и использовать --allowedTools "Edit", чтобы ограничить права и избежать неожиданных действий. Важно: не запускайте задачи параллельно, иначе можно сработать на лимиты и получить блокировку.

6. Подводные камни и продвинутые приемы: сделать Claude более «послушным»#

Давайте достаточно свободы, но не забывайте о защите#

• Включите auto-accept edits — переключается через Shift+Tab, — чтобы Claude автоматически редактировал файлы. В сочетании с git-контролем версий ошибочные действия не страшны.
• При выполнении Bash-команд изолируйте окружение через Docker или используйте снимки файловой системы btrfs. Так можно дать больше прав и при этом быстро откатиться.
• Не храните в каталоге сессии ssh key и другую чувствительную информацию, чтобы снизить риски операций между машинами.

Жестко предотвращайте «фиктивные результаты»#

Claude иногда может «хвастаться», например заявить об успехе, не завершив тесты. Добавьте в CLAUDE.md правило: «каждое заявление об успехе должно сопровождаться ссылкой на файл с доказательствами», а также периодически уточняйте: «действительно завершено? есть доказательства?» Если обнаружится проблема, сразу попросите исправить.

Освоив эти приемы, можно превратить Claude Code из «инструмента» в «эффективного напарника». Будь то повседневное программирование, управление проектами или пакетная обработка, эффективность заметно вырастет. Главное — переключать режимы по потребности, правильно использовать глобальную память и добавить разумный мониторинг и защиту. Тогда Claude Code сможет раскрыть максимум пользы.

Похожие материалы#

• Следующая статья: статья 02
• Документация по настройке: подключение Claude Code к Crazyrouter
• Описание API-адресов: Base URL и использование /v1
• Скрипт настройки в один клик: скрипт настройки Crazyrouter Claude Code в один клик

Начать подключение к Crazyrouter#

Если вы планируете подключить Claude Code, отечественные модели или собственные приложения к Crazyrouter через единую точку входа, двигайтесь в таком порядке:

1. Перейдите в консоль Crazyrouter, создайте отдельный API Token и управляйте правами отдельно по проектам или командам.
2. Для Claude Code используйте корневой домен: https://cn.crazyrouter.com; для OpenAI-совместимого SDK используйте: https://cn.crazyrouter.com/v1.
3. Если нужно автоматически проверить окружение или быстро записать конфигурацию, используйте скрипт настройки Crazyrouter Claude Code в один клик.
4. При ошибках отладки сначала проверьте логи в консоли, затем сверяйтесь с описанием API Endpoint. Особое внимание уделите тому, не добавлен ли лишний /v1 в Base URL.

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