ccproxy
Proxy auto-alojado que permite usar suscripciones Claude Pro/Max con Cursor IDE y OpenAI Codex mediante OAuth, evitando facturas por API keys de Anthropic.
Ficha actualizada 26 sept 2026, 9:16 · upstream 26 sept 2026, 9:09 · release sin release detectada
Qué es ccproxy
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
ccproxy es un proxy compatible con OpenAI diseñado para permitir el uso de suscripciones de Claude Pro o Max en entornos Cursor IDE y OpenAI Codex sin utilizar claves de API de Anthropic. Se basa en CLIProxyAPI y añade una capa de gateway que adapta las solicitudes a los formatos requeridos por estas herramientas.
El proyecto utiliza Docker Compose para despliegue, con soporte para Traefik y Dokploy. Incluye un shim de gateway que convierte los bloques de herramientas de Cursor y permite el passthrough transparente de la API Responses para Codex. La autenticación se realiza mediante OAuth de Claude, gestionando sesiones en lugar de claves estáticas.
El repositorio proporciona scripts de instalación, gestión de modelos con alias, configuración de esfuerzo (low/medium/high) y comandos CLI para operaciones diarias como reinicio de OAuth, verificación de salud y gestión de cuentas. La documentación cubre configuración detallada para Cursor, Codex, variables de entorno y arquitectura.
- Integrar Claude Pro/Max en Cursor IDE manteniendo la experiencia de usuario existente (tabs, diffs, reglas)
- Usar modelos de Claude en OpenAI Codex mediante la API Responses con remapeo de IDs de modelo
- Auto-alojar un proxy HTTPS compatible con OpenAI para evitar facturas por uso de Anthropic API keys
- Gestionar múltiples cuentas de Claude Pro/Max con autenticación OAuth y round-robin automático
- Desplegar en VPS con Traefik/Dokploy usando Docker Compose sin necesidad de Dockerfile personalizado
- Autenticación mediante OAuth de Claude, no requiere claves API estáticas ni facturas por uso
- Compatible con Cursor IDE y OpenAI Codex manteniendo sus flujos de trabajo nativos
- Soporta múltiples modelos (Sonnet/Opus) con variantes de esfuerzo configurables vía CLI
- Arquitectura basada en CLIProxyAPI con shim de gateway para Cursor tool-blocks
- Scripts de despliegue y operaciones CLI integrados (ccproxy deploy, relogin, cch)
- Documentación completa para configuración de Cursor, Codex, OAuth y variables de entorno
- Cursor Agent no funciona en localhost; requiere URL HTTPS pública (VPS necesario)
- No incluye Dockerfile propio; depende de la imagen eceasy/cli-proxy-api
- OAuth tokens dan acceso a suscripción de Claude; el VPS debe tratarse como sensible
- Requiere dominio A apuntando al VPS para TLS y acceso HTTPS público
- Dependencia externa de CLIProxyAPI upstream para lógica principal de proxy
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Desplegar en VPS con Docker Compose v2+. Requiere dominio A, Traefik o Dokploy para TLS. Ejecutar ccproxy deploy para construir y arrancar el stack. Configurar CLIPROXY_API_KEY fuerte antes de exponer públicamente. Mantener remote-management.allow-remote: false en config/config.yaml. Gitignore .env y claude-*.json.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.