> ## Documentation Index > Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt > Use this file to discover all available pages before exploring further. # Uso de APIMart en Claude Code > Una guía detallada sobre cómo configurar y usar los servicios de API de APIMart 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 ## 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: 1. **Una clave de API de APIMart** Acceda a la [Consola de APIMart](https://apimart.ai/keys) para obtener su clave de API (comienza con `sk-`) **Consejo:** Si aún no tiene una cuenta en APIMart, regístrese primero en [APIMart](https://apimart.ai) y obtenga su clave de API. ## Paso 1: Instalar Claude Code Elija uno de los siguientes métodos para instalar: 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 ``` Si encuentra problemas de permisos, anteponga `sudo` al comando. **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 ``` 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 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`:** ```json theme={null} { "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. ```bash theme={null} 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 ``` ```bash theme={null} 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** 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://api.apimart.ai` * `ANTHROPIC_API_KEY` = `sk-xxxxxxxxxxxx` * `ANTHROPIC_MODEL` = `claude-sonnet-4-6-apimart` 3. Reinicie el terminal **Opción B: Comandos de PowerShell** ```powershell theme={null} [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. ```bash theme={null} export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx" export ANTHROPIC_MODEL="claude-sonnet-4-6-apimart" export ANTHROPIC_BASE_URL="https://api.apimart.ai" claude ``` ```powershell theme={null} $env:ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx" $env:ANTHROPIC_MODEL="claude-sonnet-4-6-apimart" $env:ANTHROPIC_BASE_URL="https://api.apimart.ai" claude ``` ```cmd theme={null} 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: ```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 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:** 1. **Uso de settings.json**: Verifique si la ruta del archivo es correcta * Windows: `C:\Users\\.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://apimart.ai/keys) 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. 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 `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? 1. Cambie a un modelo más rápido (por ejemplo, `claude-haiku-4-5-20251001-apimart` o `claude-sonnet-4-6-apimart`) 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 APIMart](https://apimart.ai/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 APIMart](https://docs.apimart.ai) * 💬 [Comunidad de Discord](https://discord.gg/V8zqssyZ5c) * 🐦 [Twitter @APIMart\_](https://x.com/APIMart_) * 📧 Soporte técnico: [zhihong@apimart.ai](mailto:zhihong@apimart.ai) *** ¡Regístrese en APIMart ahora, obtenga su clave de API y experimente el asistente de programación multimodelo en Claude Code!