IDE и клиенты

Claude Code CLI

Официальный CLI-агент Anthropic через tkbk.io: установка, переменные окружения, settings.json, проверка и разбор ошибок 401/404/timeout.

Обновлено 24 июл. 2026 г.7 мин
#claude code#cli#anthropic#terminal#agent#windows

Claude Code — агент Anthropic в терминале: читает проект, правит файлы, запускает команды. Через tkbk.io он ходит в наш шлюз в Москве — на стороне клиента ничего настраивать не нужно, кроме двух переменных окружения.

Что получится
Рабочий claude в терминале с моделями Opus 5 / Sonnet 5 / Haiku 4.5, оплата по токенам с баланса tkbk.io, P50 ~1.1 с из Москвы.

#Требования

  • Node.js 18+ (проверьте node -v).
  • Активный ключ cr_xxx из личного кабинета tkbk.io и положительный баланс.
  • Терминал: macOS/Linux (bash/zsh) или Windows (PowerShell 7+).

#Установка

Установка глобально
npm install -g @anthropic-ai/claude-code
claude --version

#Настройка через переменные окружения

Claude Code берёт адрес API из ANTHROPIC_BASE_URL, а ключ — из ANTHROPIC_AUTH_TOKEN. Укажите наш /claude-эндпоинт и ключ cr_xxx — токен Anthropic не нужен.

macOS / Linux — ~/.bashrc или ~/.zshrc
export ANTHROPIC_BASE_URL="https://api.tkbk.io/claude"
export ANTHROPIC_AUTH_TOKEN="cr_xxx"
# опционально — модель по умолчанию
export ANTHROPIC_MODEL="claude-sonnet-5"
Windows PowerShell — постоянные переменные
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.tkbk.io/claude", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "cr_xxx", "User")
# перезапустите терминал, затем:
claude

#Вариант через settings.json

Если не хотите держать переменные в профиле оболочки, пропишите их в ~/.claude/settings.json (на Windows — %USERPROFILE%\.claude\settings.json). Значения из env подхватываются при каждом запуске.

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.tkbk.io/claude",
    "ANTHROPIC_AUTH_TOKEN": "cr_xxx"
  },
  "model": "claude-sonnet-5"
}

#Ключевые переменные

ПеременнаяЗначениеНазначение
ANTHROPIC_BASE_URLhttps://api.tkbk.io/claudeадрес шлюза (обязательно)
ANTHROPIC_AUTH_TOKENcr_xxxваш ключ tkbk.io (обязательно)
ANTHROPIC_MODELclaude-sonnet-5основная модель
ANTHROPIC_SMALL_FAST_MODELclaude-haiku-4-5быстрая модель для служебных шагов

#Запуск и проверка

  1. 1
    Откройте проект

    Перейдите в папку проекта: cd my-project.

  2. 2
    Запустите агента

    Выполните claude — откроется интерактивная сессия.

  3. 3
    Проверьте связь

    Спросите «сколько файлов в проекте?» — если пришёл ответ, шлюз работает.

  4. 4
    Проверьте модель

    Команда /model внутри сессии показывает и переключает активную модель.

Быстрая проверка эндпоинта
curl https://api.tkbk.io/health
# {"status":"ok"}

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

СимптомПричинаРешение
401 Unauthorizedневерный ключ или лишний Bearer в значениипроверьте ANTHROPIC_AUTH_TOKEN — только cr_xxx, без префикса
404 Not Foundв base URL нет /claude или добавлен /v1должно быть ровно https://api.tkbk.io/claude
timeout / зависаниестарые переменные из другого профиляперезапустите терминал, проверьте echo $ANTHROPIC_BASE_URL
429превышены RPM или дневной лимитснизьте частоту или поднимите лимит в кабинете
Грабли Windows
PowerShell не подхватывает переменные до перезапуска окна. Не задавайте ANTHROPIC_API_KEY одновременно с ANTHROPIC_AUTH_TOKEN — используйте только второй.
Приватность
tkbk.io не логирует тело запроса и ответа — хранятся только метаданные для биллинга (модель, число токенов, время).
Не помогло?

Напишите в Telegram — поможем с настройкой и подберём тариф. Или вернитесь ко всем разделам документации.