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

# Claude Code

> Conecta Claude Code o herramientas tipo Claude CLI a Moxus AI con el endpoint compatible con Anthropic.

Claude Code usa el protocolo Anthropic Messages. Para conectarlo a Moxus AI, no uses el Base URL compatible con OpenAI. Usa `https://moxus.ai` como Base URL de Anthropic y elige un modelo que admita solicitudes compatibles con Claude / Anthropic.

## Valores

| Campo                     | Valor                                                               |
| ------------------------- | ------------------------------------------------------------------- |
| API Key                   | `sk-your-key`                                                       |
| Base URL de Anthropic     | `https://moxus.ai`                                                  |
| URL final de la solicitud | `https://moxus.ai/v1/messages`                                      |
| Modelo                    | Un modelo compatible con Claude o Anthropic desde Modelos y precios |

## Instala Claude Code

Instala primero y luego ejecuta la verificación de versión por separado. No copies el comando de instalación y el de verificación como un solo bloque. Después de instalar, puede que necesites volver a abrir la terminal antes de que `claude` esté disponible.

<Tabs>
  <Tab title="macOS/Linux/WSL">
    Instalar:

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

    Verificar:

    ```bash theme={null}
    claude --version
    ```
  </Tab>

  <Tab title="WindowsPowerShell">
    Instalar:

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

    Si al ejecutar `claude` después aparece que PowerShell bloqueó `claude.ps1`, usa `claude.cmd` directamente en lugar del wrapper `.ps1`.

    Verificar:

    ```powershell theme={null}
    claude.cmd --version
    ```
  </Tab>

  <Tab title="CMD de Windows">
    Descarga el instalador:

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

    Ejecútalo:

    ```batch theme={null}
    install.cmd
    ```

    Elimina el instalador:

    ```batch theme={null}
    del install.cmd
    ```

    Verificar:

    ```batch theme={null}
    claude --version
    ```
  </Tab>

  <Tab title="mpn">
    Instalar:

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

    Verificar:

    ```bash theme={null}
    claude --version
    ```
  </Tab>
</Tabs>

## Recomendado: importar la configuración desde una API key

En la página de API keys de Moxus AI, cada fila de key tiene una acción de Import configuration. Elige Claude Code para generar un script de terminal para la key seleccionada y la dirección actual del sitio.

<Steps>
  <Step title="Abre la página de API keys">
    Ve a la página de API keys de la consola de Moxus AI y busca la key que quieres que use Claude Code.
  </Step>

  <Step title="Abre Import configuration">
    Abre el menú de acciones de esa key, elige Import configuration y luego cambia a `Claude Code`.
  </Step>

  <Step title="Copia el script para tu sistema">
    Usa “macOS / Linux terminal” para macOS, Linux o WSL. Usa “Windows PowerShell” para Windows.
  </Step>

  <Step title="Ejecuta el script directamente en tu terminal">
    Abre tu terminal, pega el script copiado directamente en la misma ventana de terminal y presiona Enter. El script funciona tanto en zsh como en Bash, y la terminal actual puede usar la nueva configuración en cuanto termine.
  </Step>
</Steps>

El script generado hace lo siguiente:

| Sistema             | Qué escribe                                                                                                                                                                             |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| macOS / Linux / WSL | Crea `~/.claude/moxus-code-env.sh`, escribe `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` y `ANTHROPIC_BASE_URL`, y luego agrega un bloque de carga automática a `~/.zshrc` y `~/.bashrc` |
| Windows PowerShell  | Configura las variables de entorno de usuario `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` y `ANTHROPIC_BASE_URL`, y también las configura para la ventana actual de PowerShell          |

<Info>
  Usa el script “macOS / Linux terminal” para macOS, Linux o WSL, y el script de PowerShell para Windows. Ambos se pueden pegar y ejecutar directamente en sus respectivas terminales; no se necesita ningún archivo temporal ni comando adicional.
</Info>

<Warning>
  El script almacena tu API key en un archivo de entorno local o en una variable de entorno de usuario. No compartas capturas de pantalla de la terminal, perfiles de shell ni archivos de entorno que contengan la key.
</Warning>

## Configuración manual: solo en la terminal actual

Usa una variable de entorno temporal si aún no quieres usar Import configuration. Los comandos aplican solo a la ventana de terminal actual y omiten el `~/.claude/settings.json` a nivel de usuario, de modo que una configuración antigua no puede sobrescribir la key que proporcionas.

