Use los modelos de Alibaba Cloud Model Studio en Claude Code.
Inicio rápido
Seleccione su cliente y complete la configuración.
- CLI
- CC Switch
- IDE plugin
- Desktop
- 1
Configure the model
- Token Plan
- Pay-as-you-go
- Coding Plan
ReemplaceYOUR_API_KEYcon su Token Plan API Key:- Token Plan Personal Edition: Crear o ver la API Key
- Token Plan Team Edition: Asignar una plaza y obtener la API Key
Al usar qwen4-max-preview, establezcaCLAUDE_CODE_MAX_OUTPUT_TOKENS=64000si la salida larga se trunca.Estas variables de entorno solo se aplican a la terminal actual. Para una configuración persistente, use Configurar con un archivo de configuración. - 2
Verify
Ejecute el siguiente comando para verificar:
Configurar con un archivo de configuración
Además de las opciones anteriores, también puede conectarse mediante un archivo de configuración.
- 1
Abrir el archivo de configuración
- macOS / Linux:
~/.claude/settings.json - Windows:
C:\Users\<username>\.claude\settings.json
- macOS / Linux:
- 2
Agregar la configuración
- Token Plan
- Pay-as-you-go
- Coding Plan
ReemplaceYOUR_API_KEYcon su clave API de Token Plan:- Token Plan Personal Edition: Crear o ver la API Key
- Token Plan Team Edition: Asignar una plaza y obtener la API Key
- 3
Verificar
Después de guardar, ejecute el siguiente comando para verificar:
Configure el tamaño de la ventana de contexto
Claude Code usa de forma predeterminada una ventana de contexto de 200K. Si el modelo admite 1M, extiéndala a 1M (1,000,000 tokens).
Método 1: Configurar mediante variable de entorno
Agregue CLAUDE_CODE_MAX_CONTEXT_TOKENS al campo env en ~/.claude/settings.json:
[1m] al nombre del modelo. Esto funciona con los modelos de Model Studio que admiten una ventana de contexto de 1M:
Modos de permisos
Claude Code proporciona seis modos de permisos:
default: Solicita confirmación antes de cada operación.acceptEdits: Aprueba automáticamente las ediciones de archivos. Las demás operaciones siguen solicitando confirmación.plan: Modo de planificación de solo lectura. No se ejecuta ningún cambio.dontAsk: No solicita confirmación. Una operación que requeriría confirmación se rechaza directamente.bypassPermissions: Omite todas las comprobaciones de permisos.delegate: Modo delegado.
--permission-mode para establecer el modo de permisos predeterminado para una sesión:
/permissions en una sesión para administrar las reglas de aprobación previa y denegación previa para las herramientas bash, edit y MCP.
Método 3: Configuración de settings.json
Configure el campo permissions en ~/.claude/settings.json:
Integrar Bailian CLI
- 1
Instalar Bailian CLI
- 2
Configurar la clave de API
Vaya a la consola de Bailian para obtener una clave de API y, a continuación, indique a Claude Code: - 3
Comenzar
Describa su tarea en lenguaje natural, por ejemplo:
Códigos de error
Si encuentra errores durante la configuración, consulte la documentación de preguntas frecuentes de su plan de facturación:
- Token Plan: Preguntas frecuentes de Personal Edition · Preguntas frecuentes de Team Edition
- Pago por uso: Códigos de error
- Coding Plan: Preguntas frecuentes de Coding Plan
Preguntas frecuentes
¿Cómo usar un plan de ahorro con pago por uso?
¿Cómo usar un plan de ahorro con pago por uso?
¿Cómo omito la verificación de inicio de sesión oficial de Anthropic?
¿Cómo omito la verificación de inicio de sesión oficial de Anthropic?
~/.claude.json (ruta de Windows: C:\Users\<username>\.claude.json) y establezca hasCompletedOnboarding en true para omitir la verificación de inicio de sesión oficial de Anthropic.Las solicitudes devuelven 401 invalid_api_key
Las solicitudes devuelven 401 invalid_api_key
ANTHROPIC_BASE_URL. Model Studio proporciona tres métodos de acceso, y cada método de acceso usa una URL base diferente y una clave de API dedicada.Método de acceso | URL base | Clave de API |
|---|---|---|
Token Plan |
| Clave de API de Token Plan |
Pay-as-you-go | Clave de API de Model Studio (comienza con | |
Coding Plan | Clave de API dedicada de Coding Plan |
- Verifique la URL de solicitud. Compruebe
ANTHROPIC_BASE_URLen~/.claude/settings.json. - Confirme el tipo de clave de API. Con la tabla anterior, confirme que el tipo de clave de API coincide con la URL base.
- Corrija la configuración. Cuando use una clave de API Pay-as-you-go de Model Studio, establezca
ANTHROPIC_BASE_URLenhttps://dashscope-intl.aliyuncs.com/apps/anthropic.
Después de iniciar Claude Code, la interfaz muestra "Unable to connect to Anthropic services. Failed to connect to api.anthropic.com: ERR_BAD_REQUEST"
Después de iniciar Claude Code, la interfaz muestra "Unable to connect to Anthropic services. Failed to connect to api.anthropic.com: ERR_BAD_REQUEST"
- Verifique la configuración. Ejecute el comando
/statusdespués de iniciar Claude Code. Verifique queANTHROPIC_BASE_URLyANTHROPIC_AUTH_TOKENapunten a la dirección de Model Studio. Si la salida está vacía o muestra una dirección que no es de Model Studio, revise la configuración desettings.json. - Verifique hasCompletedOnboarding. Confirme que
hasCompletedOnboardingesté establecido entrueen~/.claude.json. Sin esto, Claude Code intenta conectarse al servicio oficial de Anthropic para la verificación de inicio de sesión al iniciarse. - Abra una nueva terminal. Después de editar el archivo de configuración, abra una nueva ventana de terminal y ejecute
claudepara que los cambios surtan efecto. - Actualice Claude Code. Si el problema persiste después de todos los pasos anteriores, es posible que la versión de Claude Code esté desactualizada. Ejecute
npm install -g @anthropic-ai/claude-code@latestpara actualizar a la última versión y vuelva a intentarlo.
El cambio de modelo no surte efecto cuando se usa la interfaz heredada
El cambio de modelo no surte efecto cuando se usa la interfaz heredada
https://dashscope-intl.aliyuncs.com/api/v2/apps/claude-code-proxy solo admite modelos en desuso. Especificar otros modelos no surte efecto. Para usar los modelos disponibles, migre a la nueva interfaz siguiendo la configuración de este documento.CC Switch informa "No available model list endpoint found. Check the Base URL or confirm that the provider has opened the port" al agregar un proveedor
CC Switch informa "No available model list endpoint found. Check the Base URL or confirm that the provider has opened the port" al agregar un proveedor
/v1/models) con la URL de solicitud configurada. El endpoint compatible con Anthropic de Model Studio (terminado en /apps/anthropic) solo proporciona el endpoint de mensajes /v1/messages y no proporciona un endpoint de lista de modelos, por lo que la consulta devuelve 404 y CC Switch informa "No available model list endpoint found".Este mensaje no afecta el uso normal de Claude Code y puede ignorarse. Claude Code envía las conversaciones a través de /v1/messages, y los modelos que usa se especifican directamente mediante la asignación de modelos en las Advanced options de CC Switch, sin depender de la detección automática de un endpoint de lista de modelos. Cuando la URL de solicitud y la clave de API están configuradas correctamente, simplemente haga clic en Enable e inicie una nueva sesión de Claude Code para chatear con normalidad.Si aún no puede chatear, verifique que la URL de solicitud termine en /apps/anthropic sin un /v1 adicional y que haya completado los modelos admitidos por su plan en la asignación de modelos en Advanced options.La asignación de modelos en CC Switch devuelve AccessDenied
La asignación de modelos en CC Switch devuelve AccessDenied
AccessDenied (HTTP 403, código: access_denied) después de configurar la asignación de modelos, verifique si el modelo está marcado como Upcoming deprecation en la consola de Model Studio > Model Gallery. Los modelos marcados para próxima obsolescencia aún aparecen en la lista, pero las llamadas de API devuelven 403 AccessDenied. Siga estos pasos:- Verifique si el modelo está marcado para obsolescencia. En la consola de Model Studio > Model Gallery, busque el modelo que está usando y revise su etiqueta de estado.
- Cambie al último modelo disponible. Reemplace el modelo heredado (como
qwen-coder-turbo-0919) en la asignación de modelos por el último modelo disponible (comoqwen3.8-max). - Reconfigure la asignación de modelos y pruebe. Actualice la asignación de modelos en Advanced options de CC Switch, haga clic en Enable e inicie una nueva sesión de Claude Code para verificarlo.