Примечание автора: Полное решение ошибки «Модель не найдена» в Claude Code при подключении через сторонний API-прокси: правильное написание Base URL, способ настройки settings.json и актуальная таблица соответствия имен моделей.
При использовании Claude Code в России самая частая ошибка выглядит так:
There's an issue with the selected model (claude-sonnet-4-6). It may not exist or you may not have access to it. Run /model to pick a different model.
Эта ошибка обычно возникает в двух случаях:
- Используется официальный API-ключ, но название модели написано с ошибкой (просто введите
/modelи выберите заново). - Подключен сторонний сервис-прокси API, и Base URL настроен неправильно, из-за чего маршрутизация модели не срабатывает.
В этой статье мы подробно разберем полное решение для второго случая на примере APIYI (apiyi.com). Мы рассмотрим настройку через переменные окружения, файл settings.json, а также приведем таблицу соответствия актуальных имен моделей Claude.
В чем польза: Прочитав эту статью, вы сможете правильно настроить Claude Code для работы через сторонний API-прокси, избавитесь от ошибки «модель не найдена» и обеспечите стабильную работу всех функций Claude Code в российских сетях.
I. Быстрая диагностика: ошибка в имени модели или в Base URL?
Прежде чем приступать к настройке, потратьте 30 секунд, чтобы понять, с какой проблемой вы столкнулись:
| Симптом | Возможная причина | Что делать |
|---|---|---|
Сообщение Run /model to pick a different model |
Модель не существует или нет доступа | Выполните /model и выберите заново |
| Введено верное имя модели, но ошибка остается | Проблема с настройкой Base URL | Проверьте ANTHROPIC_BASE_URL |
| Ошибка проверки API-ключа | Ключ недействителен или не установлен | Перенастройте ANTHROPIC_API_KEY |
| Таймаут сети / Соединение отклонено | Неверный адрес прокси | Проверьте формат Base URL |
| Ошибка на всех моделях | Прокси не поддерживает формат Anthropic | Убедитесь, что прокси поддерживает нативный протокол Anthropic |
Если вы используете официальный API-ключ Anthropic и у вас есть доступ к anthropic.com, просто выполните команду /model в Claude Code, чтобы переключить модель — дополнительные настройки не требуются.
Если вы подключаетесь через сторонний сервис-прокси API (например, apiyi.com), следуйте инструкциям ниже.
🎯 Совет: Рекомендуем подключаться к Claude Code через платформу APIYI (apiyi.com). Она полностью совместима с нативным форматом Anthropic, поддерживает все актуальные модели (claude-3-5-sonnet-20241022, claude-3-7-sonnet-20250219 и др.) и стабильно работает в России.
2. Основные настройки подключения Claude Code через сторонний прокси-API
2.1 Правильный формат Base URL: удалите /v1
Это самый важный шаг и место, где чаще всего совершают ошибки.
У Claude Code есть своя логика обработки Base URL: он автоматически добавляет /v1/messages в конец указанного вами адреса. Поэтому:
-
❌ Неправильно:
ANTHROPIC_BASE_URL=https://api.apiyi.com/v1- Фактический путь запроса превращается в:
https://api.apiyi.com/v1/v1/messages(происходит дублирование /v1) - Результат: эндпоинт не найден, модель выдает ошибку.
- Фактический путь запроса превращается в:
-
✅ Правильно:
ANTHROPIC_BASE_URL=https://api.apiyi.com- Фактический путь запроса превращается в:
https://api.apiyi.com/v1/messages - Результат: успешное обращение к оригинальному интерфейсу Anthropic.
- Фактический путь запроса превращается в:
📌 Итог: При настройке
ANTHROPIC_BASE_URLуказывайте только корневой домен, без суффикса/v1. Claude Code сам достроит полный путь.
2.2 Получение API-ключа
Войдите в личный кабинет APIYI для получения токена: страница управления токенами APIYI api.apiyi.com/token
Рекомендации по выбору токена:
| Тип токена | Сценарий использования | Скидка |
|---|---|---|
| Токен по умолчанию | Универсальный, готов к работе | Стандартная цена |
| Группа токенов ClaudeCode | Специально для Claude Code | Скидка 12% |
При создании нового токена выберите группу ClaudeCode, чтобы получить скидку 12%. Это значительно снизит расходы при длительном использовании.
III. Подробный разбор двух способов настройки
Способ 1: Настройка через переменные окружения (рекомендуется для быстрого теста)
Выполните следующие команды в терминале. Настройки вступят в силу немедленно (действуют только для текущей сессии):
# Устанавливаем Base URL стороннего прокси-сервиса (важно: без /v1 в конце)
export ANTHROPIC_BASE_URL="https://api.apiyi.com"
# Устанавливаем API-ключ (замените на ваш реальный ключ)
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
# Запускаем Claude Code
claude
Проверка настроек:
# Проверяем текущие переменные окружения
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY
# Должно вывести:
# https://api.apiyi.com
# sk-xxxxxx...
Плюсы и минусы:
- ✅ Просто и быстро, не нужно править файлы.
- ✅ Не влияет на конфигурацию в других окнах терминала.
- ❌ Нужно настраивать заново при каждом открытии терминала (если не прописать в
.zshrc/.bashrc).
Как сделать настройки постоянными (запись в конфиг Shell):
# Для пользователей zsh (по умолчанию в macOS)
echo 'export ANTHROPIC_BASE_URL="https://api.apiyi.com"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-ваш-ключ"' >> ~/.zshrc
source ~/.zshrc
# Для пользователей bash
echo 'export ANTHROPIC_BASE_URL="https://api.apiyi.com"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-ваш-ключ"' >> ~/.bashrc
source ~/.bashrc
Способ 2: Настройка через settings.json (рекомендуется для постоянного использования)
Отредактируйте файл ~/.claude/settings.json (глобальная конфигурация, действует для всех проектов):
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-ваш-API-ключ"
}
}
🎯 Совет: Используйте
~/.claude/settings.jsonдля глобальной настройки — это делается один раз и навсегда. Получить ключ можно на APIYI (apiyi.com), при выборе группы токенов ClaudeCode действует скидка 12%.
Если файл не существует, создайте его вручную:
# Создаем директорию .claude (если её нет)
mkdir -p ~/.claude
# Создаем settings.json
cat > ~/.claude/settings.json << 'EOF'
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-замените-на-ваш-ключ"
}
}
EOF
Приоритет конфигурации (от высокого к низкому):
| Приоритет | Источник | Описание |
|---|---|---|
| 1 (высший) | Переменные окружения | Прямой export в терминале |
| 2 | .claude/settings.local.json |
Локальный конфиг проекта (не пушится в git) |
| 3 | .claude/settings.json |
Общий конфиг проекта |
| 4 (низший) | ~/.claude/settings.json |
Глобальный пользовательский конфиг |
Если один и тот же параметр указан в разных местах, сработает тот, у которого выше приоритет. Помните об этом, если у вас есть settings.json прямо в папке проекта.
IV. Актуальные названия моделей для Claude Code
Это самые актуальные названия моделей Claude на 2026 год. Указывайте их точно, соблюдая регистр и цифры:
Стандартные модели
| Название модели | Серия | Позиционирование | Сценарии использования |
|---|---|---|---|
claude-opus-4-6 |
Claude 4.6 | Максимальная мощность | Сложный код, глубокий анализ, работа с огромными документами |
claude-sonnet-4-6 |
Claude 4.6 | Баланс мощи и скорости | Ежедневное программирование, код-ревью, написание текстов |
claude-haiku-4-5-20251001 |
Claude 4.5 | Сверхбыстрый отклик | Простые вопросы, автодополнение кода, быстрые задачи |
Модели с расширенным рассуждением (Thinking Mode)
Добавив суффикс -thinking к названию модели, вы активируете режим расширенного рассуждения. Модель будет проводить глубокий логический анализ перед тем, как дать ответ:
| Название модели | Базовая модель | Особенности |
|---|---|---|
claude-opus-4-6-thinking |
claude-opus-4-6 | Сильнейшее рассуждение: для математики, логики и сложных решений |
claude-sonnet-4-6-thinking |
claude-sonnet-4-6 | Идеальный баланс логики и скорости, лучший выбор на каждый день |
claude-haiku-4-5-20251001-thinking |
claude-haiku-4-5-20251001 | Легковесное рассуждение |
💡 Рекомендация по выбору: Для повседневной работы с Claude Code лучше всего подходит
claude-sonnet-4-6— это золотая середина между качеством кода и скоростью ответа. Если столкнулись с запутанным багом или проектируете сложную архитектуру, переключайтесь наclaude-opus-4-6илиclaude-sonnet-4-6-thinking.
5. Переключение моделей в Claude Code
После настройки Base URL и API-ключа переключать модели можно двумя способами:
5.1 Использование команды /model (самый простой способ)
В чате Claude Code просто введите:
/model
Claude Code выведет список доступных моделей. Если вы используете сторонний сервис-прокси API, в списке могут отображаться не все доступные модели — в этом случае название модели нужно будет ввести вручную.
5.2 Указание моделей по умолчанию в settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-ваш-API-ключ",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6"
}
}
С помощью переменных окружения ANTHROPIC_DEFAULT_*_MODEL можно точно указать название для каждого уровня моделей. Это поможет избежать ситуации, когда Claude Code использует встроенные имена по умолчанию (которые могут не совпадать с именами в сервисе-прокси).
🎯 Пример полной конфигурации: Эти настройки рекомендуется сохранить в
~/.claude/settings.json. В качествеANTHROPIC_API_KEYиспользуйте токен группы ClaudeCode от APIYI (apiyi.com).
6. Часто задаваемые вопросы и решения (FAQ)
В1: После настройки ANTHROPIC_BASE_URL Claude Code вообще не запускается?
Проверьте, правильно ли оформлен JSON. Распространенные ошибки:
- Лишняя запятая после последней пары «ключ-значение» (JSON не допускает запятых в конце списка).
- Использование «умных» кавычек
«»вместо стандартных латинских"".
# Проверка формата JSON
cat ~/.claude/settings.json | python3 -m json.tool
Если вывод корректный — формат в порядке. Если возникла ошибка — ищите опечатку в синтаксисе.
В2: Ошибка Invalid API key, хотя я уверен, что ключ верный?
Возможные причины:
- Пробелы в ключе → Проверьте, не скопировали ли вы лишние пробелы в начале или конце.
- Ключ истек или отключен → Зайдите в личный кабинет
api.apiyi.com/tokenи создайте новый. - Приоритет переменных окружения → В системе может быть прописана старая переменная
ANTHROPIC_API_KEY, которая перекрывает настройки из файла.
# Проверка наличия переменных окружения из разных источников
env | grep ANTHROPIC
В3: Вызов модели проходит, но ответы низкого качества или со странным форматированием?
Возможная причина: сервис-прокси не полностью поддерживает специфический формат Anthropic, особенно в части обработки системных промптов (system prompt).
Как проверить: протестируйте работу прокси напрямую через curl:
curl https://api.apiyi.com/v1/messages \
-H "Content-Type: application/json" \
-H "x-api-key: sk-ваш-ключ" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 100,
"messages": [{"role": "user", "content": "Say hello"}]
}'
Нормальный ответ должен содержать поле content с текстом. Если возвращается ошибка или пустой результат — проблема на стороне прокси-сервиса.
🎯 Быстрая проверка: APIYI (apiyi.com) полностью совместим с нативным форматом Anthropic, и этот curl-тест там отработает штатно. Если вы используете другой сервис, эта команда поможет быстро подтвердить совместимость.
В4: Как настроить переменные окружения в Windows?
Для пользователей Windows проще и надежнее использовать файл settings.json:
// Путь: C:\Users\ВашеИмя\.claude\settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-ваш-API-ключ"
}
}
Если нужно задать временные переменные в PowerShell:
$env:ANTHROPIC_BASE_URL = "https://api.apiyi.com"
$env:ANTHROPIC_API_KEY = "sk-ваш-API-ключ"
claude
В5: Как использовать разные настройки API для разных проектов?
Создайте файл .claude/settings.json прямо в корневой директории проекта (его настройки будут иметь приоритет над глобальными):
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-ключ-для-этого-проекта"
}
}
Важно: если в этом файле прописан ключ, обязательно добавьте его в .gitignore, чтобы случайно не отправить в репозиторий. Еще безопаснее использовать файл .claude/settings.local.json (локальные настройки), который по умолчанию не отслеживается git.
7. Чек-лист для проверки конфигурации
После завершения настройки выполните следующие шаги для проверки:
# Шаг 1: Убедитесь, что переменные окружения вступили в силу
echo "Base URL: $ANTHROPIC_BASE_URL"
echo "API Key: ${ANTHROPIC_API_KEY:0:10}..."
# Шаг 2: Проверьте доступность API
curl -s https://api.apiyi.com/v1/models \
-H "x-api-key: $ANTHROPIC_API_KEY" | head -c 200
# Шаг 3: Запустите Claude Code и протестируйте
claude --version
claude
В диалоговом окне Claude Code введите команду /status, чтобы проверить текущее состояние подключения и убедиться, что Base URL и конфигурация модели указаны верно.
🎯 После настройки: Рекомендуем отправить любое простое сообщение, чтобы подтвердить, что Claude Code отвечает корректно. Платформа APIYI (apiyi.com) поддерживает проверку баланса, так что вы сможете в реальном времени отслеживать расход токенов в личном кабинете — это очень удобно для контроля затрат.
Итоги
Если при подключении Claude Code через сторонний сервис-прокси API возникает ошибка «модель не найдена» (model not found), в 90% случаев причина в неверном формате Base URL. Вот основные правила, которые стоит запомнить:
- Base URL без
/v1: указывайтеhttps://api.apiyi.com, Claude Code сам добавит нужный путь/v1/messages. - Точное имя модели: используйте полные идентификаторы, такие как
claude-sonnet-4-6,claude-opus-4-6илиclaude-haiku-4-5-20251001. - Настройка через settings.json: лучше один раз прописать конфиг в
~/.claude/settings.json, чтобы он работал постоянно и не пришлось каждый раз возиться с переменными окружения. - Специальные токены для ClaudeCode: в панели APIYI выбирайте группу ClaudeCode — это дает скидку 12% (оплата 88% от тарифа).
Если вы используете официальный API-ключ Anthropic и у вас прямой доступ к сети (без прокси), достаточно просто выполнить команду /model прямо в интерфейсе Claude Code и выбрать нужную модель — дополнительные настройки не потребуются.
🎯 Как получить API-ключ: Зарегистрируйтесь на сайте APIYI (apiyi.com) и создайте токен для группы ClaudeCode на странице управления токенами
api.apiyi.com/token. Платформа работает по системе Pay-as-you-go без минимального платежа — вы платите только за фактически использованные токены, что отлично подходит и для личных проектов, и для работы в команде.
Материал подготовлен технической командой APIYI на основе тестов Claude Code v2.x. Если возникнут вопросы по настройке, заглядывайте в наш центр помощи help.apiyi.com.