<Tabs>
  <Tab title="macOS/Linux/WSL">
    ```bash theme={null}
    ANTHROPIC_API_KEY="sk-your-key" \
    ANTHROPIC_AUTH_TOKEN="sk-your-key" \
    ANTHROPIC_BASE_URL="https://moxus.ai" \
    claude --setting-sources project,local
    ```
  </Tab>

  <Tab title="WindowsPowerShell">
    ```powershell theme={null}
    $env:ANTHROPIC_API_KEY="sk-your-key"
    $env:ANTHROPIC_AUTH_TOKEN="sk-your-key"
    $env:ANTHROPIC_BASE_URL="https://moxus.ai"
    claude.cmd --setting-sources "project,local"
    ```
  </Tab>
</Tabs>

`ANTHROPIC_API_KEY` y `ANTHROPIC_AUTH_TOKEN` usan ambas la misma key de Moxus AI para dar soporte a distintas versiones de Claude Code y a clientes compatibles con Anthropic.

## Método final de la solicitud

Después de la configuración, Claude Code sigue enviando solicitudes Anthropic Messages. Moxus AI reemplaza el endpoint y la key:

| Campo                   | Valor                                                          |
| ----------------------- | -------------------------------------------------------------- |
| Método                  | `POST`                                                         |
| URL                     | `https://moxus.ai/v1/messages`                                 |
| Header de autenticación | `x-api-key: sk-your-key`                                       |
| Header de protocolo     | `anthropic-version: 2023-06-01`                                |
| Campo del modelo        | Usa un modelo compatible con Anthropic desde Modelos y precios |

No llama a `https://moxus.ai/v1/chat/completions`, y no usa el estilo de autenticación `Authorization: Bearer ...` compatible con OpenAI.

## Prueba manual

Usa el comando correspondiente a tu terminal para probar la key, el modelo y el endpoint compatible con Anthropic:

<Tabs>
  <Tab title="macOS/Linux/WSL">
    ```bash theme={null}
    curl https://moxus.ai/v1/messages \
      -H "x-api-key: sk-your-key" \
      -H "anthropic-version: 2023-06-01" \
      -H "content-type: application/json" \
      -d '{
        "model": "claude-opus-4-6",
        "max_tokens": 512,
        "messages": [
          {"role": "user", "content": "Introduce Moxus AI in one sentence"}
        ]
      }'
    ```
  </Tab>

  <Tab title="WindowsPowerShell">
    ```powershell theme={null}
    $headers = @{
      "x-api-key" = "sk-your-key"
      "anthropic-version" = "2023-06-01"
    }
    $body = @{
      model = "claude-opus-4-6"
      max_tokens = 512
      messages = @(@{ role = "user"; content = "Introduce Moxus AI in one sentence" })
    } | ConvertTo-Json -Depth 4 -Compress

    Invoke-RestMethod -Method Post -Uri "https://moxus.ai/v1/messages" -Headers $headers -ContentType "application/json" -Body $body
    ```
  </Tab>
</Tabs>

Si la solicitud tiene éxito pero Claude Code falla, confirma que la terminal que lanza Claude Code pueda leer las variables:

<Tabs>
  <Tab title="macOS/Linux/WSL">
    ```bash theme={null}
    echo "$ANTHROPIC_BASE_URL"
    echo "$ANTHROPIC_API_KEY"
    ```
  </Tab>

  <Tab title="WindowsPowerShell">
    ```powershell theme={null}
    echo $env:ANTHROPIC_BASE_URL
    echo $env:ANTHROPIC_API_KEY
    ```
  </Tab>
</Tabs>

No compartas la salida completa del segundo comando.

## Solución de problemas

