Guía de uso de proveedores de terceros para Claude Code - Análisis profundo y mejores prácticas

Guía de uso de proveedores de terceros para Claude Code

Introducción

Este artículo se basa en mi experiencia prolongada usando Claude Code, compartiendo cómo configurar eficientemente proveedores de terceros y evitar trampas comunes de configuración. A diferencia de aquellos medios que solo reenvían información oficial, el contenido aquí ha sido verificado mediante pruebas prácticas.

Configuración de variables de entorno

Configuración básica (lo que la mayoría de tutoriales mencionan)

ANTHROPIC_BASE_URL=tu URL de API del proveedor
ANTHROPIC_AUTH_TOKEN=tu token de autenticación
ANTHROPIC_MODEL=nombre del modelo por defecto

ANTHROPIC_SMALL_FAST_MODEL ya está obsoleto, reemplazado por ANTHROPIC_DEFAULT_HAIKU_MODEL.

Configuración avanzada (menos conocida)

Actualmente Claude Code permite seleccionar diferentes modelos para distintas tareas:

# Configurar por separado los modelos de cada serie
ANTHROPIC_DEFAULT_OPUS_MODEL=modelo de la serie opus
ANTHROPIC_DEFAULT_SONNET_MODEL=modelo de la serie sonnet
ANTHROPIC_DEFAULT_HAIKU_MODEL=modelo de la serie haiku

# Modelo usado por subagentes
CLAUDE_CODE_SUBAGENT_MODEL=modelo de subagente
# Establecer tiempo de espera
BASH_DEFAULT_TIMEOUT_MS=10000
# Desactivar tráfico innecesario
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
# Desactivar alertas de costos, de lo contrario se alerta cada vez que se usan 5 dólares según la tarifa de Claude sonnet
DISABLE_COST_WARNINGS=1
# Desactivar llamadas innecesarias al modelo
DISABLE_NON_ESSENTIAL_MODEL_CALLS=1
# Desactivar telemetry
DISABLE_TELEMETRY=1

Más configuraciones en: https://docs.claude.com/en/docs/claude-code/settings#environment-variables

Técnicas de uso del modo Plan

El modo Plan de Claude Code es una función muy útil que hace que la IA piense más sin modificar directamente los archivos. Este modo funciona particularmente bien con el modelo Reasoner de DeepSeek. En el modo plan puedes:

• Reducir modificaciones innecesarias de archivos
• Proporcionar un proceso de pensamiento más detallado
• Resulta adecuado para revisiones de código complejas y decisiones de diseño

Cambio rápido entre proveedores de terceros

Alguien creó la herramienta Claude Code Router para conectar proveedores de terceros a Claude Code, y también existen conmutadores de variables de entorno. No recomiendo usar estas operaciones adicionales. Lo que realmente necesitas es simplemente abrir la configuración de VS Code, buscar terminal.integrated.env y configurar los tres primeros elementos configurables.

Así:

Luego, al abrir un nuevo terminal dentro de VS Code, se usarán las nuevas variables de entorno. No necesitas herramientas de terceros adicionales, basta con configurar tu VS Code.

Por qué no se recomienda usar herramientas de conversión de API

Muchos usuarios para usar convenientemente Claude Code intentan usar Claude Code Router o escribir scripts de conversión, pero estos métodos suelen provenir de la falta de familiaridad con VS Code y las interfaces de API.

Recomendación: Elige proveedores que oficialmente soporten nativamente la API de Anthropic, en lugar de gastar tiempo en convertir la API. Las razones son:

• La conversión de API de Anthropic es compleja y difícil de adaptar perfectamente
• Los proveedores con soporte oficial ofrecen un servicio más estable
• Evita problemas de compatibilidad y tiempo innecesario de depuración

Convertir una API común a la API de Anthropic presenta una gran brecha. Esta es la tabla de compatibilidad oficial de DeepSeek para la conversión de API de Anthropic: DeepSeek-anthropic_api#anthropic-api-兼容性细节

Si incluso la conversión oficial tiene tantas incompatibilidades, imagina convertirla uno mismo. Se sugiere no malgastar tiempo en estas cosas.

Proveedores de terceros en China que soportan Claude Code

Actualmente, los proveedores en China que sé que nativamente soportan la API de Anthropic incluyen:

• DeepSeek - Excelente desempeño general
• Z-AI - Proporciona buen soporte API
• Moonshot - Gran volumen de parámetros
• ModelScope - Solo GLM-4.5 funciona sin problemas

Ninguno de ellos soporta perfectamente Claude Code, existen diversos problemas, por ejemplo, DeepSeek no soporta subagentes, las cuatro empresas no soportan imágenes ni documentos, etc. Si deseas experimentar el poder completo de Claude Code, el umbral mínimo de entrada es 100 dólares con Max, no 20 dólares con Pro, porque Pro no puede usar el modelo 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",

Conclusión

Cada vez que publico documentos relacionados con IA, alguien pega anuncios de propaganda en los comentarios. Aquí quiero advertir firmemente a todos que absolutamente no deben usar ningún API de reenvío, existe un enorme riesgo de seguridad.

Para detalles específicos sobre problemas de seguridad, consulta: Análisis de riesgos de seguridad de enrutadores de modelos

• ←Anterior
• Siguiente→