claude-connect 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wmcarlosv
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,175 @@
+# Claude Connect
+
+CLI en Node.js para conectar `Claude Code` con proveedores externos desde una interfaz de consola.
+
+## Estado actual
+
+La app ya soporta:
+
+- `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
+- activación reversible sobre la instalación real de `Claude Code`
+- detección automática de rutas en Linux y Windows
+- 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`
+
+## Uso
+
+Arranque local:
+
+```bash
+npm start
+```
+
+Para exponer el comando globalmente:
+
+```bash
+npm link
+claude-connect
+```
+
+Instalación desde npm:
+
+```bash
+npm install -g claude-connect
+claude-connect
+```
+
+Ejecución sin instalación global:
+
+```bash
+npx claude-connect
+```
+
+Requisito:
+
+- Node.js 22 o superior
+
+## Flujo principal
+
+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`
+
+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`
+
+## Dónde se guarda cada cosa
+
+Claude Connect guarda estado local fuera del repo. Por defecto:
+
+```text
+Linux: ~/.claude-connect
+Windows: %APPDATA%\claude-connect
+```
+
+Ahí viven:
+
+- perfiles
+- tokens OAuth
+- API keys gestionadas por la app
+- estado del switch de Claude
+- estado y logs del gateway
+
+El catálogo SQLite local se genera automáticamente en:
+
+```text
+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
+
+## Switch de Claude Code
+
+La activación modifica la configuración real detectada de Claude Code y guarda un snapshot reversible.
+
+Archivos implicados:
+
+- `settings.json` de Claude
+- `~/.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
+
+- modelo: `kimi-for-coding`
+- auth: `Token`
+- base URL: `https://api.kimi.com/coding/`
+- activación directa en Claude Code
+
+### DeepSeek
+
+- modelos: `deepseek-chat`, `deepseek-reasoner`
+- auth: `Token`
+- base URL de activación: `https://api.deepseek.com/anthropic`
+- activación directa en Claude Code
+
+### Qwen
+
+- 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:
+
+```text
+https://chat.qwen.ai/auth?user_code=XXXXX&client=qwen-code
+```
+
+## Navegación
+
+- `Tab` vuelve a la pantalla anterior cuando aplica
+- `Volver` aparece como opción visible en listas
+- `Esc` una vez avisa
+- `Esc` dos veces sale
+
+## Desarrollo
+
+Pruebas:
+
+```bash
+npm test
+```
+
+Entrada principal:
+
+- `src/wizard.js`
+
+Catálogo:
+
+- `src/data/catalog-store.js`
+
+Switch de Claude:
+
+- `src/lib/claude-settings.js`
+
+OAuth Qwen:
+
+- `src/lib/oauth.js`
+
+Gateway local:
+
+- `src/gateway/server.js`

package/bin/claude-connect.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import process from 'node:process';
+import { run } from '../src/index.js';
+
+const alreadyRestarted = process.env.CLAUDE_CONNECT_NO_WARNINGS === '1';
+
+if (!alreadyRestarted && !process.execArgv.includes('--no-warnings=ExperimentalWarning')) {
+  const scriptPath = fileURLToPath(import.meta.url);
+  const child = spawn(process.execPath, ['--no-warnings=ExperimentalWarning', scriptPath, ...process.argv.slice(2)], {
+    env: {
+      ...process.env,
+      CLAUDE_CONNECT_NO_WARNINGS: '1'
+    },
+    stdio: 'inherit'
+  });
+
+  child.on('exit', (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+      return;
+    }
+
+    process.exit(code ?? 0);
+  });
+
+  child.on('error', (error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`\nclaude-connect: ${message}`);
+    process.exit(1);
+  });
+} else {
+  run().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`\nclaude-connect: ${message}`);
+    process.exitCode = 1;
+  });
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "claude-connect",
+  "version": "0.1.0",
+  "description": "CLI para configurar Claude Code con proveedores de modelos externos",
+  "author": "wmcarlosv",
+  "type": "module",
+  "homepage": "https://github.com/wmcarlosv/claude-connect#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wmcarlosv/claude-connect.git"
+  },
+  "bugs": {
+    "url": "https://github.com/wmcarlosv/claude-connect/issues"
+  },
+  "bin": {
+    "claude-connect": "./bin/claude-connect.js"
+  },
+  "files": [
+    "bin/claude-connect.js",
+    "src/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "start": "node --no-warnings=ExperimentalWarning ./bin/claude-connect.js",
+    "test": "node --no-warnings=ExperimentalWarning --test",
+    "prepublishOnly": "npm test"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "keywords": [
+    "cli",
+    "claude",
+    "claude-code",
+    "anthropic",
+    "deepseek",
+    "kimi",
+    "qwen",
+    "terminal"
+  ],
+  "license": "MIT"
+}