Claude Code CLI
Официальный CLI-агент Anthropic через TKBK: установка, переменные окружения, settings.json, проверка и разбор ошибок 401/404/timeout.
Чтобы подключить 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 не нужен.
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"[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 подхватываются при каждом запуске.
{
"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_URL | https://api.tkbk.online | адрес шлюза (обязательно) |
ANTHROPIC_AUTH_TOKEN | cr_xxx | ваш ключ TKBK (обязательно) |
ANTHROPIC_MODEL | claude-sonnet-5 | основная модель |
ANTHROPIC_DEFAULT_HAIKU_MODEL | claude-haiku-4-5 | быстрая модель для служебных шагов (старое имя — ANTHROPIC_SMALL_FAST_MODEL) |
CLAUDE_CODE_ALWAYS_ENABLE_EFFORT | 1 | включает выбор effort (см. ниже) |
CLAUDE_CODE_EFFORT_LEVEL | low … 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 5 | low, medium, high, xhigh, max |
| Haiku 4.5 | не поддерживает — Claude Code не отправляет 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.
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Откройте проект
Перейдите в папку проекта:
cd my-project. - 2Запустите агента
Выполните
claude— откроется интерактивная сессия. - 3Проверьте связь
Спросите «сколько файлов в проекте?» — если пришёл ответ, шлюз работает.
- 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 повторит сам; если повторяется — подождите минуту |
ANTHROPIC_API_KEY одновременно с ANTHROPIC_AUTH_TOKEN — используйте только второй.