provod.ai / docs
Интеграции

Claude Code

Подключение Claude Code к совместимому с Anthropic Messages адресу provod.ai.

Обновлено

Используйте параметры Claude Code

Создайте ключ API в кабинете. Claude Code работает с форматом Anthropic Messages и сам добавляет /v1/messages, поэтому нужны такие настройки:

НастройкаЗначение
ANTHROPIC_BASE_URLhttps://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. Подготовьте каталог и отсутствующий файл, не перезаписывая существующие настройки, ограничьте доступ владельцем и удалите старую переменную из текущей оболочки:

Terminal
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 и объедините этот фрагмент с настройками, не удаляя остальные данные:

env fragment
{
  "ANTHROPIC_AUTH_TOKEN": "paste-value-from-PROVOD_API_KEY",
  "ANTHROPIC_BASE_URL": "https://api.provod.ai"
}

После сохранения ещё раз оставьте доступ только владельцу:

Terminal
chmod 600 ~/.claude/settings.json

Для временной настройки только в текущей оболочке:

Terminal
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, заголовок и основной псевдоним:

Terminal
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 может не показывать сторонний каталог. Передайте модель явно:

Terminal
claude --model claude-sonnet-4-6

Для другой модели скопируйте текущий идентификатор или опубликованный псевдоним из списка моделей, не придумывая его. Публичный код ошибки — это код для клиента, возвращённый API; если в ответе формата Anthropic отдельного кода нет, сохраните error.type, HTTP-статус, сообщение, адрес, время и маскированный префикс ключа.

Замена ключей и безопасная диагностика описаны в авторизации API. Полный контракт запроса и ответа находится в статье Anthropic Messages.

Решение проблем

На этой странице