Uso de APIMart en CC-Switch

Introducción

CC-Switch es una aplicación de escritorio de código abierto que unifica la gestión de configuraciones de proveedores de API entre múltiples herramientas CLI de programación con IA como Claude Code, Codex y Gemini CLI. Convierte la tediosa edición de archivos de configuración en solo unos clics en una interfaz gráfica: una vez añadido un proveedor, puede cambiar entre servicios de API al instante, sin necesidad de editar archivos de configuración manualmente. Al conectar APIMart a través de CC-Switch, puede configurar fácilmente el servicio APIMart para Claude Code y Codex, y cambiar libremente entre múltiples proveedores.

Requisitos previos

Antes de comenzar, asegúrese de tener:

Una herramienta CLI compatible instalada Al menos una herramienta CLI compatible instalada, como Claude Code o Codex CLI
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 CC-Switch

Elija el método de instalación según su sistema operativo:

macOS
Windows
Linux

Instale mediante Homebrew (recomendado):

brew tap farion1231/ccswitch
brew install --cask cc-switch

También puede descargar el instalador .dmg desde GitHub Releases. CC-Switch está firmado y notarizado por Apple, por lo que se puede instalar directamente (requiere macOS 12 o posterior).

Descargue el instalador .msi o el .zip portátil desde GitHub Releases.Requiere Windows 10 o posterior.

Descargue el paquete adecuado desde GitHub Releases:

Debian / Ubuntu: paquete .deb
Fedora / RHEL: paquete .rpm
Universal: formato .AppImage
Arch Linux: paru -S cc-switch-bin

Cuando se lanza CC-Switch por primera vez, detecta automáticamente las herramientas CLI instaladas en su máquina y puede importar las configuraciones existentes como los proveedores predeterminados.

Paso 2: Añadir el proveedor APIMart

En la parte superior de la ventana principal de CC-Switch puede cambiar entre diferentes grupos de herramientas CLI. Consulte los pasos a continuación según la herramienta que desee configurar.

Configurar para Claude Code
Configurar para Codex

1. Cambiar al grupo Claude CodeSeleccione Claude Code en la parte superior de la ventana principal.2. Abrir el panel Añadir proveedorHaga clic en el botón + en la esquina superior derecha de la ventana principal.3. Completar los detalles del proveedorComplete el formulario de la siguiente manera:

Campo	Valor	Descripción
Name	`APIMart`	Etiqueta personalizada para fácil identificación
Endpoint URL	`https://api.apimart.ai`	URL base de la API de APIMart
API Key	`sk-xxxxxxxxxxxx`	Su clave de API de APIMart
API Format	`Anthropic Messages`	Mantenga el formato nativo de Anthropic predeterminado

4. Guardar la configuraciónHaga clic en Add para guardar. APIMart aparecerá en la lista de proveedores.

1. Cambiar al grupo CodexSeleccione Codex en la parte superior de la ventana principal.2. Abrir el panel Añadir proveedorHaga clic en el botón + en la esquina superior derecha de la ventana principal.3. Completar los detalles del proveedorUn proveedor de Codex se configura mediante dos bloques:Complete la clave de API en el bloque auth.json:

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}

Complete la configuración del proveedor en el bloque config.toml:

model = "gpt-5.5"
model_provider = "apimart"

