Anthropic

Доступ к моделям Claude (Opus, Sonnet, Haiku) через Anthropic Messages API с нативным вызовом инструментов, зрением, кэшированием промптов и автообновлением OAuth-токенов.

Предварительные требования

• API-ключ Anthropic с console.anthropic.com, или
• OAuth-токен Claude Code (автоопределяется из ~/.claude/.credentials.json)

Быстрая настройка

1. Получение API-ключа

1. Зарегистрируйтесь на console.anthropic.com
2. Перейдите в раздел API Keys в панели управления
3. Нажмите Create Key и скопируйте ключ (начинается с sk-ant-)

2. Конфигурация

[default]
provider = "anthropic"
model = "claude-sonnet-4-20250514"

[providers.anthropic]
api_key = "${ANTHROPIC_API_KEY}"

Или задайте переменную окружения:

export ANTHROPIC_API_KEY="sk-ant-..."

3. Проверка

prx doctor models

Доступные модели

Модель	Контекст	Зрение	Вызов инструментов	Примечания
claude-opus-4-20250514	200K	Да	Да	Наиболее мощная, лучшая для сложных рассуждений
claude-sonnet-4-20250514	200K	Да	Да	Лучший баланс скорости и возможностей
claude-haiku-3-5-20241022	200K	Да	Да	Самая быстрая, наиболее экономичная
claude-sonnet-4-6	200K	Да	Да	Последний релиз Sonnet
claude-opus-4-6	200K	Да	Да	Последний релиз Opus

Справочник конфигурации

Поле	Тип	По умолчанию	Описание
api_key	string	обязательный	API-ключ Anthropic (sk-ant-...) или OAuth-токен
api_url	string	https://api.anthropic.com	Пользовательский базовый URL API (для прокси)
model	string	claude-sonnet-4-20250514	Модель по умолчанию

Возможности

Нативный вызов инструментов

PRX отправляет определения инструментов в нативном формате Anthropic с input_schema, избегая потерь при конвертации из формата OpenAI в Anthropic. Результаты инструментов корректно оборачиваются как блоки содержимого tool_result.

Зрение (анализ изображений)

Изображения, встроенные в сообщения как маркеры [IMAGE:data:image/png;base64,...], автоматически конвертируются в нативные блоки содержимого image Anthropic с корректными полями media_type и source_type. Поддерживаются изображения до 20 МБ (при превышении выводится предупреждение в логах).

Кэширование промптов

PRX автоматически применяет эфемерное кэширование промптов Anthropic для снижения стоимости и задержки:

• Системные промпты размером более ~1024 токенов (3 КБ) получают блок cache_control
• Разговоры с более чем 4 несистемными сообщениями имеют кэшированное последнее сообщение
• Определения инструментов имеют последний инструмент с пометкой cache_control: ephemeral

Никакой настройки не требуется; кэширование применяется прозрачно.

Автообновление OAuth-токенов

При использовании учётных данных Claude Code PRX автоматически:

1. Обнаруживает кэшированные OAuth-токены из ~/.claude/.credentials.json
2. Проактивно обновляет токены за 90 секунд до истечения
3. Повторяет попытки при ответах 401 со свежим токеном
4. Сохраняет обновлённые учётные данные обратно на диск

Это означает, что prx может использовать существующую авторизацию Claude Code без дополнительной настройки.

Интеграция с Claude Code

PRX распознаёт следующие источники аутентификации Anthropic:

Источник	Обнаружение
Прямой API-ключ	Префикс sk-ant-api-..., отправляется через заголовок x-api-key
OAuth setup token	Префикс sk-ant-oat01-..., отправляется через Authorization: Bearer с заголовком anthropic-beta
Кэшированные учётные данные Claude Code	~/.claude/.credentials.json с access_token + refresh_token
Переменная окружения	ANTHROPIC_API_KEY

Пользовательский базовый URL

Для маршрутизации через прокси или альтернативный эндпоинт:

[providers.anthropic]
api_key = "${ANTHROPIC_API_KEY}"
api_url = "https://my-proxy.example.com"

Псевдонимы провайдера

Следующие имена разрешаются в провайдер Anthropic:

• anthropic
• claude-code
• claude-cli

Устранение неполадок

«Anthropic credentials not set»

PRX не смог найти никакой аутентификации. Убедитесь, что настроено одно из:

1. Переменная окружения ANTHROPIC_API_KEY
2. api_key в config.toml в секции [providers.anthropic]
3. Действительный ~/.claude/.credentials.json от Claude Code

401 Unauthorized

• API-ключ: Проверьте, что он начинается с sk-ant-api- и не просрочен
• OAuth-токен: Выполните prx auth login --provider anthropic для повторной аутентификации или перезапустите Claude Code для обновления токена
• Проблема с прокси: При использовании пользовательского api_url убедитесь, что прокси корректно передаёт заголовок x-api-key или Authorization

Слишком большое изображение

Anthropic рекомендует изображения до 20 МБ в base64-кодированном виде. Уменьшите или сожмите большие изображения перед отправкой.

Кэширование промптов не работает

Кэширование автоматическое, но требует:

• Системный промпт > 3 КБ для активации кэширования на уровне системы
• Более 4 несистемных сообщений для активации кэширования разговора
• Версия API 2023-06-01 (устанавливается автоматически PRX)