Skip to main content
Claude Code es la herramienta CLI de Anthropic para programación con agentes. Esta guía te muestra cómo ejecutarlo a través de Venice para obtener acceso anonimizado y de pago por token a los modelos Claude.

Pago por token

Sin suscripción. Paga solo por lo que uses

Modelos Claude

Accede a los modelos actuales Opus, Sonnet y Fable a través de Venice

Prompt caching

El caching de Venice funciona junto a Claude Code

​
Por qué necesitas un router

Claude Code se conecta directamente a la API de Anthropic por defecto. Para usarlo con Venice necesitas claude-code-router, un proxy local de código abierto que:

Intercepta

Captura las solicitudes salientes de Claude Code antes de que lleguen a Anthropic

Transforma

Convierte las solicitudes de Anthropic Messages al formato de chat compatible con OpenAI de Venice

Redirige

Reenvía las solicitudes a api.venice.ai/api/v1/chat/completions

​
Requisitos previos

Cuenta de Venice

Con créditos de Venice

Node.js

v22 o superior

Claude Code

Instalado mediante npm

​
Configuración

1

Instala o actualiza Claude Code

Instala la última versión de la CLI de Claude Code:
2

Instala Claude Code Router

3

Obtén tu API key

Genera una clave en venice.ai/settings/api. La añadirás a CCR en el siguiente paso.
4

Añade Venice como proveedor

Inicia la interfaz de administración de CCR:
En la página Providers, elige Add provider y luego Other / custom API endpoint. Introduce:
  • Nombre: Venice
  • Endpoint de la API: https://api.venice.ai/api/v1
  • API key: tu API key de Venice
CCR debería detectar OpenAI Chat automáticamente. Si no lo hace, abre Advanced settings, desactiva la detección automática de protocolo y selecciona OpenAI Chat.Usa Search models o Custom models para añadir los modelos Claude que quieras, luego ejecuta Check Connection y guarda el proveedor. La comprobación de conexión envía una solicitud real con un límite de salida de un token.
5

Crea un perfil de Claude Code

En Agent Config, elige Add profile y luego Claude Code:
  • Nombra el perfil Claude Code - Venice.
  • Mantén Effect scope en Only opened from CCR mientras haces pruebas.
  • Elige CLI only o CLI & APP.
  • Establece Model en un modelo de Venice como Venice/claude-opus-4-8.
  • Para mantener todos los niveles de Claude Code en Venice, configura también los campos opcionales de modelo Fable, Opus, Sonnet y Haiku con modelos de Venice.
Guarda el perfil.
6

Inicia y verifica

Inicia el perfil por su nombre:
En Claude Code:
  1. Ejecuta /context y confirma que la ventana de contexto coincide con el modelo seleccionado. Para claude-opus-4-8, debería mostrar 1M.
  2. Ejecuta /model si quieres cambiar a otro modelo de Venice; las variantes de 1M están marcadas como 1M context.
  3. Envía un mensaje de prueba y luego revisa Request logs en CCR para confirmar que se usó Venice.

​
Modelos admitidos

El catálogo cambia con el tiempo. Usa Search models en CCR o GET /models?type=text para ver la lista y los límites actuales.
Claude Code está optimizado para los modelos Claude. Aunque otros modelos disponibles en Venice (GPT, DeepSeek, Grok, etc.) pueden funcionar, no podemos garantizar una experiencia equivalente, ya que Claude Code depende de funciones específicas de Claude como extended thinking. Para otros modelos, considera usar la API estándar de Venice.

​
Actualizar una instalación existente

Actualiza CCR antes de solucionar problemas en una instalación existente:
Las versiones actuales de CCR almacenan la configuración activa en ~/.claude-code-router/config.sqlite. Un config.json antiguo se importa cuando la base de datos no existe. Tras la migración, realiza los cambios a través de ccr ui en lugar de seguir editando config.json. Si un proceso en segundo plano sigue en ejecución después de una actualización, reinícialo:

​
Prompt caching

El prompt caching de Venice funciona con los marcadores de caché nativos de Claude Code. No se requiere ningún transformer de caché adicional para la configuración normal.

​
Solución de problemas

  1. Actualiza CCR con npm install -g @musistudio/claude-code-router@latest.
  2. Inicia una nueva sesión de Claude Code desde el perfil de CCR.
  3. Ejecuta /model y selecciona la entrada de Venice marcada como 1M context.
  4. Ejecuta /context y confirma que la ventana es 1M, no 200K.
Las versiones antiguas de CCR pueden no exponer correctamente la ventana de contexto o el uso de tokens a Claude Code.
Confirma que tienes Node.js 22 o superior y actualiza CCR:
Usa ccr serve para ejecutarlo en primer plano y ver el error de arranque original. Un stack trace Cannot read properties of undefined (reading 'error') procedente de server.logger.error indica una instalación de CCR desactualizada; actualízala antes de seguir investigando.
Inicia el gateway y verifica su estado:
Una comprobación de estado fallida significa que el gateway local de CCR no está disponible; la solicitud no ha llegado a Venice.
Abre ccr ui y realiza el cambio allí. Las versiones actuales de CCR almacenan la configuración en config.sqlite; config.json es solo una fuente de migración para instalaciones antiguas.

​
Recursos

Venice API Docs

Referencia completa de la API

claude-code-router

Código fuente e issues

Versiones de CCR

Versiones actuales y notas de lanzamiento