[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
requires_openai_auth = true

4. Guardar la configuraciónNombre el proveedor (p. ej., APIMart) y haga clic en Add para guardar. CC-Switch validará automáticamente tanto el JSON como el TOML.

Acerca de la URL del endpoint: Claude Code usa el formato nativo de Anthropic con la URL https://api.apimart.ai (sin /v1); Codex usa el formato compatible con OpenAI con la URL https://api.apimart.ai/v1 (con /v1). No los confunda.

Paso 3: Cambiar de proveedor

Una vez añadido, puede cambiar entre APIMart y otros proveedores en cualquier momento:

Cambiar en la ventana principal

Seleccione APIMart en la lista de proveedores
Haga clic en el botón Enable (o Use)
Un mensaje “Switched successfully” confirma el cambio

Cambiar desde la bandeja del sistema

CC-Switch permanece en la bandeja del sistema, por lo que puede cambiar sin abrir la ventana principal:

Haga clic en el icono de CC-Switch en la bandeja del sistema
Haga clic en el nombre del proveedor objetivo en el menú: surte efecto de inmediato

Acerca de la activación: Claude Code admite el cambio en caliente: las nuevas sesiones recogen automáticamente la nueva configuración. Tras cambiar para Codex, debe reiniciar el terminal o Codex para que el cambio surta efecto.

Modelos compatibles

Después de cambiar al proveedor APIMart, puede usar una variedad de modelos en la herramienta CLI correspondiente:

ID del modelo	Fortalezas	Casos de uso recomendados
`claude-opus-4-6`	El más fuerte en general	Arquitectura compleja, depuración difícil
`claude-sonnet-4-6`	Rendimiento y velocidad equilibrados	Programación diaria, generación de código
`gpt-5.5`	Excelentes habilidades de programación	Tareas de ingeniería complejas
`gpt-4o`	Alto rendimiento, rápido	Programación diaria, iteración rápida

En Claude Code, use el comando /model para cambiar de modelo; en Codex, también use el comando /model. Para la lista completa de modelos, consulte la guía de Claude Code y la guía de Codex CLI.

Preguntas frecuentes

Q1: ¿El cambio de proveedor no surte efecto?

Claude Code: Admite cambio en caliente: inicie una nueva sesión; si aún no funciona, reinicie Claude Code
Codex: Tras cambiar, reinicie el terminal o Codex

Q2: ¿La clave de API se informa como inválida?

Asegúrese de que la clave de API comience con sk- y se haya copiado completamente sin espacios adicionales
Acceda a la Consola de APIMart para confirmar que la clave esté activa
Compruebe que la URL del endpoint sea correcta (Claude Code usa https://api.apimart.ai, Codex usa https://api.apimart.ai/v1)

Q3: ¿Error de formato al añadir un proveedor de Codex?

CC-Switch valida auth.json (sintaxis JSON) y config.toml (sintaxis TOML). Verifique que:

Los corchetes, comillas y comas en el JSON estén completos
No se usen comillas tipográficas o de ancho completo
Los nombres de los campos en el TOML estén escritos correctamente

Q4: ¿Qué archivos modifica CC-Switch?

CC-Switch escribe en los archivos de configuración de cada herramienta:

Claude Code: ~/.claude/settings.json
Codex: ~/.codex/config.toml y ~/.codex/auth.json

CC-Switch realiza copias de seguridad automáticas de estos archivos antes de cambiar, por lo que no necesita editarlos manualmente.

Q5: ¿Cómo veo el uso y la facturación de la API?

Acceda a la Consola de APIMart para ver estadísticas de llamadas a la API, detalles de consumo de tokens y tendencias de costos.

Soporte y ayuda

Si tiene algún problema al usar CC-Switch:

Comience con APIMart

¡Regístrese en APIMart ahora, obtenga su clave de API y gestione múltiples herramientas de programación con IA sin esfuerzo en CC-Switch!

Documentation Index

​Introducción

​Requisitos previos

​Paso 1: Instalar CC-Switch

​Paso 2: Añadir el proveedor APIMart

​Paso 3: Cambiar de proveedor

​Cambiar en la ventana principal

​Cambiar desde la bandeja del sistema

​Modelos compatibles

​Preguntas frecuentes

​Q1: ¿El cambio de proveedor no surte efecto?

​Q2: ¿La clave de API se informa como inválida?

​Q3: ¿Error de formato al añadir un proveedor de Codex?

​Q4: ¿Qué archivos modifica CC-Switch?

​Q5: ¿Cómo veo el uso y la facturación de la API?

​Soporte y ayuda

Comience con APIMart

Introducción

Requisitos previos

Paso 1: Instalar CC-Switch

Paso 2: Añadir el proveedor APIMart

Paso 3: Cambiar de proveedor

Cambiar en la ventana principal

Cambiar desde la bandeja del sistema

Modelos compatibles

Preguntas frecuentes

Q1: ¿El cambio de proveedor no surte efecto?

Q2: ¿La clave de API se informa como inválida?

Q3: ¿Error de formato al añadir un proveedor de Codex?

Q4: ¿Qué archivos modifica CC-Switch?

Q5: ¿Cómo veo el uso y la facturación de la API?

Soporte y ayuda