Your privacy choices

Allow optional cookies for referral attribution, visit analytics, and Google Ads purchase measurement.

Guía de despliegue de Claude Code

Incluye la instalación, la inicialización, la conexión mediante proxy, los errores habituales y el proceso completo de despliegue.

Consulta primero la documentación oficial: docs.claude.com

📋 Requisito previo
Completa primero la instalación del entorno de Node.js y asegúrate de que Node.js 18+ esté instalado correctamente.

⚡ Lectura obligatoria para la primera instalación: omitir el error de inicialización

Al usar un canal intermediario, Claude Code mostrará el siguiente error durante el primer inicio:

La imagen muestra el mensaje de error que aparece durante el primer inicio de Claude Code. El fondo es negro y el texto aparece en rojo y blanco. Después de «Welcome to Claude Code», se muestran «Unable to connect to Anthropic services» y «Failed to connect to api.anthropic.com: ERR_BAD_REQUEST», junto con una indicación para revisar la conexión a Internet y la configuración de red. Al final también se señala que Claude Code podría no estar disponible en tu país y se incluye el enlace al sitio web oficial. La imagen está relacionada con el error que aparece durante la primera instalación de Claude Code y presenta de forma visual su contenido.La imagen muestra el mensaje de error que aparece durante el primer inic…

Welcome to Claude Code
Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

Esto ocurre porque, durante el primer inicio, Claude Code intenta conectarse a la API oficial para confirmar la inicialización, un paso que no se puede completar mediante un canal intermediario. Después de terminar la instalación y antes del primer inicio, utiliza uno de los siguientes métodos para omitirlo:

Método uno: omitirlo con CC-Switch (recomendado)

Descarga desde la página de descarga de CC-Switch el instalador más reciente para macOS o Windows. Abre la herramienta de configuración CC-Switch, ve a Ajustes → General y activa la opción «Omitir la confirmación de la instalación inicial de Claude Code».

La imagen muestra la pestaña «General» de la página de ajustes de la herramienta de configuración CC-Switch. Entre las distintas opciones, «Omitir la confirmación de la instalación inicial de Claude Code» aparece resaltada con un recuadro rojo y su interruptor está activado. La imagen está relacionada con la sección «Método uno: omitirlo con CC-Switch (recomendado)» y explica que, después de terminar la instalación y antes del primer inicio, basta con abrir CC-Switch, ir a Ajustes → General y activar esta opción para omitir la confirmación de la instalación inicial de Claude Code.La imagen muestra la pestaña «General» de la página de ajustes de la her…

Método dos: modificar manualmente el archivo de configuración

Busca el archivo ~/.claude.json en el directorio personal del usuario y añade al final el campo "hasCompletedOnboarding": true:

⚠️ Atención al formato JSON
Antes de añadir el campo, agrega una coma inglesa al final del campo anterior; de lo contrario, un formato JSON incorrecto impedirá que Claude Code se inicie.
{
"installMethod": "unknown",
"autoUpdates": true,
"firstStartTime": "2025-07-14T06:11:03.877Z",
"userID": "xxxx",
"projects": {
"/home/your-user": {
"allowedTools": [],
"history": [],
"mcpContextUris": [],
"mcpServers": {},
"enabledMcpjsonServers": [],
"disabledMcpjsonServers": [],
"hasTrustDialogAccepted": false,
"projectOnboardingSeenCount": 0,
"hasClaudeMdExternalIncludesApproved": false,
"hasClaudeMdExternalIncludesWarningShown": false
}
},
"hasCompletedOnboarding": true
}

Después de guardar los cambios, vuelve a ejecutar claude para usarlo con normalidad.

Fuente de referencia: Omitir la confirmación de inicialización de Claude Code

🚀 Configuración rápida con CC-Switch (recomendado)

Si ya has instalado la herramienta de configuración rápida CC-Switch, puedes gestionar fácilmente la configuración de Claude Code mediante una interfaz gráfica, sin editar manualmente archivos de configuración ni variables de entorno.

Ventajas de CC-Switch

  • Interfaz gráfica sencilla e intuitiva
  • Cambio con un clic entre las configuraciones de distintos proveedores
  • Gestión automática de las variables de entorno y los archivos de configuración
  • Copia de seguridad y restauración de la configuración
  • Cambio de configuración sin reiniciar el terminal

Pasos de configuración

  1. Inicia CC-Switch y añade una configuración de Claude Code

La imagen muestra la interfaz para añadir una nueva configuración en la aplicación CC-Switch. En la parte superior aparecen las pestañas «Proveedor de Claude» y «Proveedor unificado», con «Proveedor de Claude» seleccionada. Debajo se encuentran las secciones «Proveedor predefinido» y «Configuración personalizada», y esta última está resaltada con un recuadro rojo. La imagen corresponde al paso «Inicia CC-Switch y añade una configuración de Claude Code» y presenta de forma visual dónde seleccionar una configuración personalizada al añadir una configuración de Claude Code en CC-Switch.La imagen muestra la interfaz para añadir una nueva configuración en la…

  • Abre la aplicación CC-Switch
  • Haz clic en la pestaña «Claude» de la parte superior
  • Haz clic en el botón naranja «+» de la esquina superior derecha para añadir una nueva configuración