<AccordionGroup>
  <Accordion title="¿Puedo usar el Base URL de OpenAI para Claude Code?">
    Por lo general no. Claude Code usa el protocolo Anthropic Messages. Configura `https://moxus.ai`, y la herramienta solicitará `/v1/messages`. `https://moxus.ai/v1` es generalmente para clientes compatibles con OpenAI.
  </Accordion>

  <Accordion title="¿Por qué Import configuration configura tanto ANTHROPIC_API_KEY como ANTHROPIC_AUTH_TOKEN?">
    Esto da soporte a distintas versiones de Claude Code y a clientes compatibles con Anthropic. Ambas variables usan la misma API key de Moxus AI.
  </Accordion>

  <Accordion title="¿Cómo elimino la configuración de Moxus AI para Claude Code?">
    Estos comandos eliminan el archivo de entorno de Moxus AI, los marcadores de carga automática del shell y las variables de entorno de usuario creadas por Import configuration. No eliminan otras configuraciones de Claude Code.

    macOS / Linux / WSL:

    ```bash theme={null}
    rm -f "$HOME/.claude/moxus-code-env.sh"

    for profile in "$HOME/.zshrc" "$HOME/.bashrc"; do
      [ -f "$profile" ] || continue
      sed -i.bak '/# Moxus AI Claude Code start/,/# Moxus AI Claude Code end/d' "$profile"
    done

    unset ANTHROPIC_API_KEY ANTHROPIC_AUTH_TOKEN ANTHROPIC_BASE_URL
    ```

    Windows PowerShell:

    ```powershell theme={null}
    [Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", $null, "User")
    [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, "User")
    [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", $null, "User")

    Remove-Item Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue
    Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue
    Remove-Item Env:ANTHROPIC_BASE_URL -ErrorAction SilentlyContinue
    ```

    Luego cierra y vuelve a abrir la terminal. Si agregaste manualmente estos valores a `~/.claude/settings.json`, elimina solo las entradas `env` correspondientes y conserva el resto del archivo de configuración.
  </Accordion>

  <Accordion title="Claude sigue solicitando directamente a Anthropic">
    Cierra y vuelve a abrir la terminal, y luego confirma que `ANTHROPIC_BASE_URL` sea `https://moxus.ai`. Si lanzas el cliente desde una GUI, puede que no lea los perfiles de shell. Inícialo desde la terminal o usa la propia superficie de configuración del cliente.
  </Accordion>

  <Accordion title="¿Cómo puedo hacer que las variables de la terminal tengan prioridad sobre settings.json?">
    El bloque `env` en `~/.claude/settings.json` puede sobrescribir variables de terminal con los mismos nombres. Elige la opción que se ajuste a tu caso de uso:

    * **Priorizar solo esta terminal**: omite la configuración de usuario al iniciar mientras sigues cargando la configuración de proyecto y local:

      macOS / Linux / WSL:

      ```bash theme={null}
      ANTHROPIC_API_KEY="sk-your-key" ANTHROPIC_AUTH_TOKEN="sk-your-key" ANTHROPIC_BASE_URL="https://moxus.ai" claude --setting-sources project,local
      ```

      Windows PowerShell:

      ```powershell theme={null}
      $env:ANTHROPIC_API_KEY="sk-your-key"
      $env:ANTHROPIC_AUTH_TOKEN="sk-your-key"
      $env:ANTHROPIC_BASE_URL="https://moxus.ai"
      claude.cmd --setting-sources "project,local"
      ```

      Esto no carga `~/.claude/settings.json`, de modo que un endpoint antiguo o un valor vacío en ese archivo no puede sobrescribir la terminal. Las preferencias de usuario en ese archivo, como el tema y las preferencias de modelo, tampoco se cargan.

    * **Usar Moxus AI de forma persistente**: usa Import configuration desde la página de API keys. Si `~/.claude/settings.json` todavía contiene valores antiguos, elimina o actualiza solo las entradas conflictivas `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` y `ANTHROPIC_BASE_URL`. Conserva todas las configuraciones personales no relacionadas y ejecuta `claude` normalmente después.

    Claude Code no ofrece un interruptor que haga que las variables de shell tengan automáticamente prioridad sobre todos los archivos de configuración. `--settings` puede sobrescribir configuraciones para un solo lanzamiento, pero no coloques una API key en ese argumento.
  </Accordion>

  <Accordion title="Windows PowerShell dice que ejecutar claude.ps1 está deshabilitado">
    Esto es la política de ejecución de PowerShell bloqueando `claude.ps1`, no una instalación de Claude dañada. La solución más simple es usar:

    ```powershell theme={null}
    claude.cmd --version
    ```

    o:

    ```powershell theme={null}
    claude.cmd --setting-sources "project,local"
    ```

    Si aún quieres ejecutar `claude` directamente en la ventana actual, permite temporalmente la ejecución de scripts primero:

    ```powershell theme={null}
    Set-ExecutionPolicy -Scope Process Bypass
    ```
  </Accordion>

  <Accordion title="¿Por qué falla project,local en Windows PowerShell?">
    En PowerShell, `project,local` debe estar entre comillas como una sola cadena. Usa:

    ```powershell theme={null}
    claude.cmd --setting-sources "project,local"
    ```

    Si tu directorio actual es tu directorio de inicio y solo quieres omitir `~/.claude/settings.json` para una sesión temporal, usa:

    ```powershell theme={null}
    claude.cmd --setting-sources "local"
    ```
  </Accordion>

  <Accordion title="¿Qué nombre de modelo debo usar?">
    Usa el nombre exacto del modelo que se muestra en Modelos y precios. Si el modelo no admite Anthropic Messages, usa un cliente compatible con OpenAI o elige otro modelo.
  </Accordion>
</AccordionGroup>

## Próximos pasos

* [Quickstart](/es/overview/quickstart)
* [Modelos y precios](/es/overview/models-and-pricing)