Alibaba Cloud Model Studio:Claude Code

Claude Code es un asistente de codificación con IA de línea de comandos desarrollado por Anthropic. Conéctelo a Alibaba Cloud Model Studio utilizando Pago por uso, Plan de Codificación, Edición Personal del Plan de Tokens o Edición para Equipos del Plan de Tokens.

Instalar Claude Code

Instalación

npm install -g @anthropic-ai/claude-code

claude --version

npm install -g @anthropic-ai/claude-code

Omitir la verificación de inicio de sesión

Edite o cree ~/.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.

{
  "hasCompletedOnboarding": true
}

Configurar credenciales de acceso

Cree ~/.claude/settings.json (ruta de Windows: C:\Users\<username>\.claude\settings.json) y agregue la configuración correspondiente a su plan de facturación.

Token Plan Personal Edition

Reemplace YOUR_API_KEY con la API Key dedicada de Token Plan Personal Edition. Para consultar los modelos disponibles, véanse los modelos compatibles para Token Plan Personal Edition.

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "auto",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.8-flash",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.8-max",
        "CLAUDE_CODE_SUBAGENT_MODEL": "auto",
        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "983616"
    }
}

Token Plan Team Edition

Reemplace YOUR_API_KEY con la API Key dedicada de Token Plan Team Edition. Para consultar los modelos disponibles, véanse los modelos compatibles para Token Plan Team Edition.

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "auto",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.8-flash",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.8-max",
        "CLAUDE_CODE_SUBAGENT_MODEL": "auto",
        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "983616"
    }
}

Plan de codificación

Reemplace YOUR_API_KEY con la API Key dedicada de Coding Plan. Para consultar los modelos disponibles, véanse los modelos compatibles para Coding Plan.

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://coding-intl.dashscope.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.7-plus",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-plus",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-plus",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-plus"
    }
}

Pago por uso

Reemplace YOUR_API_KEY con la Clave API de Alibaba Cloud Model Studio. Para consultar los modelos disponibles, véase API compatible con Anthropic.

Establezca ANTHROPIC_BASE_URL según la región. La clave API debe coincidir con la región seleccionada, y debe reemplazar WorkspaceId con su ID de espacio de trabajo real:

• Norte de China 2 (Beijing): https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic
• Singapur: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
• EE. UU. (Virginia): https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/apps/anthropic

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-max",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-max",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-max",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-max"
    }
}

Después de guardar la configuración, abra una nueva terminal y ejecute claude "hello". Una respuesta del modelo confirma que la configuración funciona correctamente. Para verificarlo más a fondo, ejecute /status en Claude Code y compruebe que ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN apunten a la dirección de Model Studio.

Configurar el tamaño de la ventana de contexto

Claude Code utiliza una ventana de contexto de 200K de forma predeterminada. Para manejar bases de código grandes o conversaciones largas, puede ampliar la ventana de contexto a 1M (1,000,000 tokens), siempre que el modelo admita esa longitud de contexto. Hay dos métodos de configuración disponibles:

Agregue CLAUDE_CODE_MAX_CONTEXT_TOKENS al campo env en ~/.claude/settings.json:

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus",
        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1000000"
    }
}

Anexe [1m] al nombre del modelo. Esto funciona con modelos de Model Studio que admiten una ventana de contexto de 1M:

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus[1m]",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-plus[1m]",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-plus[1m]",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-plus[1m]"
    }
}

Después de modificar la configuración, abra una nueva ventana de terminal para reiniciar Claude Code y que los cambios surtan efecto. Para obtener más detalles sobre las variables de entorno, consulte la documentación oficial de variables de entorno de Claude Code.

Modos de permisos

Claude Code proporciona seis modos de permisos que controlan si aparece un mensaje de confirmación antes de que una herramienta realice una operación. La siguiente tabla describe el comportamiento de cada modo.

Indicador de línea de comandos

Use --permission-mode para establecer el modo de permisos predeterminado para una sesión:

claude --permission-mode plan
claude --permission-mode acceptEdits

Comando interactivo

Ingrese /permissions en una sesión para administrar dinámicamente las reglas de aprobación previa y denegación previa para herramientas. Puede configurar reglas de aprobación automática para las herramientas bash, edit y MCP.

Configuración de settings.json

Configure el campo permissions en ~/.claude/settings.json (ruta de Windows: C:\Users\<username>\.claude\settings.json), el mismo archivo de configuración que contiene sus credenciales de acceso:

{
    "permissions": {
        "allow": ["Bash(git:*)", "Read", "Edit"],
        "deny": ["Bash(rm:*)"],
        "defaultMode": "default"
    }
}

El campo allow aprueba automáticamente las llamadas a herramientas coincidentes, y el campo deny rechaza automáticamente las llamadas a herramientas coincidentes. Ambos campos admiten comodines. Por ejemplo, Bash(npm:*) coincide con todos los comandos que comienzan con npm. El campo defaultMode establece el modo de permisos predeterminado para la sesión y acepta cualquiera de los modos listados en la tabla anterior.

