Claude Code CLI
Официальный CLI-агент Anthropic через tkbk.io: установка, переменные окружения, settings.json, проверка и разбор ошибок 401/404/timeout.
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 не нужен.
export ANTHROPIC_BASE_URL="https://api.tkbk.io/claude"
export ANTHROPIC_AUTH_TOKEN="cr_xxx"
# опционально — модель по умолчанию
export ANTHROPIC_MODEL="claude-sonnet-5"[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 подхватываются при каждом запуске.
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.tkbk.io/claude",
"ANTHROPIC_AUTH_TOKEN": "cr_xxx"
},
"model": "claude-sonnet-5"
}#Ключевые переменные
| Переменная | Значение | Назначение |
|---|---|---|
ANTHROPIC_BASE_URL | https://api.tkbk.io/claude | адрес шлюза (обязательно) |
ANTHROPIC_AUTH_TOKEN | cr_xxx | ваш ключ tkbk.io (обязательно) |
ANTHROPIC_MODEL | claude-sonnet-5 | основная модель |
ANTHROPIC_SMALL_FAST_MODEL | claude-haiku-4-5 | быстрая модель для служебных шагов |
#Запуск и проверка
- 1Откройте проект
Перейдите в папку проекта:
cd my-project. - 2Запустите агента
Выполните
claude— откроется интерактивная сессия. - 3Проверьте связь
Спросите «сколько файлов в проекте?» — если пришёл ответ, шлюз работает.
- 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 или дневной лимит | снизьте частоту или поднимите лимит в кабинете |
ANTHROPIC_API_KEY одновременно с ANTHROPIC_AUTH_TOKEN — используйте только второй.