La imagen muestra la interfaz para añadir una nueva configuración en la aplicación CC-Switch. El valor de «API Key» aparece oculto y se indica que es la key proporcionada por el servicio de atención al cliente que comienza por «sk». En «Dirección de solicitud» aparece «https://gpt-agent.cc», junto con un cuadro de aviso amarillo que indica que se debe introducir la dirección del endpoint del servicio compatible con la API de Claude sin una barra al final. La imagen está relacionada con el paso «Completa la información de configuración del proveedor» y presenta un ejemplo de cómo rellenar la API Key y la dirección de solicitud.La imagen muestra la interfaz para añadir una nueva configuración en la…

  1. Completa la información de configuración del proveedor
  • Nombre del proveedor: un nombre personalizado (por ejemplo, "guizhou")
  • API Base URL: introduce https://api.llm-token.cn
  • API Key: pega el token específico para Claude que obtuviste en la plataforma
  • Selección del modelo: elige un modelo de Claude disponible según tus necesidades
  • Haz clic en el botón «Guardar»
💡 Consejo
  • Puedes añadir varias configuraciones de proveedores diferentes (por ejemplo, la oficial, Nube de Guizhou ☁️, etc.)
  • CC-Switch modificará automáticamente el archivo de configuración ~/.claude/settings.json
  • Después de cambiar de configuración, cierra y reinicia Claude Code para aplicar los cambios
  1. Activa la configuración y úsala
  • Busca la configuración «gptagent» que acabas de crear en la lista de configuraciones
  • Haz clic en el botón «En uso» situado a la derecha de la configuración (o directamente en la tarjeta de configuración)
  • La configuración quedará marcada como «En uso» (etiqueta verde)
  • Reinicia Claude Code para aplicar la nueva configuración
  1. Cambio rápido desde la bandeja del sistema

CC-Switch permite cambiar rápidamente de configuración desde la bandeja del sistema:

  • Haz clic con el botón derecho en el icono de CC-Switch de la bandeja del sistema
  • Selecciona la categoría Claude en el menú
  • Selecciona directamente la configuración que quieras activar
  • La configuración se aplica de inmediato, sin abrir la interfaz principal
⚠️ Avisos
  • Después de cambiar de configuración, es necesario reiniciar Claude Code para que se aplique
  • Puedes probar la velocidad del endpoint de la API en CC-Switch y elegir la mejor configuración

¿No puedes chatear después de configurarlo?

Prueba lo siguiente y, si aun así no funciona, ponte en contacto con el servicio de atención al cliente

La imagen muestra la interfaz de CC Switch, con el título «CC Switch» y varios iconos en la parte superior. Una flecha roja señala la opción «Computación en la nube de Guizhou», a cuya derecha aparece la dirección «https://gpt-agent.cc/» junto con el aviso «Error de consulta». La imagen está relacionada con el contenido «¿No puedes chatear después de configurarlo? Prueba lo siguiente y, si aun así no funciona, ponte en contacto con el servicio de atención al cliente» y puede servir para indicar que, si se produce un problema en la configuración de CC Switch, se puede hacer clic en esta opción para revisarlo o solicitar ayuda.La imagen muestra la interfaz de CC Switch, con el título «CC Switch» y…

La imagen muestra la interfaz de ajustes de CC Switch en la pestaña «Proxy». El estado de «Proxy local» aparece como «En ejecución» y una flecha azul señala este estado. También se muestran opciones como «Conmutación automática por error», «Rectificador» y «Proxy de salida global». La imagen está relacionada con la sección «¿No puedes chatear después de configurarlo? Prueba lo siguiente y, si aun así no funciona, ponte en contacto con el servicio de atención al cliente» y puede servir para orientar al usuario a comprobar el estado del servicio proxy de CC Switch para diagnosticar problemas de configuración.La imagen muestra la interfaz de ajustes de CC Switch en la pestaña «Pro…

La imagen muestra el contenido de la pestaña «Código» de la página de ajustes de la guía de despliegue de Claude Code. En la parte superior aparecen opciones como «Volver al inicio» y «Acerca de». La información principal incluye lo siguiente: en el proxy local de la versión para lenguajes populares se pueden seleccionar modelos de esa versión para el desarrollo con despliegue local; el interruptor del proxy está activado; en la sección de código, el modelo Claude está activado, mientras que los modelos Codex y Gemini no lo están; también aparecen ajustes como la dirección de la API, la clave de la API y el registro de la aplicación, cuyo interruptor está activado. La imagen está relacionada con la solución para los casos en los que no se puede chatear después de configurar el servicio y presenta de forma visual los ajustes de la página.La imagen muestra el contenido de la pestaña «Código» de la página de aj…

⌨️ Configuración manual mediante la línea de comandos

Si no usas CC-Switch, también puedes configurar Claude Code manualmente desde la línea de comandos.

