Saltar al contenido

Claude Code

Usa verxion dentro de Claude Code — registra entrenamientos desde el mismo terminal donde envías features.

Claude Code es el agente nativo de terminal de Anthropic. Con verxion configurado, registras series entre commits sin cambiar de aplicación.

Configuración

  1. Abre MCP Setup e inicia sesión
  2. Copia el snippet para Claude Code
  3. Añádelo a tu .claude/settings.json — a nivel de usuario (~/.claude/settings.json) para todos los proyectos, o a nivel de proyecto (<repo>/.claude/settings.json) si solo quieres que esté activo en uno
  4. Las herramientas estarán disponibles en tu siguiente sesión de Claude Code — no hace falta reiniciar el CLI para nuevas sesiones

Verifica

> ¿Estoy conectado a verxion?

Claude Code lista las tools que ve. Igual que con Claude Desktop, por defecto solo verás execute_code (Code Mode).

Úsalo mientras trabajas

Algunos patrones reales:

> Registra una sesión rápida: calentamiento 5x5 sentadilla 60kg, luego 4x5 100kg RPE 8
> Enséñame mi última sesión de press banca
> ¿Cómo va el entrenamiento esta semana — voy retrasado?

Como Claude Code ya tiene acceso a la shell, puedes encadenar con acciones locales:

> Registra mi entreno y luego ejecuta pnpm test

Scopes y permisos

verxion usa scopes de OAuth para separar escrituras de lecturas. El config por defecto otorga el set estándar. Si quieres una sesión de solo lectura (p. ej. para inspeccionar datos sin riesgo de escrituras accidentales), la página de setup tiene una opción de token de solo lectura — pega ese snippet en su lugar.

Solución de problemas

Las tools aparecen pero cada llamada devuelve 401

Faltan tools en claude --list-tools

  • Confirma que el JSON de settings.json es válido y que mcpServers está al nivel correcto
  • Ejecuta claude en modo verbose para ver errores de conexión MCP

Trucos

  • Claude Code es excelente para operaciones por lotes: “importa esta rutina y crea una sesión para hoy” cabe en un único prompt
  • El mismo .claude/settings.json sirve para todos tus repos cuando lo pones en ~/.claude/
  • Combínalo con Rutinas y Programas — Claude Code brilla en los momentos de “monto mi bloque de entrenamiento”