Uso de APIMart en Claude Code

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 APIMart, puede usar múltiples modelos, incluidos GPT, Claude y Gemini, dentro de Claude Code. Antes de comenzar, asegúrese de tener:

Una clave de API de APIMart Acceda a la Consola de APIMart para obtener su clave de API (comienza con sk-)

Consejo: Si aún no tiene una cuenta en APIMart, regístrese primero en APIMart y obtenga su clave de API.

Paso 1: Instalar Claude Code

Elija uno de los siguientes métodos para instalar:

macOS / Linux (Recomendado)
Windows
Instalación con NPM

Instale con el script oficial:

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

O instale mediante Homebrew:

brew install --cask claude-code

Si encuentra problemas de permisos, anteponga sudo al comando.

PowerShell:

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

CMD:

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

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

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:

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 APIMart

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

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:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apimart.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6-apimart",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

Parámetro	Descripción
`ANTHROPIC_BASE_URL`	Dirección de la API de APIMart, fija como `https://api.apimart.ai`
`ANTHROPIC_AUTH_TOKEN`	Su clave de API de APIMart (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)
macOS / Linux (bash)
Windows

echo 'export ANTHROPIC_BASE_URL="https://api.apimart.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-4-6-apimart"' >> ~/.zshrc
source ~/.zshrc

echo 'export ANTHROPIC_BASE_URL="https://api.apimart.ai"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.bashrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-4-6-apimart"' >> ~/.bashrc
source ~/.bashrc

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

Haga clic derecho en “Este equipo” → “Propiedades” → “Configuración avanzada del sistema” → “Variables de entorno”
Agregue nuevas variables de usuario:
- ANTHROPIC_BASE_URL = https://api.apimart.ai
- ANTHROPIC_API_KEY = sk-xxxxxxxxxxxx
- ANTHROPIC_MODEL = claude-sonnet-4-6-apimart
Reinicie el terminal

Opción B: Comandos de PowerShell

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.apimart.ai', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-xxxxxxxxxxxx', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'claude-sonnet-4-6-apimart', 'User')

Método 3: Variables de entorno temporales

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

macOS / Linux
Windows (PowerShell)
Windows (CMD)

export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"
export ANTHROPIC_MODEL="claude-sonnet-4-6-apimart"
export ANTHROPIC_BASE_URL="https://api.apimart.ai"
claude

$env:ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"
$env:ANTHROPIC_MODEL="claude-sonnet-4-6-apimart"
$env:ANTHROPIC_BASE_URL="https://api.apimart.ai"
claude

set ANTHROPIC_API_KEY=sk-xxxxxxxxxxxx
set ANTHROPIC_MODEL=claude-sonnet-4-6-apimart
set ANTHROPIC_BASE_URL=https://api.apimart.ai
claude

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:

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

APIMart 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-4-6`	Mayor 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.

Modelos con descuento de APIMart

APIMart ofrece modelos con descuento exclusivos a solo el 20% del precio oficial, con las mismas capacidades. Simplemente añada -apimart al ID del modelo:

Nombre del modelo con descuento	Características
`claude-opus-4-6-apimart`	Mayor capacidad general
`claude-sonnet-4-6-apimart`	Rendimiento y velocidad equilibrados
`claude-opus-4-5-20251101-apimart`	Razonamiento avanzado
`claude-sonnet-4-5-20250929-apimart`	Excelente capacidad de código
`claude-haiku-4-5-20251001-apimart`	Respuesta ultrarrápida

También están disponibles las versiones Thinking, por ejemplo, claude-opus-4-6-thinking-apimart, claude-sonnet-4-6-thinking-apimart, etc.

Recomendaciones de modelos:

💰 Mejor relación calidad-precio: claude-sonnet-4-6-apimart: la mejor opción para programación diaria, solo el 20% del precio oficial
🚀 Alto rendimiento: claude-opus-4-6-apimart: para los desafíos de código y arquitectura más complejos
⚡ Respuesta rápida: claude-haiku-4-5-20251001-apimart: cuando necesita comentarios instantáneos
🧠 Pensamiento profundo: claude-opus-4-6-thinking-apimart: 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:

Uso de settings.json: Verifique si la ruta del archivo es correcta
- Windows: C:\Users\<username>\.claude\settings.json
- macOS / Linux: ~/.claude/settings.json
Uso de variables de entorno: Asegúrese de haber iniciado Claude Code desde la misma ventana de terminal donde definió las variables
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 para verificar el estado de la clave

Asegúrese también de que ANTHROPIC_BASE_URL esté establecido en https://api.apimart.ai, 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.

Verifique su conexión de red
Verifique que ANTHROPIC_BASE_URL esté configurado correctamente
Si usa un proxy, asegúrese de que permita el acceso a api.apimart.ai

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-apimart), que es nativamente compatible con Claude Code y no causará este problema.

Q6: ¿Respuesta lenta?

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

Q7: ¿Cómo cambiar de modelo?

Dos maneras:

En modo interactivo: Introduzca el comando /model
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 APIMart 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:

Comience a usar APIMart

¡Regístrese en APIMart ahora, obtenga su clave de API y experimente el asistente de programación multimodelo en Claude Code!

Documentation Index

​Requisitos previos

​Paso 1: Instalar Claude Code

​Verificar la instalación

​Paso 2: Configurar la API de APIMart

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

​Método 2: Variables de entorno permanentes

​Método 3: Variables de entorno temporales

​Paso 3: Comenzar a usar

​Verificar la configuración

​Modos de uso

​Modelos compatibles

​Modelos con descuento de APIMart

​Comandos comunes

​Preguntas frecuentes

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

​Q2: ¿Errores 401 / 403?

​Q3: ¿Error “Unable to connect”?

​Q4: ¿Error “Auth conflict”?

​Q5: ¿Error de max_tokens al usar modelos que no son de Claude?

​Q6: ¿Respuesta lenta?

​Q7: ¿Cómo cambiar de modelo?

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

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

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

​Soporte

Comience a usar APIMart

Requisitos previos

Paso 1: Instalar Claude Code

Verificar la instalación

Paso 2: Configurar la API de APIMart

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

Método 2: Variables de entorno permanentes

Método 3: Variables de entorno temporales

Paso 3: Comenzar a usar

Verificar la configuración

Modos de uso

Modelos compatibles

Modelos con descuento de APIMart

Comandos comunes

Preguntas frecuentes

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

Q2: ¿Errores 401 / 403?

Q3: ¿Error “Unable to connect”?

Q4: ¿Error “Auth conflict”?

Q5: ¿Error de max_tokens al usar modelos que no son de Claude?

Q6: ¿Respuesta lenta?

Q7: ¿Cómo cambiar de modelo?

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

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

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

Soporte