Claude Code

CLI Anthropic на эндпоинте OneProvider. Установка — две переменные окружения и проверочный вызов.

Установка

curl -fsSL https://claude.ai/install.sh | bash
# или:
brew install --cask claude-code

Вариант 1: переменные окружения (на одну сессию)

Самый быстрый путь — задать переменные только в текущем терминале. Это не сохраняется между сессиями. Если хотите оставить навсегда — см. блок «Сделать постоянными» в конце.

export ANTHROPIC_BASE_URL=https://api.oneprovider.dev
export ANTHROPIC_AUTH_TOKEN=sk-your-key-here

Вариант 2: постоянные настройки

Claude Code читает пользовательские настройки из settings.json. Дефолтная модель и семейные aliases ниже формируются из текущих active-моделей каталога.

Путь файла: ~/.claude/settings.json

{
"env": {
"ANTHROPIC_BASE_URL": "https://api.oneprovider.dev",
"ANTHROPIC_AUTH_TOKEN": "sk-your-key-here",
"ANTHROPIC_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
},
"model": "claude-sonnet-5-5"
}

Проверка

claude -p "say hi in one sentence"

Должны увидеть однострочный ответ за секунду-две. Если получили 401 — ключ неверный; 400 invalid_request_error означает, что имя модели не совпадает с каноническим списком (ответ перечислит поддерживаемые id).

Частые проблемы

# проверить файл
jq . ~/.claude/settings.json
# авто-замена умных кавычек на ASCII
sed -i.bak $'s/[\u201c\u201d]/"/g' ~/.claude/settings.json

Полный список ошибок 400 / 401 / 403 / 404 / 429 / 503 / 504 + симптом → причина → фикс на странице Решение проблем .

Использование инструментов

Claude Code использует Anthropic-нативную схему tools. API принимает любое имя инструмента (Read, Write, Edit, Bash, Grep, Glob, TodoWrite и т.д.) с tool_choice: auto — это то, что CLI отправляет по умолчанию. Заголовок anthropic-beta не нужен.

Если ваш кастомный оркестратор ставит tool_choice: {"type": "any"} или tool_choice: {"type": "tool", "name": "X"}, API переписывает их в auto + system-prompt nudge. См. Использование инструментов для полной таблицы.

Сделать постоянными

Если все работает и вы хотите, чтобы переменные сохранялись между сессиями — добавьте их в shell rc-файл (macOS/Linux) или в реестр пользователя (Windows). После этого новый терминал будет видеть их автоматически.

# дописать в ~/.zshrc (shell macOS по умолчанию)
cat >> ~/.zshrc <<'EOF'
export ANTHROPIC_BASE_URL=https://api.oneprovider.dev
export ANTHROPIC_AUTH_TOKEN=sk-your-key-here
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
EOF
# применить в текущей сессии:
source ~/.zshrc

Какую модель выбрать

Claude Code работает по протоколу Anthropic, поэтому лучше всего с семейством Claude. claude-sonnet-5-5 берите по умолчанию: баланс цены и качества для правок, тестов и объяснений. claude-opus-5-5 нужен для архитектурных решений, больших рефакторингов и багов, которые не удаётся поймать; он дороже за токен. claude-haiku-5-5 подходит для быстрых вопросов, сообщений коммитов и фоновой работы, где скорость важнее глубины. Внутри сессии переключайтесь командой /model или запускайте claude --model claude-opus-5-5. Настройки выше привязывают алиасы sonnet, opus и haiku к этим id. Актуальные id на странице моделей , ставки на странице тарифов . Цены считаются за миллион токенов, поэтому поставьте на ключ лимит расхода и следите за разделом «Расход» в кабинете.

Частые ошибки и решения

claude: command not found после установки

Сначала откройте новый терминал: установщик кладёт бинарник в ~/.local/bin. Если команды всё равно нет, добавьте export PATH="$HOME/.local/bin:$PATH" в rc-файл оболочки. При установке через Homebrew проверьте, что brew install --cask claude-code завершилась без ошибок.

400 invalid_request_error про модель

