Это руководство по использованию Claude посвящено только Claude Code: от установки до первого запуска, привязки API Key, переключения аккаунта, а также подписок и диагностики распространённых ошибок. Следуйте шагам — и вы сможете запустить Claude Code в локальном терминале. Команды подходят для Windows/macOS/Linux; я постарался заранее указать типичные «подводные камни», чтобы вы меньше блуждали.
1) Установка Claude Code: подготовка окружения и первый запуск
Claude Code зависит от Node.js; рекомендуется сначала установить Node.js версии 18 и выше и убедиться, что в терминале доступен npm. Затем выполните глобальную установку:
npm install -g @anthropic-ai/claude-code
После установки проверьте, выводится ли номер версии, командой
claude --version
.
При первом запуске Claude Code обычно предлагает настроить Anthropic API Key. Вы также можете заранее задать в системе переменную окружения ANTHROPIC_API_KEY и затем запускать Claude Code — так не придётся вводить ключ повторно.
2) Привязка и переключение аккаунта: управлять через API Key проще всего
Суть «входа» в Claude Code — привязка API Key: один ключ соответствует одному источнику биллинга и прав доступа. Если нужно переключить аккаунт, самый надёжный способ — заменить ANTHROPIC_API_KEY (или подменить ключ в конфигурационном файле, который Claude Code создаёт при первом запуске; точный путь будет показан при инициализации).
Если вы переключаетесь между рабочим и личным аккаунтами, рекомендуется задавать переменные окружения отдельно для разных сессий терминала, чтобы не «зашивать» ключ в глобальную конфигурацию и снизить риск ошибочного использования и утечки.
3) Различия тарифов и как экономить: выбирайте по сценарию использования
У Claude распространены подписки Pro и Max (цены и преимущества могут меняться по решению сервиса); они больше подходят для частых диалогов в веб-версии. А для Claude Code основные расходы чаще всего идут от объёма API-вызовов. Для разработчиков обычно выгоднее сделать крупные задачи за один‑два дня, а в остальное время вносить лишь небольшие правки — так выходит дешевле, чем «держать высокий объём постоянно».
Если пользователи в Китае сталкиваются с ограничениями по оплате или сети, в первую очередь выбирайте легальные каналы оплаты API или корпоративный/командный единый расчёт; не рекомендуется использовать ключи неизвестного происхождения — легко попасть под риск-контроль, из‑за чего Claude Code может прерваться на середине работы.
4) Частые вопросы и диагностика ошибок: неудачная подписка, ошибки запросов, блокировка аккаунта
Сбой оформления подписки чаще всего связан с несоответствием способа оплаты, региона или платёжных данных: сначала проверьте 3DS‑подтверждение карты, платёжный адрес и поддержку валюты; если вы используете только Claude Code, уточните, нужна ли вам вообще подписка, или достаточно действующего API Key и доступного лимита.
Ошибки запросов (например, таймаут/обрыв) обычно вызваны нестабильной сетью, слишком высокой параллельностью или слишком длинным контекстом. Рекомендуемый порядок действий: перейти на более стабильную сеть → уменьшить объём ввода и размах изменений за один раз → выполнять действия в Claude Code по шагам (сначала анализ, затем правки, затем тест).
При блокировке аккаунта или недействительности ключа сначала проверьте в консоли, не был ли ключ отозван, не исчерпана ли квота и не сработали ли подозрительные вызовы. После замены на новый API Key перезапуск Claude Code обычно восстанавливает работу; если ошибки сохраняются, дополнительно проверьте локальный прокси/перехват сертификатов и корректность системного времени.
