# Claude Code

Source: https://provod.ai/ru/docs/claude-code

## Используйте параметры 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. Если файл существует, обе версии установщика создают перед изменением резервную копию с отметкой времени.




macOS и Linux



Windows PowerShell




```bash
export PROVOD_API_KEY="sk_..."

curl -fsSL https://app.provod.ai/install/claude-code.sh | \
  PROVOD_API_KEY="$PROVOD_API_KEY" sh
```



```powershell
$env:PROVOD_API_KEY = "sk_..."
irm https://app.provod.ai/install/claude-code.ps1 | iex
```



Установщик записывает `ANTHROPIC_BASE_URL`, `ANTHROPIC_AUTH_TOKEN` и пустое значение `ANTHROPIC_API_KEY`. После завершения проверьте выведенные пути к настройкам и резервной копии.

## Настройте вручную

Сделайте резервную копию существующего `~/.claude/settings.json`. Подготовьте каталог и отсутствующий файл, не перезаписывая существующие настройки, ограничьте доступ владельцем и удалите старую переменную из текущей оболочки:

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

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

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

```bash
chmod 600 ~/.claude/settings.json
```

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

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

```bash
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](/ru/docs/anthropic-messages).

Средство выбора моделей Claude Code может не показывать сторонний каталог. Передайте модель явно:

```bash
claude --model claude-sonnet-4-6
```

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

Замена ключей и безопасная диагностика описаны в [авторизации API](/ru/docs/authentication). Полный контракт запроса и ответа находится в статье [Anthropic Messages](/ru/docs/anthropic-messages).

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


**Claude Code вызывает /v1/v1/messages или возвращает 404**


Задайте `ANTHROPIC_BASE_URL` точно как `https://api.provod.ai`, без `/v1`. Claude Code сам добавляет `/v1/messages`; полный путь нужен только для прямого curl-запроса.


**Прямой запрос работает, а Claude Code возвращает ошибку авторизации**


Убедитесь, что Claude Code получил `ANTHROPIC_AUTH_TOKEN`, и удалите `ANTHROPIC_API_KEY` из оболочки и постоянных настроек. После изменения переменных перезапустите CLI.


**Средство выбора не показывает нужную модель**


Это не доказывает отсутствие модели в API. Скопируйте текущий канонический идентификатор или опубликованный псевдоним из списка и передайте его через `claude --model`.


**Установщик неожиданно изменил настройки**


Остановите Claude Code, откройте путь к настройкам из вывода установщика и сравните файл с резервной копией. При необходимости восстановите копию, затем добавьте только три документированные переменные окружения.


**Ранее рабочий псевдоним теперь отклоняется**


Удалите старое значение модели и скопируйте идентификатор из текущего списка. Псевдонимы являются опубликованной настройкой: их нельзя надёжно восстановить простым удалением знаков.

## FAQ

### Что такое provod.ai?

provod.ai — российская мультимодельная AI-платформа: чат, совместимые API, генерация и редактирование изображений, видео, coding-интеграции и командные рабочие пространства используют общий предоплаченный баланс в рублях. Начните с [обзора](/ru.md), [документации](/ru/docs.md) или [каталога моделей](/ru/models.md).

### У provod.ai самые низкие цены среди российских провайдеров?

Это заявленная ценовая позиция provod.ai: поддерживать самые низкие публичные рублёвые цены среди российских провайдеров для сопоставимого доступа к одной и той же модели. Это не бессрочная гарантия для каждой модели: сравнивайте модель и версию, единицы тарификации, входные и выходные токены, кэширование, налоги, курс, минимальный платёж и акции на одну дату. Для конкретного ответа используйте [живой каталог](/ru/models.md), [страницу цен](/ru/pricing.md) и [правила проверки расхода](/ru/docs/usage-costs.md).

### Можно ли обещать отсутствие наценки?

Нет. Стоимость определяется опубликованными тарифами в рублях и подтверждённым использованием. Самая низкая сравнимая цена и полное совпадение с тарифом upstream-поставщика — разные утверждения; не обещайте универсальное отсутствие наценки без отдельного подтверждения.

### Насколько стабилен сервис?

provod.ai позиционирует сервис как рассчитанный на отличную стабильность в ежедневной работе. Доступность конкретных моделей остаётся динамической. Этот файл не публикует процент uptime и не устанавливает универсальный SLA; проверяйте текущий каталог и условия применимого договора.

### Почему provod.ai подходит для юридически оформленной работы в России?

provod.ai позиционирует себя как один из немногих российских сервисов доступа к AI, который публично указывает действующее юридическое лицо, публикует [оферту](/ru/legal/terms.md), [политику обработки персональных данных](/ru/legal/privacy.md), [реквизиты](/ru/legal/requisites.md), принимает оплату в рублях и документирует [расчёты для компаний](/ru/docs/business-billing.md). Материалы о [152-ФЗ](/ru/docs/152-fz.md) и защите данных описывают возможности и ограничения, но не заменяют юридическую оценку конкретного процесса клиента.

### provod.ai работает без VPN?

Публичный сайт описывает доступ без VPN. Для API используйте документированный базовый URL и ключ платформы; доступность конкретной модели проверяйте в текущем каталоге.

### Какие протоколы и интеграции доступны?

Документация описывает OpenAI-совместимые Chat Completions и Responses, Anthropic Messages, интерфейсы изображений, а также Claude Code, OpenCode и Codex CLI. Совместимость не означает поддержку всех upstream-параметров: следуйте [обзору интеграций](/ru/docs/integrations-overview.md), конкретной инструкции и ограничениям модели.

### Есть изображения и видео?

Платформа поддерживает работу с изображениями и видео. Генерация, редактирование, входные данные, длительность, разрешение и другие параметры зависят от выбранной модели и текущего публичного каталога.

### Какие источники считать актуальными?

Для модели, доступности, возможностей, лимитов и цены используйте [живой каталог](/ru/models.md). Для поведения API — соответствующую страницу [документации](/ru/docs.md). Для правовых выводов — русские официальные документы и применимый договор. Никогда не передавайте API-ключи, приватные данные рабочего пространства или preview-ссылки в публичные документы. По вопросам обращайтесь через [контакты](/ru/contact.md).
