> ## Documentation Index
> Fetch the complete documentation index at: https://gccai.heqingsong.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Uso de GccAi en Claude Code

> Una guía detallada sobre cómo configurar y usar los servicios de API de GccAi en el CLI de Claude Code, permitiéndole acceder a múltiples modelos de IA para programación asistida con una configuración sencilla.

![Claude Code Main Interface](https://mintcdn.com/apicore/_4UKBib4iqrgK4Ws/images/integrations/claude-code/claude-code-cli.png?fit=max\&auto=format\&n=_4UKBib4iqrgK4Ws\&q=85\&s=219739f4029aa915b90253ad02b01437)

## Requisitos previos

Claude Code es un asistente de programación de IA en línea de comandos de Anthropic que admite conversación directa con IA, generación de código y depuración en el terminal.
Al conectarse a GccAi, puede usar múltiples modelos, incluidos GPT, Claude y Gemini, dentro de Claude Code.

Antes de comenzar, asegúrese de tener:

1. **Una clave de API de GccAi**
   Acceda a la [Consola de GccAi](https://gccai.heqingsong.uk/keys) para obtener su clave de API (comienza con `sk-`)

> [!NOTE]
>
> **Consejo:** Si aún no tiene una cuenta en GccAi, regístrese primero en [GccAi](https://gccai.heqingsong.uk) y obtenga su clave de API.

## Paso 1: Instalar Claude Code

Elija uno de los siguientes métodos para instalar:

**macOS / Linux (Recomendado)**

Instale con el script oficial:

```bash theme={null}
curl -fsSL https://claude.ai/install.sh | bash
```

O instale mediante Homebrew:

```bash theme={null}
brew install --cask claude-code
```

> [!NOTE]
>
> Si encuentra problemas de permisos, anteponga `sudo` al comando.

**Windows**

**PowerShell:**

```powershell theme={null}
irm https://claude.ai/install.ps1 | iex
```

**CMD:**

```cmd theme={null}
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```

**Instalación con NPM**

Si tiene Node.js 18 o una versión más reciente instalada, puede instalar mediante npm:

```bash theme={null}
npm install -g @anthropic-ai/claude-code
```

Funciona en todos los sistemas operativos.

### Verificar la instalación

Tras la instalación, ejecute el siguiente comando para confirmar:

```bash theme={null}
claude --version
```

Si se muestra un número de versión (por ejemplo, `1.x.x`), la instalación fue correcta.

## Paso 2: Configurar la API de GccAi

Hay tres métodos de configuración disponibles. Elija el que mejor se adapte a su flujo de trabajo.

### Método 1: Editar settings.json (recomendado)

El enfoque más estable: configúrelo una vez y persistirá.

**1. Localice el directorio de configuración:**

* Windows: Pulse `Win + R`, introduzca `%userprofile%\.claude`
* macOS: Pulse `Command + Shift + G`, introduzca `~/.claude`
* Linux: Navegue a `~/.claude`

> [!NOTE]
>
> Si el directorio no existe, ejecute `claude` una vez en el terminal y pulse `Ctrl + C` para salir; el directorio se creará automáticamente.

**2. Cree o edite el archivo `settings.json`:**

```json theme={null}
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gccai.heqingsong.uk",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "claude-opus-5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
```

| Parámetro | Descripción |
| - | - |
| `ANTHROPIC_BASE_URL` | Dirección de la API de GccAi, fija como `https://gccai.heqingsong.uk` |
| `ANTHROPIC_AUTH_TOKEN` | Su clave de API de GccAi (comienza con `sk-`) |
| `ANTHROPIC_MODEL` | Modelo predeterminado a usar, elija de la lista de modelos a continuación |
| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Establezca en `1` para reducir las solicitudes de red no esenciales |

Guarde el archivo y reinicie Claude Code para aplicar los cambios.

### Método 2: Variables de entorno permanentes

Escriba la configuración en el entorno del sistema para que todas las ventanas de terminal la carguen automáticamente.

**macOS (zsh)**

```bash theme={null}
echo 'export ANTHROPIC_BASE_URL="https://gccai.heqingsong.uk"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-opus-5"' >> ~/.zshrc
source ~/.zshrc
```

**macOS / Linux (bash)**

```bash theme={null}
echo 'export ANTHROPIC_BASE_URL="https://gccai.heqingsong.uk"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.bashrc
echo 'export ANTHROPIC_MODEL="claude-opus-5"' >> ~/.bashrc
source ~/.bashrc
```

**Windows**

**Opción A: Configuración por interfaz gráfica**

1. Haga clic derecho en "Este equipo" → "Propiedades" → "Configuración avanzada del sistema" → "Variables de entorno"
2. Agregue nuevas variables de usuario:
   * `ANTHROPIC_BASE_URL` = `https://gccai.heqingsong.uk`
   * `ANTHROPIC_API_KEY` = `sk-xxxxxxxxxxxx`
   * `ANTHROPIC_MODEL` = `claude-opus-5`
3. Reinicie el terminal

**Opción B: Comandos de PowerShell**

```powershell theme={null}
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://gccai.heqingsong.uk', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-xxxxxxxxxxxx', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'claude-opus-5', 'User')
```

### Método 3: Variables de entorno temporales

Adecuado para pruebas rápidas: la configuración se pierde al cerrar el terminal.

**macOS / Linux**

```bash theme={null}
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"
export ANTHROPIC_MODEL="claude-opus-5"
export ANTHROPIC_BASE_URL="https://gccai.heqingsong.uk"
claude
```

**Windows (PowerShell)**

```powershell theme={null}
$env:ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"
$env:ANTHROPIC_MODEL="claude-opus-5"
$env:ANTHROPIC_BASE_URL="https://gccai.heqingsong.uk"
claude
```

**Windows (CMD)**

```cmd theme={null}
set ANTHROPIC_API_KEY=sk-xxxxxxxxxxxx
set ANTHROPIC_MODEL=claude-opus-5
set ANTHROPIC_BASE_URL=https://gccai.heqingsong.uk
claude
```

> [!WARNING]
>
> Las variables de entorno temporales solo funcionan en la ventana de terminal actual. Tendrá que definirlas de nuevo después de cambiar de ventana o cerrar el terminal.

## Paso 3: Comenzar a usar

### Verificar la configuración

Inicie Claude Code y envíe un mensaje simple para confirmar:

```bash theme={null}
claude "Hello"
```

Si recibe una respuesta de IA, la configuración se realizó correctamente. Si ve errores `401`, `403` u otros, consulte las preguntas frecuentes a continuación.

### Modos de uso

Claude Code ofrece dos modos de interacción:

* **Modo interactivo**: Ejecute `claude` para una conversación continua, ideal para tareas complejas
* **Comando único**: Ejecute `claude "su pregunta"` para una respuesta única, ideal para consultas rápidas

### Modelos compatibles

GccAi admite la serie completa de modelos Claude. Puede cambiar de forma flexible según sus necesidades:

| Nombre del modelo | Características | Uso recomendado |
| - | - | - |
| `claude-opus-5` | Modelo insignia de nueva generación | Arquitectura compleja, depuración difícil |
| `claude-opus-4-6` | Gran capacidad general | Arquitectura compleja, depuración difícil |
| `claude-sonnet-4-6` | Rendimiento y velocidad equilibrados | Programación diaria, generación de código |
| `claude-opus-4-5-20251101` | Razonamiento avanzado | Código complejo, análisis profundo |
| `claude-sonnet-4-5-20250929` | Excelente capacidad de código | Diseño de algoritmos, optimización de código |
| `claude-haiku-4-5-20251001` | Respuesta ultrarrápida | Preguntas y respuestas rápidas, fragmentos de código |

Todos los modelos anteriores admiten una versión Thinking (razonamiento extendido): añada `-thinking` al ID del modelo, por ejemplo, `claude-opus-4-6-thinking`. El modo Thinking es ideal para tareas complejas que requieren un razonamiento profundo.

> [!TIP]
>
> **Recomendaciones de modelos:**
>
> * 🚀 **Alto rendimiento:** `claude-opus-5`: para los desafíos de código y arquitectura más complejos
> * ⚖️ **Rendimiento equilibrado:** `claude-sonnet-4-6`: para programación diaria
> * ⚡ **Respuesta rápida:** `claude-haiku-4-5-20251001`: cuando necesita comentarios instantáneos
> * 🧠 **Pensamiento profundo:** `claude-opus-5-thinking`: cuando se necesita un razonamiento profundo

Para cambiar de modelo, use el comando `/model` en modo interactivo, o modifique el campo `ANTHROPIC_MODEL` en su configuración y reinicie.

### Comandos comunes

Estos son los comandos y atajos que se usan con frecuencia en Claude Code:

| Comando | Descripción |
| - | - |
| `claude` | Entrar en modo interactivo |
| `claude "pregunta"` | Consulta única |
| `claude --version` | Verificar la versión |
| `/model` | Cambiar de modelo en modo interactivo |
| `/help` | Ver información de ayuda |
| `Ctrl + C` | Salir del modo interactivo |

## Preguntas frecuentes

### Q1: ¿Aún se ve la página de selección de inicio de sesión después de la configuración?

Si "Select login method" sigue apareciendo después del inicio, la configuración no se ha aplicado.

**Pasos para solucionar problemas:**

1. **Uso de settings.json**: Verifique si la ruta del archivo es correcta
   * Windows: `C:\Users\<username>\.claude\settings.json`
   * macOS / Linux: `~/.claude/settings.json`
2. **Uso de variables de entorno**: Asegúrese de haber iniciado Claude Code desde la **misma ventana de terminal** donde definió las variables
3. **Verifique el formato JSON**: Asegúrese de que los corchetes, comas y comillas sean correctos

### Q2: ¿Errores 401 / 403?

| Código de error | Significado | Solución |
| - | - | - |
| `401 Unauthorized` | Clave de API ausente o inválida | Compruebe si la clave es correcta y comienza con `sk-` |
| `403 Forbidden` | Permisos insuficientes o clave expirada | Vaya a la [Consola](https://gccai.heqingsong.uk/keys) para verificar el estado de la clave |

Asegúrese también de que `ANTHROPIC_BASE_URL` esté establecido en `https://gccai.heqingsong.uk`, y no en la dirección oficial de Anthropic.

### Q3: ¿Error "Unable to connect"?

Esto significa que Claude Code no pudo conectarse al servicio de API.

1. Verifique su conexión de red
2. Verifique que `ANTHROPIC_BASE_URL` esté configurado correctamente
3. Si usa un proxy, asegúrese de que permita el acceso a `gccai.heqingsong.uk`

### Q4: ¿Error "Auth conflict"?

Si ve un mensaje como:

```
Auth conflict: Both a token (claude.ai) and an API key (ANTHROPIC_API_KEY) are set.
```

Esto significa que ha iniciado sesión en claude.ai y tiene una API Key configurada al mismo tiempo, lo que provoca un conflicto.

**Solución:** Ejecute `/logout` en el modo interactivo de Claude Code para cerrar sesión en claude.ai, manteniendo solo la configuración de la API Key.

### Q5: ¿Error de max\_tokens al usar modelos que no son de Claude?

Si ve un error como:

```
max_tokens is too large: 32000. This model supports at most 16384 completion tokens.
```

Esto se debe a que Claude Code envía solicitudes con parámetros del modelo Claude por defecto (32000 tokens), mientras que algunos modelos que no son de Claude (por ejemplo, `gpt-4o`) tienen límites de tokens más bajos.

**Solución:** Cambie a un modelo Claude (por ejemplo, `claude-sonnet-4-6`), que es nativamente compatible con Claude Code y no causará este problema.

### Q6: ¿Respuesta lenta?

1. Cambie a un modelo más rápido (por ejemplo, `claude-haiku-4-5-20251001` o `claude-sonnet-4-6`)
2. Acorte sus prompts para reducir la longitud del contexto
3. Verifique las condiciones de su red

### Q7: ¿Cómo cambiar de modelo?

Dos maneras:

1. **En modo interactivo**: Introduzca el comando `/model`
2. **Edite la configuración**: Cambie el campo `ANTHROPIC_MODEL` en `settings.json` o en las variables de entorno, y luego reinicie Claude Code

### Q8: ¿Claude Code lee archivos locales automáticamente?

No. Claude Code requiere que haga referencia a los archivos de forma explícita, y solicitará confirmación antes de realizar operaciones sensibles. Se recomienda usarlo en directorios de proyecto dedicados.

### Q9: ¿Cómo analizar archivos locales con Claude Code?

En modo interactivo, puede hacer referencia a archivos:

* Introduciendo la ruta del archivo directamente
* Arrastrando archivos a la ventana del terminal
* Copiando y pegando el contenido del archivo

### Q10: ¿Cómo verificar el uso y los costos?

Acceda a la [Consola de GccAi](https://gccai.heqingsong.uk/overview) para ver:

* Estadísticas de llamadas a la API
* Detalles de consumo de tokens
* Estadísticas y tendencias de costos

## Soporte

Si encuentra algún problema:

* 📚 [Documentación de GccAi](https://gccai.heqingsong.uk)
* 💬 [Comunidad de Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @GccAi\_](https://x.com/GccAi_)
* 📧 Soporte técnico: [zhihong@gccai.heqingsong.uk](mailto:zhihong@gccai.heqingsong.uk)

***

> **[Comience a usar GccAi](https://gccai.heqingsong.uk)**
>
> ¡Regístrese en GccAi ahora, obtenga su clave de API y experimente el asistente de programación multimodelo en Claude Code!


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.