Claude Code в России: установка и подключение API

Claude Code помогает работать с проектом прямо из терминала: изучать код, вносить изменения и запускать проверки. Установка программы и доступ к модели — два отдельных шага. Если команда claude запускается, это ещё не означает, что настроены оплата и авторизация.

Ниже — короткий маршрут для локального CLI. Для облачных сессий, расширений редакторов и корпоративных установок настройки могут отличаться.

Сначала выберите, откуда будет списываться оплата

Способ	Что потребуется	Где проверять расход
Вход в аккаунт Claude	Подходящий план и доступный аккаунт	В настройках подписки Claude
Прямой API Anthropic	Аккаунт Console, ключ и API-биллинг	В Claude Console
API Клодыча	Ключ Клодыча, баланс, адрес шлюза	В разделе API Клодыча

Подписка и API не складываются в один общий безлимит. Выбирая шлюз, вы оплачиваете запросы через него. Условия официального аккаунта и региональная доступность от этого не меняются. Разница продуктов подробно разобрана в сравнении Pro и API.

Установка на Windows, macOS и Linux

У Claude Code есть нативная установка. Node.js не является обязательным условием для этого способа. Проверено по инструкции Anthropic 24 сентября 2026 года.

Windows: через WinGet

Откройте PowerShell:

winget install Anthropic.ClaudeCode

После установки откройте новый терминал. WSL для нативного запуска не требуется. Git for Windows пригодится, если в работе нужен Bash; текущая версия также поддерживает PowerShell. Обновление установленной через WinGet программы:

winget upgrade Anthropic.ClaudeCode

macOS: через Homebrew

brew install --cask claude-code

Для обновления используйте brew upgrade claude-code.

Linux: официальный установщик

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

Эта команда загружает и запускает официальный скрипт. Альтернативные способы и требования для конкретного дистрибутива перечислены в инструкции Anthropic выше.

Во всех случаях проверьте результат:

claude --version
claude doctor

Подключение через Клодыча

Откройте бота Клодыча, нажмите «Запустить», затем создайте ключ в разделе API. Перед первым платным запросом пополните баланс и задайте подходящий лимит ключа.

Настройки CLI можно сохранить в пользовательский файл:

Система	Файл
macOS и Linux	~/.claude/settings.json
Windows	%USERPROFILE%\.claude\settings.json

Если файл уже есть, добавьте нужные поля в существующий env. Не заменяйте им свои остальные настройки.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://app.claudich.dev",
    "ANTHROPIC_AUTH_TOKEN": "ВАШ_КЛЮЧ_CLAUDICH",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-sonnet-5.5"
  },
  "model": "claude-sonnet-5.5"
}

В ANTHROPIC_BASE_URL здесь нет /v1. CLI добавляет путь запроса сам, как и Anthropic SDK. Адрес с /v1 нужен OpenAI-совместимым клиентам. Пустой ANTHROPIC_API_KEY исключает случайное использование ранее сохранённого ключа в этой конфигурации.

Доступные модели и готовый пример настроек проверьте в разделе Claude Code. Если выбираете другую модель для основного агента или помощников, её идентификатор должен быть доступен у вашего поставщика.

Не сохраняйте секрет в общем .claude/settings.json репозитория. Для настроек отдельного проекта используйте локальный файл, исключённый из Git. Официальные правила подключения описаны в руководстве по шлюзам.

Первый запуск: одна маленькая задача

Перейдите в папку проекта и запустите claude. Затем выполните /status: в параметрах подключения должен быть адрес Клодыча и источник вашего токена.

Для проверки подойдёт такой запрос:

Посмотри README и структуру верхнего уровня. В пяти пунктах объясни, как запустить проект. Пока не меняй файлы и не устанавливай зависимости.

Он проверит, что агент читает рабочую папку и получает ответы, без большого рефакторинга. После ответа откройте историю API в Клодыче и убедитесь, что запрос появился именно там. Это практическая проверка того, какой баланс используется.

Частые проблемы при подключении

Симптом	Проверка
claude не найдена	Откройте новый терминал и проверьте установку и PATH
Открылся вход в другой аккаунт	Посмотрите /status, действующие переменные и настройки пользователя
401	Проверьте ключ и его активность, адрес сервера и отсутствие пробелов
404 на запрос	Проверьте модель и отсутствие лишнего /v1 в адресе CLI
402	Проверьте баланс и лимит ключа
429	Уменьшите число одновременных агентов, дождитесь разрешённого повтора
Обычный текст работает, отдельный инструмент — нет	Сохраните ошибку, версию CLI и ID запроса; поддержка функции зависит от всей цепочки подключения

Шлюз должен поддерживать функции, которые вызывает клиент. Наличие Anthropic-совместимого формата само по себе не подтверждает совместимость каждого нового инструмента, PDF-режима или beta-возможности. Сложный сценарий сначала проверьте на небольшом примере.

Как работать без лишнего расхода

Начинайте с конкретной задачи и критерия результата: «исправь ошибку и прогони такой-то тест» понятнее, чем «улучши весь проект». Для новой независимой задачи создавайте новую сессию, а важные договорённости переносите в краткую заметку.

Отдельно следите за помощниками и повторными попытками. Один пользовательский запрос способен запустить несколько обращений к модели. Ограничение ключа полезно, но не заменяет наблюдение за текущей работой. Практические приёмы собраны в руководстве по расходам API.

Следующий шаг — получить ключ и проверить одну задачу. Откройте Клодыча в Telegram, нажмите «Запустить» и перейдите в API. Тарифы помогут выбрать модель до большого запуска.