Skip to main content

Claude Code

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. 1

    Configure the model

    • Token Plan
    • Pay-as-you-go
    • Coding Plan
    Reemplace YOUR_API_KEY con su Token Plan API Key:
    export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
    export ANTHROPIC_BASE_URL="https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic"
    export ANTHROPIC_MODEL="auto"
    export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen3.6-flash"
    export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen3.8-flash"
    export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen4-max-preview"
    export CLAUDE_CODE_SUBAGENT_MODEL="auto"
    export CLAUDE_CODE_MAX_CONTEXT_TOKENS="983616"
    
    Al usar qwen4-max-preview, establezca CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000 si 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. 2

    Verify

    Ejecute el siguiente comando para verificar:
    claude -p "Hello"
    

Configurar con un archivo de configuración

Además de las opciones anteriores, también puede conectarse mediante un archivo de configuración.
  1. 1

    Abrir el archivo de configuración

    • macOS / Linux: ~/.claude/settings.json
    • Windows: C:\Users\<username>\.claude\settings.json
  2. 2

    Agregar la configuración

    • Token Plan
    • Pay-as-you-go
    • Coding Plan
    Reemplace YOUR_API_KEY con su clave API de Token Plan:
    {
        "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": "qwen4-max-preview",
            "CLAUDE_CODE_SUBAGENT_MODEL": "auto",
            "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "983616"
        }
    }
    
  3. 3

    Verificar

    Después de guardar, ejecute el siguiente comando para verificar:
    claude -p "Hello"
    

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:
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus",
        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1000000"
    }
}
Método 2: Usar un sufijo en el nombre del modelo Añada [1m] al nombre del modelo. Esto funciona con los modelos de Model Studio que admiten una ventana de contexto de 1M:
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.ap-southeast-1.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.

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.
Método 1: Opción 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
Método 2: Comando interactivo Ingrese /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:
{
    "permissions": {
        "allow": ["Bash(git:*)", "Read", "Edit"],
        "deny": ["Bash(rm:*)"],
        "defaultMode": "default"
    }
}

Integrar Bailian CLI

  1. 1

    Instalar Bailian CLI

    Please install the Alibaba Cloud Bailian CLI globally: npm install -g bailian-cli
    
  2. 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:
    My API Key is: sk-xxxxxxxxxxxxx
    
  3. 3

    Comenzar

    Describa su tarea en lenguaje natural, por ejemplo:
    Generate 6 Amazon e-commerce hero images for a white wireless Bluetooth headset.
    Generate a 30-second product demo video for a white wireless Bluetooth headset.
    

Códigos de error

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

Preguntas frecuentes

La configuración de pago por uso no cambia: use la clave de API general de Model Studio y la Base URL. Después de comprar un plan de ahorro, se activa automáticamente y el uso elegible se descuenta automáticamente. Consulte Planes de ahorro.

¿Cómo omito la verificación de inicio de sesión oficial de Anthropic?

Edite o cree el archivo ~/.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
}
El tipo de clave de API no coincide con 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

https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

Clave de API de Token Plan

Pay-as-you-go

https://dashscope-intl.aliyuncs.com/apps/anthropic

Clave de API de Model Studio (comienza con sk-)

Coding Plan

https://coding-intl.dashscope.aliyuncs.com/apps/anthropic

Clave de API dedicada de Coding Plan

Pasos de solución de problemas:
  1. Verifique la URL de solicitud. Compruebe ANTHROPIC_BASE_URL en ~/.claude/settings.json.
  2. Confirme el tipo de clave de API. Con la tabla anterior, confirme que el tipo de clave de API coincide con la URL base.
  3. Corrija la configuración. Cuando use una clave de API Pay-as-you-go de Model Studio, establezca ANTHROPIC_BASE_URL en https://dashscope-intl.aliyuncs.com/apps/anthropic.
Claude Code se está conectando al servicio oficial de Anthropic en lugar de a Alibaba Cloud Model Studio. Esto suele significar que faltan las 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 iniciarse.
  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 última versión y vuelva a intentarlo.
La interfaz compatible 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.
Este mensaje proviene de la comprobación de conectividad que CC Switch ejecuta al guardar un proveedor: sondea un endpoint de lista de modelos (como /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.
Si las llamadas de modelo en Claude Code fallan 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 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:
  1. 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.
  2. 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 (como qwen3.8-max).
  3. 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.
Preste atención al ciclo de vida del modelo. Los modelos marcados para próxima obsolescencia en la consola de Model Studio > Model Gallery pueden dejar de estar disponibles en cualquier momento. Puede consultar el estado de disponibilidad de un modelo allí.