🖥️ Windows

Requisitos del sistema

Windows 10, 11

Pasos de instalación

Método uno: Native Install (recomendado)

Con PowerShell:

irm https://claude.ai/install.ps1 | iex

Con CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Método dos: instalación mediante NPM (no recomendado)

⚠️ No se recomienda la instalación mediante npm
Las actualizaciones del canal npm llegan con retraso y la versión instalada suele ser antigua, por lo que se recomienda usar primero el método Native anterior.
npm install -g @anthropic-ai/claude-code

Comprobar la instalación:

claude --version

Configurar las variables de entorno

Con PowerShell:

[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxx", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.llm-token.cn", "User")

Con CMD:

setx ANTHROPIC_AUTH_TOKEN "sk-xxx"
setx ANTHROPIC_BASE_URL "https://api.llm-token.cn"
💡 Consejo
Recuerda sustituir sk-xxx por tu propia clave. Después de configurarla, reinicia el terminal para aplicar las variables de entorno.
  • Iniciar Claude

En el terminal, accede al directorio del proyecto (con cd) o permanece en cualquier otro directorio e introduce el comando claude para iniciarlo.

🍏 macOS

Requisitos del sistema

MacOS 10.15 (Catalina) o una versión posterior

Pasos de instalación

Método uno: Homebrew (recomendado)

brew install --cask claude-code

Método dos: Curl Script

curl -fsSL https://claude.ai/install.sh | bash

Método tres: instalación mediante NPM (no recomendado)

⚠️ No se recomienda la instalación mediante npm
Las actualizaciones del canal npm llegan con retraso y la versión instalada suele ser antigua, por lo que se recomienda usar primero el método Native anterior.
npm install -g @anthropic-ai/claude-code

Comprobar la instalación

claude -v

En condiciones normales, debería mostrarse algo similar a: 1.0.108 (Claude Code)

Configurar las variables de entorno

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.llm-token.cn"' >> ~/.zshrc
source ~/.zshrc
💡 Consejo
Recuerda sustituir sk-xxx por tu propia clave.

Reiniciar el terminal e iniciar Claude

Después de reiniciar el terminal, accede al directorio del proyecto (con cd) o permanece en cualquier otro directorio e introduce el comando claude para iniciarlo.

🐧 Linux

Requisitos del sistema

Distribución de Linux (Ubuntu 18.04+, CentOS 7+, Debian 9+, etc.)

Pasos de instalación

Método uno: Curl Script (recomendado)

curl -fsSL https://claude.ai/install.sh | bash

Método dos: instalación mediante NPM (no recomendado)

⚠️ No se recomienda la instalación mediante npm
Las actualizaciones del canal npm llegan con retraso y la versión instalada suele ser antigua, por lo que se recomienda usar primero el método Native anterior.
npm install -g @anthropic-ai/claude-code

Comprobar la instalación

claude -v

Configurar las variables de entorno

Ubuntu/Debian (Bash)

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://api.llm-token.cn"' >> ~/.bashrc
source ~/.bashrc

Fedora/CentOS (Zsh)

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.llm-token.cn"' >> ~/.zshrc
source ~/.zshrc
💡 Consejo
Recuerda sustituir sk-xxx por tu propia clave.

Reiniciar el terminal e iniciar Claude

Después de reiniciar el terminal, accede al directorio del proyecto (con cd) o permanece en cualquier otro directorio e introduce el comando claude para iniciarlo.

Problemas frecuentes

¿Aparece un mensaje que indica que no se encuentra el comando?

  • Confirma que Claude Code esté instalado correctamente
  • Comprueba la variable de entorno PATH
  • Reinicia la ventana del terminal

¿Falla la conexión?

  • Comprueba la conexión de red
  • Confirma que la API Key sea correcta
  • Comprueba que el saldo sea suficiente

Tutorial de configuración de Cherry Studio

Capturas de pantalla que muestran dónde introducir el proveedor personalizado, la Base URL y la API Key.

Guía de despliegue de Codex

Explica la instalación de la herramienta CLI, la conexión con la API y la configuración del entorno de desarrollo.

Secciones de esta página

⚡ Lectura obligatoria para la primera instalación: omitir el error de inicializaciónMétodo uno: omitirlo con CC-Switch (recomendado)Método dos: modificar manualmente el archivo de configuración🚀 Configuración rápida con CC-Switch (recomendado)Ventajas de CC-SwitchPasos de configuración¿No puedes chatear después de configurarlo?⌨️ Configuración manual mediante la línea de comandos🖥️ WindowsRequisitos del sistemaPasos de instalaciónConfigurar las variables de entorno🍏 macOSRequisitos del sistemaPasos de instalaciónComprobar la instalaciónConfigurar las variables de entornoReiniciar el terminal e iniciar Claude🐧 LinuxRequisitos del sistemaPasos de instalaciónComprobar la instalaciónConfigurar las variables de entornoReiniciar el terminal e iniciar ClaudeProblemas frecuentes¿Aparece un mensaje que indica que no se encuentra el comando?¿Falla la conexión?