⌘ IDE и клиенты

Claude Code CLI

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

Обновлено ⏱ 9 мин
#claude code#cli#anthropic#terminal#agent#windows

Чтобы подключить Claude Code к ключу TKBK, задайте две переменные окружения: ANTHROPIC_BASE_URL=https://api.tkbk.online и ANTHROPIC_AUTH_TOKEN=cr_… — или блок env в ~/.claude/settings.json. Вход в аккаунт Anthropic и подписка не нужны: агент работает с моделями Claude из каталога, расход списывается по токенам с баланса ключа.

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

✓
Что получится
Рабочий claude в терминале с моделями Fable 5.1 / Opus 5.5 / Sonnet 5 / Haiku 4.5, оплата по токенам с баланса TKBK.

#Требования

  • Node.js 18+ (проверьте node -v).
  • Активный ключ cr_xxx из личного кабинета TKBK и положительный баланс.
  • Терминал: 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. Укажите адрес шлюза https://api.tkbk.online и ключ cr_xxx — токен Anthropic не нужен.

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

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

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

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

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

ПеременнаяЗначениеНазначение
ANTHROPIC_BASE_URLhttps://api.tkbk.onlineадрес шлюза (обязательно)
ANTHROPIC_AUTH_TOKENcr_xxxваш ключ TKBK (обязательно)
ANTHROPIC_MODELclaude-sonnet-5основная модель
ANTHROPIC_DEFAULT_HAIKU_MODELclaude-haiku-4-5быстрая модель для служебных шагов (старое имя — ANTHROPIC_SMALL_FAST_MODEL)
CLAUDE_CODE_ALWAYS_ENABLE_EFFORT1включает выбор effort (см. ниже)
CLAUDE_CODE_EFFORT_LEVELlow … max, autoуровень effort для всех сессий

#Эффорт: /effort, ползунок в /model, CLAUDE_CODE_EFFORT_LEVEL

Effort — сколько модель думает перед ответом: low, medium, high, xhigh, max. Шлюз TKBK передаёт уровень модели как есть. Но Claude Code показывает выбор effort только для моделей, которые узнаёт у самой Anthropic, а со сторонним ANTHROPIC_BASE_URL прячет его. Чтобы вернуть выбор, задайте CLAUDE_CODE_ALWAYS_ENABLE_EFFORT=1 — в env файла settings.json или переменной окружения. Установщик со страницы «Подключение» делает это сам.

  • /effort — ползунок; /effort high — сразу нужный уровень; /effort auto — вернуть уровень модели по умолчанию.
  • /model — стрелками влево/вправо меняется effort выбранной модели.
  • claude --effort xhigh — уровень на одну сессию.
  • CLAUDE_CODE_EFFORT_LEVEL=high — уровень для всех сессий, важнее /effort. Только так max держится дольше одной сессии: из /effort он действует до её конца.
МодельУровни effort
Fable 5.1, Opus 5.5, Opus 5, Sonnet 5low, medium, high, xhigh, max
Haiku 4.5не поддерживает — Claude Code не отправляет effort
ℹ
Effort и расход
Чем выше уровень, тем больше токенов уходит на размышления — ответ дороже и дольше. Для обычной работы хватает medium или high; xhigh и max — для сложной отладки и архитектуры. Слово ultrathink в запросе просит подумать глубже только на этот ход.

#Другие модели в Claude Code

Адрес https://api.tkbk.online говорит в формате Anthropic, и шлюз переводит в него не только Claude. С ключом «Китайские модели» в Claude Code работают deepseek-v4-pro, deepseek-v4.1-flash, glm-5.3, kimi-k3, kimi-k2.7-code, qwen3.8-max, minimax-m3, с ключом Gemini — модели gemini-*: подставьте ключ этого семейства в ANTHROPIC_AUTH_TOKEN и id в ANTHROPIC_MODEL и ANTHROPIC_DEFAULT_HAIKU_MODEL. GPT и Grok через формат Anthropic не работают — для GPT есть Codex CLI.

Claude Code на DeepSeek (ключ «Китайские модели»)
export ANTHROPIC_BASE_URL="https://api.tkbk.online"
export ANTHROPIC_AUTH_TOKEN="cr_ключ_китайские_модели"
export ANTHROPIC_MODEL="deepseek-v4-pro"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4.1-flash"
claude

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

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

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

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

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

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

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

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

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

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

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

СимптомПричинаРешение
401 Unauthorizedневерный ключ или лишний Bearer в значениипроверьте ANTHROPIC_AUTH_TOKEN — только cr_xxx, без префикса
404 Not Foundв base URL лишний путь (например, добавлен /v1)должно быть ровно https://api.tkbk.online
timeout / зависаниестарые переменные из другого профиляперезапустите терминал, проверьте echo $ANTHROPIC_BASE_URL
402кончился баланс ключа или дневной лимитпополните ключ в кабинете; дневной лимит обновится в новые сутки
403 «This API key does not include this model family»в ANTHROPIC_MODEL модель другого семейства (например, GPT)модели Claude — ключ Claude; GPT в Claude Code не работает, для него — Codex CLI
429 / 529 Overloadedмодель временно перегружена (своих лимитов на число запросов у ключей нет)Claude Code повторит сам; если повторяется — подождите минуту
⚠
Грабли Windows
PowerShell не подхватывает переменные до перезапуска окна. Не задавайте ANTHROPIC_API_KEY одновременно с ANTHROPIC_AUTH_TOKEN — используйте только второй.
ℹ
Приватность
TKBK не логирует тело запроса и ответа — хранятся только метаданные для биллинга (модель, число токенов, время).
Не помогло?

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