Uso de CC Switch

CC Switch es una GUI de escritorio de código abierto de la comunidad para gestionar múltiples claves API o planes de facturación. Cambie entre proveedores con un solo clic, sin necesidad de editar settings.json manualmente.

Instalar CC Switch

• macOS: brew tap farion1231/ccswitch && brew install --cask cc-switch, o descargue el archivo .dmg desde Releases.
• Windows: descargue el instalador .msi o el archivo portable .zip desde Releases.
• Linux: en Arch, ejecute paru -S cc-switch-bin; en otras distribuciones, descargue .deb / .rpm / .AppImage desde Releases.

Agregar un proveedor

1. En la interfaz principal de CC Switch, seleccione Claude Code en la barra de iconos superior (el icono de estrella naranja), luego haga clic en + en la esquina superior derecha para abrir Add New Provider. Complete los campos basándose en la tabla a continuación, luego haga clic en Add.

   Plan de facturación	Configuración
   Token Plan Personal Edition	Nombre del proveedor: Bailian-Token Plan Personal Edition API Key: obtener desde la consola Endpoint: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
   Token Plan Team Edition	Nombre del proveedor: Bailian-Token Plan Team Edition API Key: obtener desde la consola Endpoint: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
   Coding Plan	Nombre del proveedor: Bailian-Coding Plan API Key: obtener desde la consola Endpoint: https://coding-intl.dashscope.aliyuncs.com/apps/anthropic
   Pago por uso	Nombre del proveedor: Bailian-Pay-as-you-go Clave API: Clave API de Model Studio Endpoint: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

2. Expanda Opciones avanzadas para configurar la asignación de modelos. Establezca el modelo principal y los modelos predeterminados de Haiku, Sonnet y Opus en los modelos compatibles para su plan. Asignación de ejemplo:

   • Modelo principal: qwen3.7-max (no compatible con Coding Plan)
   • Modelo predeterminado de Haiku: qwen3.6-flash (no compatible con Coding Plan)
   • Modelo predeterminado de Sonnet: qwen3.7-max (no compatible con Coding Plan)
   • Modelo predeterminado de Opus: qwen3.7-max (no compatible con Coding Plan)

3. Regrese a la interfaz principal, haga clic en Enable junto al proveedor y luego inicie una nueva sesión de Claude Code para que la configuración surta efecto.

Conectar Claude Code Desktop

Claude Code Desktop (Claude Desktop) y la CLI de Claude Code son dos puntos de entrada separados, mostrados en CC Switch como los paneles Claude Code y Claude Desktop respectivamente. La aplicación de escritorio accede a Model Studio a través de la puerta de enlace local de CC Switch: CC Switch escribe automáticamente tanto la dirección de la puerta de enlace como el token de autenticación en la configuración de escritorio, por lo que usted no debe ingresar su API Key de Model Studio en la aplicación de escritorio. La API Key de Model Studio se ingresa únicamente en la configuración del proveedor de CC Switch y se inyecta automáticamente cuando el enrutador local reenvía la solicitud.

1. Instale Claude Code Desktop desde la página de descargas de Claude.
2. En CC Switch, cambie al panel de Claude Desktop desde el selector de aplicaciones en la izquierda. Si la entrada no se muestra, vaya a Configuración > General y asegúrese de que Claude Desktop no esté oculto bajo la visibilidad de aplicaciones.
3. Agregue el proveedor de Model Studio: si ya ha configurado un proveedor de Model Studio en el panel Claude Code, haga clic en Import existing providers from Claude Code para reutilizarlo; de lo contrario, haga clic en + en la esquina superior derecha para agregar uno. Dado que los ID de modelo de Model Studio (como qwen3.7-max) no son los tres ID de rol que reconoce Claude Desktop (claude-sonnet-* / claude-opus-* / claude-haiku-*), active Necesita asignación de modelos y asigne los roles Sonnet, Opus y Haiku a los modelos reales de Model Studio que desea solicitar (por ejemplo, Sonnet > qwen3.7-max).
4. Habilite el enrutamiento local: vaya a Configuración > Enrutamiento > Enrutamiento local y active Mostrar alternancia de enrutamiento en la página principal; regrese al panel de Claude Desktop y active el interruptor de Enrutamiento local de Claude Desktop. La dirección de escucha predeterminada es 127.0.0.1:15721.
5. Haga clic en Enable en la tarjeta del proveedor. CC Switch escribe automáticamente la configuración de inferencia de terceros en Claude Code Desktop.
6. Mantenga CC Switch en ejecución y luego cierre y reinicie completamente Claude Code Desktop para que los cambios surtan efecto. Seleccione el modelo configurado en el menú de modelos para comenzar a usarlo.

Complementos de IDE para Claude Code

