Claude Code
Подключение Claude Code к совместимому с Anthropic Messages адресу provod.ai.
Обновлено
Используйте параметры Claude Code
Создайте ключ API в кабинете. Claude Code работает с форматом Anthropic Messages и сам добавляет /v1/messages, поэтому нужны такие настройки:
| Настройка | Значение |
|---|---|
ANTHROPIC_BASE_URL | https://api.provod.ai без /v1 |
ANTHROPIC_AUTH_TOKEN | Ваш ключ API provod.ai |
| Модель | Поддерживаемый канонический идентификатор или опубликованный псевдоним, заданный явно |
Удалите старую переменную ANTHROPIC_API_KEY: она использует другой путь авторизации и может перекрыть ANTHROPIC_AUTH_TOKEN или помешать ему.
Установите конфигурацию
Установщик обновляет настройки уже установленного Claude Code, но не устанавливает сам Claude Code. Если файл существует, обе версии установщика создают перед изменением резервную копию с отметкой времени.
export PROVOD_API_KEY="sk_..."
curl -fsSL https://app.provod.ai/install/claude-code.sh | \
PROVOD_API_KEY="$PROVOD_API_KEY" shУстановщик записывает ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN и пустое значение ANTHROPIC_API_KEY. После завершения проверьте выведенные пути к настройкам и резервной копии.
Настройте вручную
Сделайте резервную копию существующего ~/.claude/settings.json. Подготовьте каталог и отсутствующий файл, не перезаписывая существующие настройки, ограничьте доступ владельцем и удалите старую переменную из текущей оболочки:
export PROVOD_API_KEY="sk_..."
umask 077
mkdir -p ~/.claude
if [ ! -e ~/.claude/settings.json ]; then
printf '%s\n' '{}' > ~/.claude/settings.json
fi
chmod 600 ~/.claude/settings.json
unset ANTHROPIC_API_KEYОткройте файл в редакторе. Если объекта верхнего уровня env нет, добавьте его; если он есть, сохраните остальные поля. Удалите свойство ANTHROPIC_API_KEY из env и объедините этот фрагмент с настройками, не удаляя остальные данные:
{
"ANTHROPIC_AUTH_TOKEN": "paste-value-from-PROVOD_API_KEY",
"ANTHROPIC_BASE_URL": "https://api.provod.ai"
}После сохранения ещё раз оставьте доступ только владельцу:
chmod 600 ~/.claude/settings.jsonДля временной настройки только в текущей оболочке:
export PROVOD_API_KEY="sk_..."
export ANTHROPIC_BASE_URL="https://api.provod.ai"
export ANTHROPIC_AUTH_TOKEN="$PROVOD_API_KEY"
unset ANTHROPIC_API_KEYФайл настроек содержит ключ API
Защищайте настройки Claude Code и резервные копии установщика как секреты. Не добавляйте их в репозиторий. Если файл раскрылся, отзовите ключ в кабинете и создайте новый.
Проверьте адрес до запуска Claude Code
Прямой запрос отдельно проверяет адрес, ключ, путь Messages, заголовок и основной псевдоним:
export PROVOD_API_KEY="sk_..."
curl --fail-with-body --silent --show-error https://api.provod.ai/v1/messages \
-H "Authorization: Bearer $PROVOD_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 64,
"messages": [
{ "role": "user", "content": "Reply with ok" }
]
}'Текст ответа находится в content[0].text. Если запрос не проходит, сначала исправьте адрес или ключ и только потом проверяйте Claude Code.
Явно выберите и проверьте модель
Текущий контракт Messages принимает поддерживаемые канонические идентификаторы, например anthropic/claude-sonnet-4.6, и опубликованные псевдонимы, например claude-sonnet-4-6. Также подходят поддерживаемые обычные чат-модели и их настроенные псевдонимы; актуальные примеры приведены в статье Anthropic Messages.
Средство выбора моделей Claude Code может не показывать сторонний каталог. Передайте модель явно:
claude --model claude-sonnet-4-6Для другой модели скопируйте текущий идентификатор или опубликованный псевдоним из списка моделей, не придумывая его. Публичный код ошибки — это код для клиента, возвращённый API; если в ответе формата Anthropic отдельного кода нет, сохраните error.type, HTTP-статус, сообщение, адрес, время и маскированный префикс ключа.
Замена ключей и безопасная диагностика описаны в авторизации API. Полный контракт запроса и ответа находится в статье Anthropic Messages.