Claude Code

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.

macOS/Linux/WSL
WindowsPowerShell
CMD de Windows
mpn

Instalar:

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

Verificar:

claude --version

Instalar:

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:

claude.cmd --version

Descarga el instalador:

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

Ejecútalo:

install.cmd

Elimina el instalador:

del install.cmd

Verificar:

claude --version

Instalar:

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

Verificar:

claude --version

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.

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.

Abre Import configuration

Abre el menú de acciones de esa key, elige Import configuration y luego cambia a Claude Code.

Copia el script para tu sistema

Usa “macOS / Linux terminal” para macOS, Linux o WSL. Usa “Windows PowerShell” para Windows.

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.

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

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.

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.

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.

macOS/Linux/WSL
WindowsPowerShell

ANTHROPIC_API_KEY="sk-your-key" \
ANTHROPIC_AUTH_TOKEN="sk-your-key" \
ANTHROPIC_BASE_URL="https://moxus.ai" \
claude --setting-sources project,local

$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"

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:

macOS/Linux/WSL
WindowsPowerShell

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"}
    ]
  }'

$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

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

macOS/Linux/WSL
WindowsPowerShell

echo "$ANTHROPIC_BASE_URL"
echo "$ANTHROPIC_API_KEY"

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_API_KEY

No compartas la salida completa del segundo comando.

Solución de problemas

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

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

¿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:

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:

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

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.

¿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:
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:
$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.

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:

claude.cmd --version

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:

Set-ExecutionPolicy -Scope Process Bypass

¿Por qué falla project,local en Windows PowerShell?

En PowerShell, project,local debe estar entre comillas como una sola cadena. Usa:

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:

claude.cmd --setting-sources "local"

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

Descripción general

Plataforma

Guías

Integraciones

Valores

Instala Claude Code

Recomendado: importar la configuración desde una API key

Configuración manual: solo en la terminal actual

Método final de la solicitud

Prueba manual

Solución de problemas

Próximos pasos

​Valores

​Instala Claude Code

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

​Configuración manual: solo en la terminal actual

​Método final de la solicitud

​Prueba manual

​Solución de problemas

​Próximos pasos

Valores

Instala Claude Code

Recomendado: importar la configuración desde una API key

Configuración manual: solo en la terminal actual

Método final de la solicitud

Prueba manual

Solución de problemas

Próximos pasos