Руководство по использованию сторонних поставщиков Claude Code - глубокий анализ и лучшие практики

Руководство по использованию сторонних поставщиков Claude Code

Вступление

В этой статье я делюсь своим многолетним опытом использования Claude Code, рассказывая, как эффективно настроить сторонних поставщиков и избежать распространенных ловушек конфигурации. В отличие от тех, кто просто пересылает официальную информацию в СМИ, здесь представлены проверенные на практике полезные советы.

Настройка переменных среды

Базовая настройка (о которой упоминают большинство учебников)

ANTHROPIC_BASE_URL=ваш адрес API поставщика
ANTHROPIC_AUTH_TOKEN=ваш токен аутентификации
ANTHROPIC_MODEL=имя модели по умолчанию

ANTHROPIC_SMALL_FAST_MODEL уже устарел, вместо него используется ANTHROPIC_DEFAULT_HAIKU_MODEL.

Расширенная настройка (о которой упоминают немногие)

В настоящее время Claude Code поддерживает выбор разных моделей для разных задач:

# Настройка моделей для разных серий
ANTHROPIC_DEFAULT_OPUS_MODEL=модель серии opus
ANTHROPIC_DEFAULT_SONNET_MODEL=модель серии sonnet
ANTHROPIC_DEFAULT_HAIKU_MODEL=модель серии haiku

# Модель, используемая субагентом
CLAUDE_CODE_SUBAGENT_MODEL=модель субагента
# Установка времени ожидания
BASH_DEFAULT_TIMEOUT_MS=10000
# Отключение ненужного трафика
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
# Отключение предупреждений о расходах, иначе будет предупреждение при использовании 5 долларов США по цене Claude sonnet
DISABLE_COST_WARNINGS=1
# Отключение ненужных вызовов моделей
DISABLE_NON_ESSENTIAL_MODEL_CALLS=1
# Отключение телеметрии
DISABLE_TELEMETRY=1

Дополнительные настройки см. по адресу: https://docs.claude.com/en/docs/claude-code/settings#environment-variables

Советы по использованию режима Plan

Режим Plan в Claude Code - очень полезная функция, которая заставляет ИИ больше думать, не внося сразу изменений в файлы. Этот режим особенно подходит для использования вместе с моделью Reasoner от DeepSeek. В режиме plan можно:

• Сократить ненужные изменения файлов
• Предоставлять более подробные процессы размышлений
• Подходит для сложного код-ревью и принятия проектных решений

Быстрое переключение сторонних поставщиков

Кто-то создал инструмент Claude Code Router для подключения сторонних поставщиков моделей к Claude Code, а кто-то создал переключатель переменных среды. Я настоятельно не рекомендую использовать эти дополнительные операции. Вам действительно нужно всего лишь открыть настройки VS Code, затем найти terminal.integrated.env и настроить первые три настраиваемых элемента.

Как показано ниже:

Затем каждый раз при открытии новой консоли в VS Code будут использоваться новые переменные среды. Нет необходимости использовать дополнительные сторонние инструменты, достаточно настроить имеющийся VS Code.

Почему не рекомендуется использовать инструменты преобразования API

Многие пользователи для удобного использования Claude Code пытаются использовать Claude Code Router или писать скрипты преобразования, но эти методы часто возникают из-за незнания VS Code и интерфейсов API.

Рекомендации: выбирайте поставщиков, которые официально поддерживают Anthropic API, а не тратите время на преобразование API. Причины следующие:

• Преобразование Anthropic API сложное, трудно идеально адаптироваться
• Поставщики с официальной поддержкой обеспечивают более стабильный сервис
• Избегайте проблем совместимости и ненужного времени отладки

Преобразование обычного API в Anthropic API представляет собой огромный разрыв, что показано в официальной таблице совместимости DeepSeek: DeepSeek-anthropic_api#детали совместимости anthropic api

Даже официальное преобразование имеет так много несовместимых элементов, не говоря уже о самостоятельном преобразовании. Советую не тратить время на эти дела.

Внутренние поставщики сторонних услуг, поддерживающие Claude Code

На данный момент я знаю, что в Китае есть поставщики, которые изначально поддерживают Anthropic API:

• DeepSeek - комплексные выдающиеся результаты
• Z-AI - предоставляет хорошую поддержку API
• Moonshot - большой объем параметров
• ModelScope - только GLM-4.5 может работать плавно

Ни один из них не полностью поддерживает Claude Code, у всех есть различные проблемы, например, deepseek не поддерживает subagent, ни одна из четырех компаний не поддерживает изображения и документы и т.д. Если хотите почувствовать всю мощь Claude Code, минимальный порог входа - это 100 долларов США Max, а не 20 долларов США Pro, потому что Pro не может использовать модель Opus.

DeepSeek

"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-reasoner",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat",
"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-reasoner",

Z-AI

"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
"CLAUDE_CODE_SUBAGENT_MODEL": "glm-4.5",

Moonshot

"ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_MODEL": "kimi-k2-turbo-preview",

ModelScope

"ANTHROPIC_BASE_URL": "https://api-inference.modelscope.cn",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-ai/DeepSeek-R1-0528",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "ZhipuAI/GLM-4.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "Qwen/Qwen3-Coder-480B-A35B-Instruct",
"CLAUDE_CODE_SUBAGENT_MODEL": "ZhipuAI/GLM-4.5",

Заключение

Каждый раз, когда я публикую документы, связанные с ИИ, кто-то внизу статьи размещает рекламу, как бородавку. Здесь я хочу серьезно предупредить всех, абсолютно не используйте никакие API перенаправления, существуют огромные угрозы безопасности.

Конкретные проблемы безопасности можно найти в: Анализ рисков безопасности маршрутизатора моделей

• ←Предыдущий
• Следующий→