Такого id нет в каталоге, часто это старый алиас вроде claude-3-5-sonnet. Задайте ANTHROPIC_MODEL и три переменные ANTHROPIC_DEFAULT_*_MODEL как в settings.json выше или получите список допустимых id: curl -s https://api.oneprovider.dev/v1/models -H "x-api-key: $KEY".

404 или «The requested API endpoint does not exist»

ANTHROPIC_BASE_URL должен быть ровно https://api.oneprovider.dev: без /v1 и без /v1/messages на конце. Путь Claude Code добавляет сам.

429 «Insufficient balance on this API key»

Баланс кабинета или лимит расхода ключа исчерпан. Повтор не поможет: пополните баланс или поднимите лимит в кабинете и отправьте запрос заново.

Ответ обрывается на середине или соединение сбрасывается

Отключите VPN или VLESS-прокси: они буферизуют стримы и ломают HTTP/2. OneProvider не блокирует по региону и не буферизует стримы. Запрос должен начать отвечать за 6 минут и длится не дольше 10 минут, подробности в кодах ошибок .

Я поменял settings.json, а ничего не изменилось

Claude Code читает блок env при запуске, поэтому закройте и запустите claude заново. Держите переменные в ~/.claude/settings.json или в оболочке: проектный .claude/settings.json читается после первичной настройки и может не успеть.

Вопросы и ответы

Нужен ли аккаунт или подписка Claude?

Нет, достаточно ключа OneProvider. Входить в claude.ai не нужно; если появился экран входа, выполните шаги про Auth conflict выше.

Можно ли использовать GPT и другие модели в Claude Code?

Claude Code шлёт запросы Anthropic Messages, поэтому используйте id Claude. Для GPT возьмите Codex , Cursor или Cline .

Как вернуться к входу через Anthropic?

Удалите переменные ANTHROPIC_*, заданные выше, из блока env в settings.json и из rc-файла оболочки, откройте новый терминал и выполните /login.

Где посмотреть, сколько стоила сессия?

В разделе «Расход» кабинета по ключу: каждый запрос с моделью и числом токенов. Лимит расхода на ключе остановит агента, который ушёл в цикл.

Работает ли это в Windows?

Да. Выберите Windows в переключателе операционной системы вверху: те же две переменные задаются через PowerShell, а settings.json лежит в профиле пользователя, папка .claude.

Расширение Claude Code для VS Code настраивается так же?

Оно использует тот же файл настроек. См. Claude Code в VS Code .

Быстрые ответы

Какой base URL использовать?

Claude Code и Anthropic SDK работают с https://api.oneprovider.dev. OpenAI SDK и OpenAI-совместимые клиенты работают с https://api.oneprovider.dev/v1. За обоими адресами один ключ; список моделей: странице моделей , ставки на странице тарифов .

Как авторизоваться?

Передайте сырой ключ sk-… в заголовке x-api-key или Authorization: Bearer: один из двух, не оба. Храните ключ в переменной окружения, а не в файле, который попадает в репозиторий. Подробнее об аутентификации .

Где взять ключ?

Откройте кабинет в Telegram-боте @oneprovider_robot или на app.oneprovider.dev, пополните баланс и нажмите «Выпустить ключ». У каждого ключа может быть свой лимит расхода. Кабинет и ключи .

Что значат ошибки 401, 404 и 429?

401: ключ не задан, написан с ошибкой или передан не в том заголовке; вставьте ключ целиком, без кавычек и пробелов. 404: обычно неверный base URL, например лишний или двойной /v1. 429 с текстом «Insufficient balance»: баланс кабинета или лимит ключа исчерпан, пополните его вместо повторов; любой другой 429 это лимит частоты, подождите Retry-After. Разбор: коды ошибок и решение проблем .

Почему обрывается стрим или сбрасывается соединение?

VPN и VLESS-прокси часто буферизуют SSE или ломают согласование HTTP/2. У OneProvider нет региональных ограничений, и стримы на нашей стороне не буферизуются: отключите прокси и повторите запрос.

Куда писать, если не помогло?

Напишите в Telegram @Oneproviderhelpbot или откройте «Поддержку» в веб-кабинете: приложите код статуса и точный текст ошибки. Как работает поддержка .