claude-connect 0.1.0 → 0.1.3

package/README.md

@@ -1,73 +1,113 @@
 # Claude Connect
 
-CLI en Node.js para conectar `Claude Code` con proveedores externos desde una interfaz de consola.
+> Conecta `Claude Code` con `OpenCode Go`, `Zen`, `Kimi`, `DeepSeek`, `OpenRouter` y `Qwen` desde una interfaz de consola clara, rápida y reversible.
 
-## Estado actual
+[![npm version](https://img.shields.io/npm/v/claude-connect?style=for-the-badge&logo=npm&color=cb3837)](https://www.npmjs.com/package/claude-connect)
+[![node](https://img.shields.io/badge/node-%3E%3D22-2f7d32?style=for-the-badge&logo=node.js&logoColor=white)](https://nodejs.org/)
+[![license](https://img.shields.io/badge/license-MIT-0f172a?style=for-the-badge)](./LICENSE)
+[![providers](https://img.shields.io/badge/providers-OpenCode%20Go%20%7C%20Zen%20%7C%20Kimi%20%7C%20DeepSeek%20%7C%20OpenRouter%20%7C%20Qwen-0ea5e9?style=for-the-badge)](https://www.npmjs.com/package/claude-connect)
 
-La app ya soporta:
+## Why Claude Connect
 
-- `Kimi` por `API key`
-- `DeepSeek` por `API key`
-- `Qwen` por `OAuth` o `Token`
-- catálogo local en SQLite sembrado automáticamente desde código
-- creación, edición y eliminación de conexiones
+`Claude Connect` te permite cambiar `Claude Code` hacia otros proveedores sin editar archivos a mano, sin perder tu configuración original y sin convertir tu terminal en un caos de variables de entorno.
+
+### Highlights
+
+- `OpenCode Go`, `Zen`, `Kimi`, `DeepSeek`, `OpenRouter` y `Qwen` listos desde el primer arranque
+- soporte para `Token` y `OAuth` cuando el proveedor lo permite
+- API keys compartidas por proveedor para no repetir el mismo token en cada modelo
 - activación reversible sobre la instalación real de `Claude Code`
-- detección automática de rutas en Linux y Windows
+- limpieza automática del conflicto entre `claude.ai` y `ANTHROPIC_API_KEY`
 - gateway local Anthropic-compatible para `Qwen`
-- limpieza y restauración reversible de credenciales de `claude.ai` para evitar `Auth conflict`
-- navegación con `Volver` en pantallas y salida por doble `Esc`
+- detección automática de rutas en Linux y Windows
+- catálogo local en SQLite generado automáticamente
+- interfaz de consola con navegación simple y profesional
 
-## Uso
+## Package
 
-Arranque local:
+- npm: https://www.npmjs.com/package/claude-connect
+- repo: https://github.com/wmcarlosv/claude-connect
 
-```bash
-npm start
-```
+## Install
 
-Para exponer el comando globalmente:
+Instalación global:
 
 ```bash
-npm link
+npm install -g claude-connect
 claude-connect
 ```
 
-Instalación desde npm:
+Instalación simple en proyecto:
 
 ```bash
-npm install -g claude-connect
-claude-connect
+npm i claude-connect
 ```
 
-Ejecución sin instalación global:
+Ejecución con `npx`:
 
 ```bash
 npx claude-connect
 ```
 
+Desarrollo local:
+
+```bash
+npm start
+```
+
 Requisito:
 
-- Node.js 22 o superior
+- `Node.js 22` o superior
 
-## Flujo principal
+## Quick Flow
 
-1. `Nueva conexion`
-2. elegir proveedor
-3. elegir modelo
-4. elegir tipo de conexión: `OAuth` o `Token`
-5. guardar perfil local
-6. `Activar en Claude`
-7. usar `claude`
+```text
+Nueva conexion
+  -> proveedor
+  -> modelo
+  -> OAuth o Token
+  -> guardar API key una vez por proveedor si aplica
+  -> guardar perfil
+  -> Activar en Claude
+  -> usar claude
+```
 
 Al activar:
 
-- `Kimi` usa `https://api.kimi.com/coding/`
-- `DeepSeek` usa `https://api.deepseek.com/anthropic`
-- `Qwen` usa el gateway local `http://127.0.0.1:4310/anthropic`
+- `OpenCode Go` usa conexión directa o gateway según el modelo elegido
+- `Zen` usa conexión directa o gateway según el modelo elegido
+- `Kimi` usa gateway local y reenvia al endpoint Anthropic de `https://api.kimi.com/coding/`
+- `DeepSeek` apunta a `https://api.deepseek.com/anthropic`
+- `OpenRouter` usa `openrouter/free` por gateway sobre `https://openrouter.ai/api/v1`
+- `Qwen` apunta al gateway local `http://127.0.0.1:4310/anthropic`
+
+## Providers
+
+| Proveedor | Modelos | Auth | Integración |
+| --- | --- | --- | --- |
+| `OpenCode Go` | `glm-5`, `kimi-k2.5`, `minimax-m2.7`, `minimax-m2.5` | `Token` | Mixta |
+| `Zen` | `Claude*` de Zen + modelos `chat/completions` de Zen | `Token` | Mixta |
+| `Kimi` | `kimi-for-coding` | `Token` | Gateway local |
+| `DeepSeek` | `deepseek-chat`, `deepseek-reasoner` | `Token` | Directa |
+| `OpenRouter` | `openrouter/free` | `Token` | Gateway local |
+| `Qwen` | `qwen3-coder-plus` | `OAuth`, `Token` | Gateway local |
 
-## Dónde se guarda cada cosa
+Nota sobre `OpenCode Go`:
 
-Claude Connect guarda estado local fuera del repo. Por defecto:
+- `minimax-m2.7` y `minimax-m2.5` van directos por endpoint `messages`
+- `glm-5` y `kimi-k2.5` van por gateway usando `chat/completions`
+
+Nota sobre `Zen`:
+
+- los modelos Anthropic de Zen van por conexión directa
+- los modelos de Zen servidos por `chat/completions` van por gateway local
+- esta primera integración no incluye todavía los modelos de Zen expuestos por `responses` ni los de endpoint tipo Google
+
+## What It Stores
+
+Claude Connect guarda el estado sensible fuera del repo.
+
+Rutas por defecto:
 
 ```text
 Linux: ~/.claude-connect
@@ -78,9 +118,9 @@ Ahí viven:
 
 - perfiles
 - tokens OAuth
-- API keys gestionadas por la app
+- API keys compartidas por proveedor
 - estado del switch de Claude
-- estado y logs del gateway
+- logs y estado del gateway
 
 El catálogo SQLite local se genera automáticamente en:
 
@@ -91,62 +131,50 @@ storage/claude-connect.sqlite
 Importante:
 
 - esa base ya no se versiona en git
-- el catálogo se reconstruye desde `src/data/catalog-store.js`
-- un `git pull` no debería volver a darte conflicto por la base SQLite
+- el catálogo se siembra desde `src/data/catalog-store.js`
+- esto evita conflictos molestos al hacer `git pull`
 
-## Switch de Claude Code
+## Claude Code Switching
 
-La activación modifica la configuración real detectada de Claude Code y guarda un snapshot reversible.
+Cuando activas un perfil, la app modifica la configuración real detectada de `Claude Code` y guarda un snapshot reversible.
 
 Archivos implicados:
 
-- `settings.json` de Claude
+- `settings.json`
 - `~/.claude.json`
-- `.credentials.json` de Claude
-
-Esto permite:
-
-- activar `Kimi`, `DeepSeek` o `Qwen`
-- evitar conflicto entre `claude.ai` y `ANTHROPIC_API_KEY`
-- restaurar la sesión original con `Revertir Claude`
-
-## Proveedores
-
-### Kimi
+- `.credentials.json`
 
-- modelo: `kimi-for-coding`
-- auth: `Token`
-- base URL: `https://api.kimi.com/coding/`
-- activación directa en Claude Code
+Eso permite:
 
-### DeepSeek
+- activar otro proveedor sin tocar archivos manualmente
+- evitar el `Auth conflict` entre sesión `claude.ai` y `API key`
+- volver a tu estado original con `Revertir Claude`
 
-- modelos: `deepseek-chat`, `deepseek-reasoner`
-- auth: `Token`
-- base URL de activación: `https://api.deepseek.com/anthropic`
-- activación directa en Claude Code
+## Qwen OAuth
 
-### Qwen
+`Qwen` usa el device flow oficial de `Qwen Code`.
 
-- modelo: `qwen3-coder-plus`
-- auth: `OAuth`, `Token`
-- OAuth con device flow oficial de `Qwen Code`
-- gateway local requerido para integrarlo con Claude Code
-
-URL de autorización típica:
+URL típica de autorización:
 
 ```text
 https://chat.qwen.ai/auth?user_code=XXXXX&client=qwen-code
 ```
 
-## Navegación
+Comportamiento actual:
+
+- intenta abrir el navegador por defecto
+- también deja la URL visible para copiar y pegar manualmente
+- en Windows ya se corrigió la apertura del navegador
+
+## Console UX
 
-- `Tab` vuelve a la pantalla anterior cuando aplica
 - `Volver` aparece como opción visible en listas
+- `Tab` vuelve a la pantalla anterior cuando aplica
 - `Esc` una vez avisa
 - `Esc` dos veces sale
+- después de crear o editar una conexión, regresas al menú principal
 
-## Desarrollo
+## Development
 
 Pruebas:
 
@@ -154,22 +182,21 @@ Pruebas:
 npm test
 ```
 
-Entrada principal:
-
-- `src/wizard.js`
-
-Catálogo:
-
-- `src/data/catalog-store.js`
-
-Switch de Claude:
+Puntos principales del código:
 
-- `src/lib/claude-settings.js`
+- entrada principal: `src/wizard.js`
+- catálogo: `src/data/catalog-store.js`
+- switch de Claude: `src/lib/claude-settings.js`
+- OAuth de Qwen: `src/lib/oauth.js`
+- gateway local: `src/gateway/server.js`
 
-OAuth Qwen:
+## Publish Notes
 
-- `src/lib/oauth.js`
+El paquete npm publica solo lo necesario:
 
-Gateway local:
+- `bin/claude-connect.js`
+- `src/`
+- `README.md`
+- `LICENSE`
 
-- `src/gateway/server.js`
+El tarball ya está preparado para distribución limpia.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-connect",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "CLI para configurar Claude Code con proveedores de modelos externos",
   "author": "wmcarlosv",
   "type": "module",