Claude Code vía Tokonomix

//¿Qué es Claude Code?

Claude Code es la herramienta de codificación agéntica de Anthropic: lee tu base de código, edita archivos en múltiples directorios, ejecuta comandos y abre pull requests. A diferencia de la mayoría de agentes CLI, abarca superficies que comparten un motor: una CLI de terminal, una extensión de VS Code (diffs inline, menciones con @, revisión de planes), un plugin de JetBrains, una aplicación de escritorio y la web en claude.ai/code. Tus archivos CLAUDE.md, ajustes y servidores MCP se trasladan a todas ellas.

La mayoría de las superficies utilizan una suscripción a Claude o una cuenta de Anthropic Console — pero la CLI de terminal y VS Code también admiten proveedores de terceros. Ese gancho es donde se conecta Tokonomix: establece la URL base de Tokonomix más tu clave API y las llamadas de Claude Code se enrutan a través de una sola clave con acceso a 132 modelos de Anthropic, OpenAI, Google, Mistral, Meta y otros.

Como agente, Claude Code realiza trabajo real en lugar de simplemente sugerir completados: planifica un cambio, edita en múltiples archivos, ejecuta tus pruebas, corrige lo que falla y prepara un commit o abre un pull request. Puede generar subagentes para flujos de trabajo en paralelo, ejecutar hooks de shell antes y después de las ediciones (formato automático, lint al hacer commit), y leer reglas del proyecto que mantienes en un archivo CLAUDE.md en la raíz del repositorio. Dado que el mismo motor impulsa todas las superficies, un flujo de trabajo configurado en la terminal se comporta de forma idéntica dentro de VS Code o un IDE de JetBrains — y lo mismo ocurre con la integración de Tokonomix descrita a continuación.

//¿Por qué enrutar Claude Code a través de Tokonomix?

Claude Code es excelente con los modelos propios de Anthropic, pero un único modelo — por bueno que sea — tiene puntos ciegos, y no todas las tareas requieren el mismo motor. Enrutar a través de Tokonomix te da una capa de modelos más amplia (todas las familias principales detrás de una sola clave), más segura en las decisiones que importan (un veredicto de consenso en lugar de una sola opinión) y totalmente transparente (control de costo por llamada y región). Conservas el flujo de trabajo agéntico de Claude Code; Tokonomix solo cambia lo que hay detrás de la llamada a la API.

• Consenso entre familias bajo demanda. Agrega el servidor MCP de Tokonomix y Claude Code podrá llamar a tokonomix_consensus_ask en cualquier refactorización de alto riesgo o decisión de diseño — 2 a 6 modelos frontera verificados por un juez, para que un paso seguro pero incorrecto se detecte antes de llegar a tu repositorio.
• Una clave, 132 modelos. Accede a modelos no pertenecientes a Anthropic con la misma clave, sin cuentas separadas.
• Enrutamiento soberano — tu elección, no solo UE. Ancla modelos según dónde se ejecutan (hosting_region) o dónde se fabricaron (origin_country) — solo UE, solo EE. UU., un único país o un conjunto personalizado. Aplícalo por llamada o establece una regla predefinida (p. ej., selección automática de modelos UE) en tu panel. UE/RGPD es solo un ejemplo.
• Costo por llamada transparente. Cada llamada se mide al céntimo en tu panel de Tokonomix, para que un agente que dispara cientos de llamadas al día nunca te sorprenda.
• Procedencia y soberanía. Filtra por origin_country para elegir modelos según dónde fueron construidos — no solo dónde se ejecutan — cuando las normas de adquisición o soberanía así lo exijan.

//Instalar Claude Code — Windows, macOS, Linux (también WSL)

Los instaladores nativos se actualizan automáticamente en segundo plano. Git para Windows es recomendable en Windows nativo para que Claude Code pueda usar su herramienta Bash.

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

curl -fsSL https://claude.ai/install.sh | bash
# or
brew install --cask claude-code

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

Luego inícialo en cualquier proyecto:

cd your-project
claude

//Ingresa tu clave de Tokonomix

¿Ya tienes una clave? Claude Code lee una gateway de terceros desde dos variables de entorno. Genera una clave (tok_live_…) en tu panel de Tokonomix y apunta Claude Code al endpoint compatible con Anthropic:

# route Claude Code through Tokonomix
export ANTHROPIC_BASE_URL=https://tokonomix.ai/api/anthropic
export ANTHROPIC_API_KEY=tok_live_your-key
claude

//Incorporar habilidades y herramientas MCP

Dos capas complementarias — passthrough de base URL para acceso cotidiano a modelos, y MCP para consenso bajo demanda.

# already wired by ANTHROPIC_BASE_URL
claude "refactor the auth module"

claude mcp add tokonomix -- \
  npx -y tokonomix-mcp
# set the key for the server
TOKONOMIX_API_KEY=tok_live_your-key

El servidor MCP de Tokonomix expone tokonomix_consensus_ask, tokonomix_single_ask, tokonomix_list_models y tokonomix_get_skill. Claude Code invocará el consenso cuando una tarea sea de alto riesgo; también puedes indicárselo explícitamente («obtén un veredicto de consenso sobre esta migración»). Las dos rutas se complementan bien: mantén el passthrough de base URL para las ediciones rápidas y de alto volumen que Claude Code realiza todo el día, y deja que recurra a la herramienta de consenso solo en los momentos en que equivocarse es costoso — una migración de esquema, un cambio de autenticación, un contrato de API pública. Explora las propias habilidades de Claude Code con /skills, empaqueta flujos de trabajo repetibles como habilidades personalizadas que comparte tu equipo, y mantén los estándares de código y las notas de arquitectura en CLAUDE.md para que cada sesión — en cualquier superficie — comience con el mismo contexto.

//Usar Claude Code dentro de un IDE

Aquí Claude Code se diferencia de los agentes solo de terminal: incluye extensiones nativas para el editor, de modo que el agente vive dentro de tu IDE con diffs inline — no solo en un panel de terminal. Las variables de entorno de Tokonomix y el servidor MCP se aplican de forma idéntica en todas las superficies, porque todas comparten un mismo motor.

//Verificar que funciona

Tras exportar las variables de entorno, ejecuta claude y pide un cambio pequeño y reversible — por ejemplo, agregar un docstring. Deberías ver una llamada medida en tu panel de Tokonomix. Luego agrega el servidor MCP y pide a Claude Code que «obtenga un veredicto de consenso» sobre un cambio arriesgado; el resultado multimodelo vuelve como resultado de la herramienta MCP.