Después de completar la configuración de CLI anterior, instale el complemento de Claude Code en su IDE. El complemento reutiliza directamente la configuración en settings.json.

VS Code

1. Busque Claude Code for VS Code en el marketplace de extensiones e instálelo.
2. Reinicie VS Code y haga clic en el icono en la esquina superior derecha para abrir Claude Code.
3. Escriba / en el cuadro de diálogo, seleccione General config y configure el modelo en Selected Model.

JetBrains

1. Busque Claude Code en el marketplace de extensiones e instálelo.
2. Reinicie el IDE y haga clic en el icono de la esquina superior derecha para comenzar a usarlo.

FAQ

Códigos de error

Si encuentra errores durante la configuración, consulte la documentación de preguntas frecuentes correspondiente a su plan de facturación:

• Pago por uso: API compatible con Anthropic - Códigos de error
• Coding Plan: Preguntas frecuentes sobre Coding Plan
• Token Plan Personal Edition: Preguntas frecuentes sobre Token Plan
• Token Plan Team Edition: Preguntas frecuentes sobre Token Plan Team Edition

Las solicitudes devuelven 401 invalid_api_key

El tipo de clave API no coincide con ANTHROPIC_BASE_URL. Model Studio proporciona tres métodos de acceso, y cada método utiliza una URL base diferente y una clave API dedicada.

Pasos de solución de problemas:

1. Verifique la URL de la solicitud. Compruebe ANTHROPIC_BASE_URL en ~/.claude/settings.json.
2. Confirme el tipo de clave API. Con la tabla anterior, confirme que su tipo de clave API coincide con la URL base.
3. Corrija la configuración. Cuando utilice una clave API de pago por uso de Model Studio, establezca ANTHROPIC_BASE_URL en https://dashscope.aliyuncs.com/apps/anthropic.

Después de iniciar Claude Code, la interfaz muestra "No se puede conectar a los servicios de Anthropic. Error al conectar a api.anthropic.com: ERR_BAD_REQUEST"

Claude Code se está conectando al servicio oficial de Anthropic en lugar de a Alibaba Cloud Model Studio. Esto generalmente significa que faltan variables de entorno o que no han surtido efecto. Siga estos pasos:

1. Verifique la configuración. Ejecute el comando /status después de iniciar Claude Code. Verifique que ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN apunten 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 de settings.json.
2. Verifique hasCompletedOnboarding. Confirme que hasCompletedOnboarding esté establecido en true en ~/.claude.json. Sin esto, Claude Code intenta conectarse al servicio oficial de Anthropic para la verificación de inicio de sesión al arrancar.
3. Abra una nueva terminal. Después de editar el archivo de configuración, abra una nueva ventana de terminal y ejecute claude para que los cambios surtan efecto.
4. 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@latest para actualizar a la versión más reciente y vuelva a intentarlo.

CC Switch reporta "No se encontró ningún endpoint de lista de modelos disponible. Verifique la URL base o confirme que el proveedor ha abierto el puerto" al agregar un proveedor

Este mensaje proviene de la verificación de conectividad que ejecuta CC Switch al guardar un proveedor: sondea un endpoint de lista de modelos (como /v1/models) contra la URL de solicitud configurada. El endpoint compatible con Anthropic de Model Studio (que termina en /apps/anthropic) solo proporciona el endpoint de mensajes /v1/messages y no ofrece un endpoint de lista de modelos, por lo que el sondeo devuelve 404 y CC Switch reporta "No se encontró ningún endpoint de lista de modelos disponible".

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 utiliza se especifican directamente mediante la asignación de modelos en las Opciones avanzadas de CC Switch, sin depender del descubrimiento automático desde un endpoint de lista de modelos. Cuando la URL de solicitud y la API Key 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 la solicitud termine en /apps/anthropic sin un /v1 adicional, y que haya completado los modelos compatibles con su plan en la asignación de modelos en Opciones avanzadas.

La asignación de modelos en CC Switch devuelve AccessDenied

Si las llamadas al modelo fallan en Claude Code con un error AccessDenied (HTTP 403, código: access_denied) después de configurar la asignación de modelos, verifique si el modelo está marcado como Próxima descontinuación en la consola de Model Studio > Model Gallery. Los modelos marcados para próxima descontinuación siguen apareciendo en la lista, pero las llamadas a la API devuelven 403 AccessDenied. Siga estos pasos:

1. Compruebe si el modelo está marcado para descontinuación. En la consola de Model Studio > Model Gallery, busque el modelo que está utilizando y verifique su etiqueta de estado.
2. Cambie al modelo disponible más reciente. Reemplace el modelo heredado (como qwen-coder-turbo-0919) en la asignación de modelos por el modelo disponible más reciente (como qwen3.7-plus).
3. Vuelva a configurar la asignación de modelos y pruebe. Actualice la asignación de modelos en Opciones avanzadas en CC Switch, haga clic en Enable e inicie una nueva sesión de Claude Code para verificar.