Claude Code с релеем TokenPilot
Узнайте, как настроить релей TokenPilot в CLI Claude Code для эффективного программирования с ИИ.
GET /v1/modelsМодели, доступные в TokenPilot
34 моделей из семейств OpenAI GPT и Anthropic Claude — все доступны через https://go.aitokenpilot.com/v1.
OpenAI · GPT
22 моделейДля клиентов протокола OpenAI: Codex, Cursor, Cline, Cherry Studio и др.
Чат и рассуждения
Общий чат, рассуждения, длинный контекст
Серия o (глубокие рассуждения)
Сложные рассуждения, математика, код
Программирование
Серия Codex — генерация и рефакторинг кода
Мультимодальные (аудио / realtime)
Голос в реальном времени, аудио вход/выход
Генерация изображений
Текст-в-изображение, редактирование
Anthropic · Claude
12 моделейДля клиентов протокола Anthropic: Claude Code, CC Switch, Hermes и др.
Opus (флагманские рассуждения)
Сильнейшие рассуждения и код для сложных задач
Sonnet (сбалансированная)
Баланс скорости и качества — на каждый день
Haiku (лёгкая и быстрая)
Быстрые и недорогие ответы для простых задач
Что такое Claude Code
Claude Code — официальный ИИ-ассистент для программирования в командной строке от Anthropic. Он работает прямо в терминале, читает вашу кодовую базу, выполняет команды и редактирует файлы — то, что раньше требовало кликов в IDE, превращается в одну фразу в терминале.
Подключение Claude Code к TokenPilot
Claude Code изначально поддерживает смену API-эндпоинта через ANTHROPIC_BASE_URL. Укажите TokenPilot (https://go.aitokenpilot.com) — и вы сможете вызывать Claude Sonnet / Opus одним токеном с оплатой по фактическому расходу токенов.
Кому подойдёт
- Тем, у кого нет подписки Claude Pro, но кто хочет писать код в CLI Claude Code
- Командам с общей квотой, которым нужен точный потокенный учёт
- Пользователям с нестабильным доступом к официальному эндпоинту Anthropic, которым нужен релей
Отличия от официального сервиса
| Параметр | Anthropic (официально) | TokenPilot |
|---|---|---|
| Оплата | Claude Pro, от $20/мес | По факту использования токенов |
| Ограничения | Мягкий лимит сообщений каждые 5 часов | Важен только общий объём токенов |
| Подключение | Запрос API-ключа в консоли | Один токен sk- решает всё |
| Доступ в Китае | Нужна стабильная сеть | Прямое подключение |
Нативно в терминале
Общайтесь с ИИ прямо в терминале — не покидая командную строку
Понимает код
Анализирует структуру проекта, понимает контекст, отвечает точно
Оплата по факту
Платите только за использованные токены — без фиксированной подписки
Прямой доступ в Китае
Подключается напрямую в большинстве сетей материкового Китая без прокси
Установка Claude Code
Установите Claude Code глобально через npm:
npm install -g @anthropic-ai/claude-codeINFO
После установки запустите команду claude, чтобы открыть Claude Code.
Версия Node.js
Claude Code требует Node.js 18 или 20 LTS и выше. Если он не установлен, рекомендуем менеджер версий вроде nvm или fnm.
Настройка TokenPilot
Получите API-ключ
Перейдите в консоль TokenPilot, зарегистрируйтесь и получите API-ключ. Токен выглядит как sk-xxxx... и показывается только один раз — сразу скопируйте и сохраните его.
Задайте переменные окружения
Задайте в терминале следующие переменные окружения:
# macOS / Linux
export ANTHROPIC_BASE_URL="https://go.aitokenpilot.com"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxx"Важно
ANTHROPIC_BASE_URLне должен содержать суффикс/v1— протокол Anthropic использует корневой путь- Используйте
ANTHROPIC_AUTH_TOKEN, а неANTHROPIC_API_KEY— TokenPilot использует Bearer-авторизацию и читает первую переменную
Проверьте настройку
Запустите Claude Code, чтобы убедиться, что всё работает:
claude --version && claude 'Hello, are you connected?'Сохранение в конфигурации shell
Команды export выше действуют только в текущей сессии. Чтобы они загружались автоматически в каждом новом терминале, добавьте их в файл конфигурации shell:
# Добавьте в ~/.zshrc (для zsh) или ~/.bashrc (для bash)
echo 'export ANTHROPIC_BASE_URL=https://go.aitokenpilot.com' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxx' >> ~/.zshrc
# Применить немедленно
source ~/.zshrc# Текущая сессия
$env:ANTHROPIC_BASE_URL = "https://go.aitokenpilot.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-xxxxxxxxxx"
# Постоянно (переменные окружения уровня пользователя)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://go.aitokenpilot.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxxxxxxxxx", "User")Безопасность
Токен равнозначен паролю — не вписывайте его в код, не коммитьте в Git, не отправляйте в чаты. При подозрении на утечку сразу отзовите и пересоздайте его в консоли.
Перепроверьте, что переменные окружения применились:
echo $ANTHROPIC_BASE_URL
# Должно вывести: https://go.aitokenpilot.com
echo $ANTHROPIC_AUTH_TOKEN
# Должно вывести: sk-xxxx... (первые символы)Базовое использование
Запуск интерактивной сессии
Запускайте из корня проекта, чтобы Claude читал текущий каталог как контекст:
cd ~/your-project
claudeДальше просто формулируйте задачи:
> Переведи синхронные вызовы в services/billing.ts на параллельное выполнение
> В этом OpenAI-совместимом запросе нет заголовка Authorization — добавь его
> Напиши юнит-тест для utils/rate-limiter.tsРазовый вопрос
Задайте один вопрос, не входя в интерактивную сессию:
claude "Этот regex не находит email с дефисами — поправь его"Анализ текущего каталога
claude -p . 'Разбери цепочку аутентификации этого проекта'Указание модели
Задайте модель по умолчанию через переменную окружения ANTHROPIC_MODEL:
# Sonnet 4.6 — рекомендуется для повседневной разработки, силён в коде
export ANTHROPIC_MODEL=claude-sonnet-4-6
# Opus 4.7 — сильнейшие рассуждения, для сложных задач
export ANTHROPIC_MODEL=claude-opus-4-7
# Haiku 4.5 — ответы за миллисекунды, в 10 раз дешевле
export ANTHROPIC_MODEL=claude-haiku-4-5-20251001Можно переопределить модель для одного вызова через --model:
claude --model claude-opus-4-7 'Спроектируй компонент повтора запросов с экспоненциальной задержкой'Или переключайтесь внутри сессии командой /model.
Частые команды внутри сессии
| Команда | Описание |
|---|---|
/help | Показать доступные команды |
/clear | Очистить контекст текущего диалога |
/compact | Сжать историю сессии, сохранив главное, чтобы экономить токены |
/model | Посмотреть или сменить текущую модель |
/cost | Показать расход токенов этой сессии |
/exit | Выйти из сессии |
Лучшие практики
Выбор модели по сценарию
| Сценарий | Рекомендуемая модель | Почему |
|---|---|---|
| Повседневная генерация кода | claude-sonnet-4-6 | Высокое качество кода, хорошая скорость |
| Проектирование архитектуры, сложный рефакторинг | claude-opus-4-7 | Самые глубокие рассуждения |
| Простые вопросы, сообщения коммитов | claude-haiku-4-5-20251001 | В 10 раз дешевле, быстро |
| Анализ крупной кодовой базы | claude-sonnet-4-6 | Контекст 200K + выгодно |
Контроль расхода токенов
- Когда контекст переполняется, лучше используйте
/compactдля сжатия истории (сохраняет главное); чтобы сменить тему полностью —/clear - Для простых задач (комментарии, сообщения коммитов) переключайтесь на Haiku
- Перед завершением сессии выполните
/cost, чтобы посмотреть расход и вовремя скорректировать - Добавьте
.claude/в.gitignore, чтобы кэш не попадал в репозиторий
Мониторинг расхода с claude-hud
claude-hud — это плагин сообщества для Claude Code, который показывает расход токенов / контекста текущей сессии в строке состояния в реальном времени и напоминает выполнить /compact или /clear при превышении порога — надёжнее, чем считать в уме.
# Выполните внутри сессии claude
/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/reload-plugins
/claude-hud:setupПосле установки выполните /claude-hud:setup один раз, чтобы выбрать, что показывать в строке состояния (расход / остаток / модель / своя подсказка). Перезапустите claude — и в строке состояния появится постоянный индикатор расхода.
Конфигурация на уровне проекта
Создайте в корне проекта файл CLAUDE.md с договорённостями проекта — Claude Code загрузит его автоматически:
# CLAUDE.md
## Стек
- Фронтенд: Vue 3 + Vite + TypeScript + Tailwind CSS
- Бэкенд: Go 1.22 + Gin + sqlc
- БД: PostgreSQL, кэш Redis
## Стиль кода
- Go: оборачивайте ошибки вместо повторного форматирования через `fmt.Errorf`; общие пакеты не импортируют бизнес-модели
- Фронтенд: Composition API + `<script setup>`, глобальное состояние через Pinia
- Именование: компоненты Vue в PascalCase, composables с префиксом `use-`
## Тесты
- Go: `go test ./...`, table-driven стиль
- Фронтенд: Vitest, `*.test.ts` рядом с исходным файломСделайте под себя
Выше — пример. Замените его реальными договорённостями вашего проекта — стиль, именование, структура, тесты — и Claude Code будет читать их в каждой сессии, избавляя от повторов.
Проверенные приёмы
- Запускайте Claude Code из корня проекта, чтобы он понимал полный контекст
- Используйте флаг
-p, чтобы указать файл или каталог для анализа - Сочетайте с Git и поручайте Claude ревью изменений
Частые вопросы
В: Ошибка 401 / Authentication failed
API-ключ недействителен или не загружен. Сначала убедитесь, что переменная загружена корректно, затем проверьте через curl:
# Убедитесь, что переменная загружена (должно вывести sk-xxxx...)
echo $ANTHROPIC_AUTH_TOKEN
# Самопроверка curl — 200 значит работает, 401 — проблема с токеном
curl https://go.aitokenpilot.com/v1/messages \
-H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-4-6","max_tokens":50,"messages":[{"role":"user","content":"hi"}]}'Частые причины: лишний пробел при копировании токена; использование ANTHROPIC_API_KEY вместо ANTHROPIC_AUTH_TOKEN; суффикс /v1 в base URL.
В: Ошибка connection timeout
Сеть недоступна. Сначала проверьте связь, затем — не блокирует ли её корпоративный/учебный прокси:
# Проверка связи
curl -I https://go.aitokenpilot.com
# Через локальный HTTP-прокси (порт укажите свой)
export HTTPS_PROXY=http://127.0.0.1:7890
claudeВ: Недостаточно средств / превышена квота
Войдите в консоль TokenPilot и пополните баланс на странице «Account balance»; на странице «Usage statistics» доступна детализация расхода по моделям.
В: Как переключить модель?
Используйте флаг --model для разового вызова, например claude --model claude-opus-4-7; или переключайтесь внутри сессии командой /model.