claude-connect 0.1.6 → 0.1.8

package/README.md

@@ -1,11 +1,11 @@
 # Claude Connect
 
-> Conecta `Claude Code` con `OpenCode Go`, `Zen`, `Kimi`, `DeepSeek`, `Ollama`, `OpenAI`, `OpenRouter` y `Qwen` desde una interfaz de consola clara, rápida y reversible.
+> Conecta `Claude Code` con `OpenCode Go`, `Zen`, `Kimi`, `DeepSeek`, `Ollama`, `OpenAI`, `Inception Labs`, `OpenRouter` y `Qwen` desde una interfaz de consola clara, rápida y reversible.
 
 [![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%20Ollama%20%7C%20OpenAI%20%7C%20OpenRouter%20%7C%20Qwen-0ea5e9?style=for-the-badge)](https://www.npmjs.com/package/claude-connect)
+[![providers](https://img.shields.io/badge/providers-OpenCode%20Go%20%7C%20Zen%20%7C%20Kimi%20%7C%20DeepSeek%20%7C%20Ollama%20%7C%20OpenAI%20%7C%20Inception%20Labs%20%7C%20OpenRouter%20%7C%20Qwen-0ea5e9?style=for-the-badge)](https://www.npmjs.com/package/claude-connect)
 
 ## Why Claude Connect
 
@@ -13,7 +13,7 @@
 
 ### Highlights
 
-- `OpenCode Go`, `Zen`, `Kimi`, `DeepSeek`, `Ollama`, `OpenAI`, `OpenRouter` y `Qwen` listos desde el primer arranque
+- `OpenCode Go`, `Zen`, `Kimi`, `DeepSeek`, `Ollama`, `OpenAI`, `Inception Labs`, `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`
@@ -80,8 +80,10 @@ Al activar:
 - `DeepSeek` apunta a `https://api.deepseek.com/anthropic`
 - `Ollama` pide una URL local o remota, valida `/api/tags` y usa el gateway local sobre `.../api/chat`
 - `OpenAI` usa el gateway local sobre `https://api.openai.com/v1/chat/completions`
+- `Inception Labs` usa el gateway local sobre `https://api.inceptionlabs.ai/v1/chat/completions`
 - `OpenRouter` usa `openrouter/free` por gateway sobre `https://openrouter.ai/api/v1`
 - `Qwen` apunta al gateway local `http://127.0.0.1:4310/anthropic`
+- para algunos modelos con limites conocidos, el gateway ahora ajusta `max_tokens` y bloquea prompts sobredimensionados antes de que el upstream devuelva errores opacos
 
 ## Providers
 
@@ -93,6 +95,7 @@ Al activar:
 | `DeepSeek` | `deepseek-chat`, `deepseek-reasoner` | `Token` | Directa |
 | `Ollama` | modelos descubiertos desde tu servidor | `Servidor Ollama` | Gateway local |
 | `OpenAI` | `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.3-codex`, `gpt-5.2-codex`, `gpt-5.2`, `gpt-5.1-codex-max`, `gpt-5.1-codex-mini` | `Token` | Gateway local |
+| `Inception Labs` | `mercury-2` | `Token` | Gateway local |
 | `OpenRouter` | `openrouter/free` | `Token` | Gateway local |
 | `Qwen` | `qwen3-coder-plus` | `OAuth`, `Token` | Gateway local |
 
@@ -118,6 +121,25 @@ Nota sobre `OpenAI`:
   - https://platform.openai.com/docs/api-reference/authentication
   - https://developers.openai.com/api/docs/models
 
+Nota sobre `Inception Labs`:
+
+- esta primera integracion expone solo `mercury-2`, que es el modelo chat-compatible oficial en `v1/chat/completions`
+- `mercury-2` se trata como modelo solo texto en Claude Connect; si envias una imagen, la app ahora corta la peticion con un mensaje claro
+- Claude Connect aplica presupuesto preventivo de contexto para `mercury-2` usando ventana `128K` y salida maxima `16,384`
+- `Mercury Edit 2` no se publica todavia en Claude Connect porque usa endpoints `fim/edit` que no encajan con Claude Code en esta arquitectura
+- autenticacion soportada: `API key`
+- referencias oficiales:
+  - https://docs.inceptionlabs.ai/get-started/get-started
+  - https://docs.inceptionlabs.ai/get-started/authentication
+  - https://docs.inceptionlabs.ai/get-started/models
+
+Nota sobre `DeepSeek`:
+
+- Claude Connect aplica presupuesto preventivo de contexto para `deepseek-chat` y `deepseek-reasoner`
+- referencias oficiales:
+  - https://api-docs.deepseek.com/quick_start/pricing/
+  - https://api-docs.deepseek.com/guides/reasoning_model
+
 Nota sobre `Ollama`:
 
 - la URL del servidor se define al crear la conexión
@@ -151,14 +173,16 @@ Ahí viven:
 El catálogo SQLite local se genera automáticamente en:
 
 ```text
-storage/claude-connect.sqlite
+Linux: ~/.claude-connect/storage/claude-connect.sqlite
+Windows: %APPDATA%\claude-connect\storage\claude-connect.sqlite
 ```
 
 Importante:
 
 - esa base ya no se versiona en git
 - el catálogo se siembra desde `src/data/catalog-store.js`
-- esto evita conflictos molestos al hacer `git pull`
+- ya no se crea en la carpeta donde ejecutas el comando
+- esto evita conflictos molestos al hacer `git pull` y carpetas `storage/` accidentales en proyectos ajenos
 
 ## Claude Code Switching
 
@@ -175,6 +199,7 @@ Eso permite:
 - 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`
+- bloquear la activación si `Claude Code` no está realmente instalado todavía
 
 ## Qwen OAuth
 

package/package.json

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

package/src/data/catalog-store.js

@@ -1,8 +1,14 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { DatabaseSync } from 'node:sqlite';
+import { resolveClaudeConnectHomeSync } from '../lib/app-paths.js';
 
-export const defaultCatalogDbPath = path.join(process.cwd(), 'storage', 'claude-connect.sqlite');
+export function getDefaultCatalogDbPath(options = {}) {
+  const pathModule = options.platform === 'win32' ? path.win32 : path.posix;
+  return pathModule.join(resolveClaudeConnectHomeSync(options), 'storage', 'claude-connect.sqlite');
+}
+
+export const defaultCatalogDbPath = getDefaultCatalogDbPath();
 
 const schemaSql = `
 PRAGMA foreign_keys = ON;
@@ -33,6 +39,7 @@ CREATE TABLE IF NOT EXISTS models (
   api_base_url TEXT,
   api_path TEXT,
   auth_env_mode TEXT NOT NULL DEFAULT 'auth_token',
+  supports_vision INTEGER NOT NULL DEFAULT 1,
   sort_order INTEGER NOT NULL DEFAULT 0,
   is_default INTEGER NOT NULL DEFAULT 0
 );
@@ -673,6 +680,46 @@ const seedProviders = [
       }
     ]
   },
+  {
+    id: 'inception',
+    name: 'Inception Labs',
+    vendor: 'Inception Labs',
+    description: 'Inception Platform con Mercury 2 sobre un endpoint OpenAI-compatible. Claude Code se conecta a traves del gateway local para mantener compatibilidad Anthropic y herramientas.',
+    docsUrl: 'https://docs.inceptionlabs.ai/get-started/get-started',
+    docsVerifiedAt: '2026-04-03',
+    baseUrl: 'https://api.inceptionlabs.ai/v1',
+    defaultModelId: 'mercury-2',
+    defaultAuthMethodId: 'token',
+    defaultApiKeyEnvVar: 'INCEPTION_API_KEY',
+    models: [
+      {
+        id: 'mercury-2',
+        name: 'Mercury 2',
+        category: 'OpenAI Chat Completions',
+        contextWindow: '128K',
+        summary: 'Modelo generalista y de razonamiento de Inception Labs expuesto por v1/chat/completions.',
+        upstreamModelId: 'mercury-2',
+        transportMode: 'gateway',
+        apiStyle: 'openai-chat',
+        apiBaseUrl: 'https://api.inceptionlabs.ai/v1',
+        apiPath: '/chat/completions',
+        authEnvMode: 'auth_token',
+        supportsVision: false,
+        sortOrder: 1,
+        isDefault: 1
+      }
+    ],
+    authMethods: [
+      {
+        id: 'token',
+        name: 'Token',
+        description: 'Conexion por API key de Inception Labs.',
+        credentialKind: 'env_var',
+        sortOrder: 1,
+        isDefault: 1
+      }
+    ]
+  },
   {
     id: 'openrouter',
     name: 'OpenRouter',
@@ -793,10 +840,10 @@ function seedCatalog(db) {
     INSERT INTO models (
       id, provider_id, name, category, context_window, summary,
       upstream_model_id,
-      transport_mode, api_style, api_base_url, api_path, auth_env_mode,
+      transport_mode, api_style, api_base_url, api_path, auth_env_mode, supports_vision,
       sort_order, is_default
     )
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     ON CONFLICT(id) DO UPDATE SET
       provider_id = excluded.provider_id,
       name = excluded.name,
@@ -809,6 +856,7 @@ function seedCatalog(db) {
       api_base_url = excluded.api_base_url,
       api_path = excluded.api_path,
       auth_env_mode = excluded.auth_env_mode,
+      supports_vision = excluded.supports_vision,
       sort_order = excluded.sort_order,
       is_default = excluded.is_default
   `);
@@ -879,6 +927,7 @@ function seedCatalog(db) {
           model.apiBaseUrl ?? null,
           model.apiPath ?? null,
           model.authEnvMode ?? 'auth_token',
+          model.supportsVision === false ? 0 : 1,
           model.sortOrder,
           model.isDefault
         );
@@ -950,6 +999,10 @@ function ensureSchemaMigrations(db) {
     alterStatements.push(`ALTER TABLE models ADD COLUMN auth_env_mode TEXT NOT NULL DEFAULT 'auth_token'`);
   }
 
+  if (!modelColumns.has('supports_vision')) {
+    alterStatements.push(`ALTER TABLE models ADD COLUMN supports_vision INTEGER NOT NULL DEFAULT 1`);
+  }
+
   if (!modelColumns.has('upstream_model_id')) {
     alterStatements.push(`ALTER TABLE models ADD COLUMN upstream_model_id TEXT`);
   }
@@ -992,6 +1045,7 @@ function mapModelRow(row) {
     apiBaseUrl: row.api_base_url,
     apiPath: row.api_path,
     authEnvMode: row.auth_env_mode,
+    supportsVision: Boolean(row.supports_vision),
     sortOrder: Number(row.sort_order),
     isDefault: Boolean(row.is_default)
   };
@@ -1021,7 +1075,7 @@ function mapOAuthRow(row) {
   };
 }
 
-export function createCatalogStore({ filename = defaultCatalogDbPath } = {}) {
+export function createCatalogStore({ filename = getDefaultCatalogDbPath() } = {}) {
   if (filename !== ':memory:') {
     fs.mkdirSync(path.dirname(filename), { recursive: true });
   }

package/src/gateway/server.js

@@ -24,6 +24,7 @@ import {
 } from './state.js';
 import { resolveClaudeConnectPaths } from '../lib/app-paths.js';
 import { readSwitchState } from '../lib/claude-settings.js';
+import { enforceModelTokenBudget } from '../lib/model-budget.js';
 import { readOAuthToken, refreshOAuthToken } from '../lib/oauth.js';
 import { readProfileFile } from '../lib/profile.js';
 import { readManagedProviderTokenSecret, readManagedTokenSecret } from '../lib/secrets.js';
@@ -161,6 +162,48 @@ function getUpstreamModelId(profile) {
   return profile?.model?.upstreamModelId ?? profile?.model?.id ?? 'unknown';
 }
 
+function requestContainsImageInput(body) {
+  return Array.isArray(body?.messages)
+    && body.messages.some((messageItem) => Array.isArray(messageItem?.content)
+      && messageItem.content.some((part) => part?.type === 'image'));
+}
+
+function profileSupportsImageInput(profile) {
+  if (typeof profile?.model?.supportsVision === 'boolean') {
+    return profile.model.supportsVision;
+  }
+
+  if (profile?.provider?.id === 'inception') {
+    return false;
+  }
+
+  return true;
+}
+
+function stringifyUpstreamMessage(value) {
+  if (typeof value === 'string') {
+    return value;
+  }
+
+  if (value == null) {
+    return '';
+  }
+
+  if (typeof value === 'object') {
+    if ('message' in value && typeof value.message === 'string') {
+      return value.message;
+    }
+
+    try {
+      return JSON.stringify(value);
+    } catch (_error) {
+      return String(value);
+    }
+  }
+
+  return String(value);
+}
+
 function resolveGatewayUpstreamConfig(profile) {
   if (profile?.provider?.id === 'ollama') {
     return {
@@ -335,9 +378,9 @@ async function forwardUpstreamRequest({ targetUrl, headers, payload, context, re
     });
   }
 
-  const message = responsePayload?.error?.message
-    || responsePayload?.message
-    || responsePayload?.error
+  const message = stringifyUpstreamMessage(responsePayload?.error?.message)
+    || stringifyUpstreamMessage(responsePayload?.message)
+    || stringifyUpstreamMessage(responsePayload?.error)
     || `HTTP ${response.status}`;
   const providerName = context?.profile?.provider?.name ?? context?.profile?.provider?.id ?? 'El proveedor';
   const containsImageInput = Array.isArray(payload?.messages)
@@ -453,9 +496,20 @@ async function handleCountTokens(request, response) {
 }
 
 async function handleMessages(request, response) {
-  const body = await readJsonBody(request);
+  const rawBody = await readJsonBody(request);
   const context = await resolveGatewayContext();
 
+  if (requestContainsImageInput(rawBody) && !profileSupportsImageInput(context.profile)) {
+    const providerName = context.profile.provider.name;
+    const modelName = context.profile.model.name;
+    throw new Error(`${providerName} no admite imagenes con el modelo ${modelName} en esta integracion. Usa un proveedor o modelo con soporte visual.`);
+  }
+
+  const body = enforceModelTokenBudget({
+    body: rawBody,
+    profile: context.profile
+  });
+
   if (context.upstreamApiStyle === 'anthropic') {
     const upstreamResponse = await forwardAnthropicMessage({
       requestBody: body,

package/src/lib/app-paths.js

@@ -1,4 +1,5 @@
 import fs from 'node:fs/promises';
+import fsSync from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import process from 'node:process';
@@ -48,6 +49,14 @@ async function pathExists(targetPath) {
   }
 }
 
+function pathExistsSync(targetPath) {
+  try {
+    return fsSync.existsSync(targetPath);
+  } catch (_error) {
+    return false;
+  }
+}
+
 function defaultHomedir(env, fallbackHomedir) {
   const pathModule = getPathModule(process.platform);
 
@@ -179,6 +188,18 @@ export async function resolveClaudeConnectHome(options = {}) {
   return candidates[0];
 }
 
+export function resolveClaudeConnectHomeSync(options = {}) {
+  const candidates = buildClaudeConnectHomeCandidates(options);
+
+  for (const candidate of candidates) {
+    if (pathExistsSync(candidate)) {
+      return candidate;
+    }
+  }
+
+  return candidates[0];
+}
+
 export async function resolveClaudeSettingsPath(options = {}) {
   if (typeof options.env?.CLAUDE_SETTINGS_PATH === 'string' && options.env.CLAUDE_SETTINGS_PATH.trim().length > 0) {
     return buildClaudeSettingsPathCandidates(options)[0];
@@ -244,6 +265,8 @@ export async function resolveClaudeConnectPaths(options = {}) {
 
   return {
     claudeConnectHome,
+    storageDir: path.join(claudeConnectHome, 'storage'),
+    catalogDbPath: path.join(claudeConnectHome, 'storage', 'claude-connect.sqlite'),
     profilesDir: path.join(claudeConnectHome, 'profiles'),
     tokensDir: path.join(claudeConnectHome, 'tokens'),
     secretsDir: path.join(claudeConnectHome, 'secrets'),
@@ -269,3 +292,90 @@ export async function resolveClaudePaths(options = {}) {
     ...claudeConnectPaths
   };
 }
+
+function buildExecutableNames(command, platform = process.platform, env = process.env) {
+  if (platform !== 'win32') {
+    return [command];
+  }
+
+  const pathext = typeof env.PATHEXT === 'string' && env.PATHEXT.length > 0
+    ? env.PATHEXT.split(';').filter(Boolean)
+    : ['.EXE', '.CMD', '.BAT', '.COM'];
+  const hasExt = path.win32.extname(command).length > 0;
+
+  if (hasExt) {
+    return [command];
+  }
+
+  return pathext.map((ext) => `${command}${ext.toLowerCase()}`);
+}
+
+export async function findExecutableOnPath(command, {
+  platform = process.platform,
+  env = process.env
+} = {}) {
+  const pathModule = getPathModule(platform);
+  const pathValue = typeof env.PATH === 'string' ? env.PATH : '';
+  const pathEntries = pathValue.split(path.delimiter).filter(Boolean);
+  const commandNames = buildExecutableNames(command, platform, env);
+
+  for (const directory of pathEntries) {
+    for (const commandName of commandNames) {
+      const candidate = pathModule.join(directory, commandName);
+
+      if (await pathExists(candidate)) {
+        return candidate;
+      }
+    }
+  }
+
+  return null;
+}
+
+export async function detectClaudeCodeInstallation(options = {}) {
+  const settingsCandidates = buildClaudeSettingsPathCandidates(options);
+  const accountCandidates = buildClaudeAccountPathCandidates(options);
+  const credentialsCandidates = buildClaudeCredentialsPathCandidates(options);
+  const executablePath = await findExecutableOnPath('claude', options);
+
+  const [existingSettingsPath, existingAccountPath, existingCredentialsPath] = await Promise.all([
+    (async () => {
+      for (const candidate of settingsCandidates) {
+        if (await pathExists(candidate)) {
+          return candidate;
+        }
+      }
+
+      return null;
+    })(),
+    (async () => {
+      for (const candidate of accountCandidates) {
+        if (await pathExists(candidate)) {
+          return candidate;
+        }
+      }
+
+      return null;
+    })(),
+    (async () => {
+      for (const candidate of credentialsCandidates) {
+        if (await pathExists(candidate)) {
+          return candidate;
+        }
+      }
+
+      return null;
+    })()
+  ]);
+
+  return {
+    isInstalled: Boolean(executablePath || existingSettingsPath || existingAccountPath || existingCredentialsPath),
+    executablePath,
+    existingSettingsPath,
+    existingAccountPath,
+    existingCredentialsPath,
+    settingsCandidates,
+    accountCandidates,
+    credentialsCandidates
+  };
+}

package/src/lib/claude-settings.js

@@ -1,6 +1,6 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
-import { resolveClaudePaths } from './app-paths.js';
+import { detectClaudeCodeInstallation, resolveClaudePaths } from './app-paths.js';
 import { readManagedProviderTokenSecret, readManagedTokenSecret } from './secrets.js';
 
 function isObject(value) {
@@ -240,6 +240,14 @@ export function buildClaudeSettingsForProfile({
 }
 
 export async function activateClaudeProfile({ profile, gatewayBaseUrl = 'http://127.0.0.1:4310/anthropic' }) {
+  const installation = await detectClaudeCodeInstallation();
+
+  if (!installation.isInstalled) {
+    throw new Error(
+      'Claude Code no parece estar instalado en esta maquina. Instala o ejecuta Claude Code primero y luego vuelve a activar la conexion.'
+    );
+  }
+
   const {
     claudeSettingsPath,
     claudeAccountPath,

package/src/lib/model-budget.js

@@ -0,0 +1,73 @@
+import { estimateTokenCountFromAnthropicRequest } from '../gateway/messages.js';
+
+function getModelIdentity(profile) {
+  return profile?.model?.upstreamModelId ?? profile?.model?.id ?? '';
+}
+
+export function getModelTokenLimits(profile) {
+  const providerId = profile?.provider?.id;
+  const modelId = getModelIdentity(profile);
+
+  if (providerId === 'inception' && modelId === 'mercury-2') {
+    return {
+      contextWindowTokens: 128_000,
+      defaultOutputTokens: 8_192,
+      maxOutputTokens: 16_384
+    };
+  }
+
+  if (providerId === 'deepseek' && modelId === 'deepseek-chat') {
+    return {
+      contextWindowTokens: 128_000,
+      defaultOutputTokens: 4_000,
+      maxOutputTokens: 8_000
+    };
+  }
+
+  if (providerId === 'deepseek' && modelId === 'deepseek-reasoner') {
+    return {
+      contextWindowTokens: 128_000,
+      defaultOutputTokens: 32_000,
+      maxOutputTokens: 64_000
+    };
+  }
+
+  return null;
+}
+
+export function enforceModelTokenBudget({ body, profile, safetyMarginTokens = 1024 }) {
+  const limits = getModelTokenLimits(profile);
+
+  if (!limits) {
+    return body;
+  }
+
+  const estimatedInputTokens = estimateTokenCountFromAnthropicRequest(body);
+  const availableForOutput = limits.contextWindowTokens - estimatedInputTokens - safetyMarginTokens;
+
+  if (availableForOutput <= 0) {
+    throw new Error(
+      `La conversacion actual excede el contexto aproximado de ${limits.contextWindowTokens.toLocaleString('en-US')} tokens para ${profile.model.name}. Usa /compact o /clear antes de continuar.`
+    );
+  }
+
+  const requestedOutputTokens = typeof body?.max_tokens === 'number'
+    ? body.max_tokens
+    : limits.defaultOutputTokens;
+  const clampedOutputTokens = Math.min(
+    requestedOutputTokens,
+    limits.maxOutputTokens,
+    availableForOutput
+  );
+
+  if (clampedOutputTokens < 256) {
+    throw new Error(
+      `Queda muy poco margen de salida para ${profile.model.name} dentro de su contexto aproximado de ${limits.contextWindowTokens.toLocaleString('en-US')} tokens. Usa /compact o /clear antes de continuar.`
+    );
+  }
+
+  return {
+    ...body,
+    max_tokens: clampedOutputTokens
+  };
+}

package/src/lib/profile.js

@@ -32,7 +32,8 @@ export function buildProfile({ provider, model, authMethod, profileName, apiKeyE
       apiStyle: model.apiStyle,
       apiBaseUrl: model.apiBaseUrl,
       apiPath: model.apiPath,
-      authEnvMode: model.authEnvMode
+      authEnvMode: model.authEnvMode,
+      supportsVision: model.supportsVision ?? true
     },
     auth: {
       method: authMethod.id

package/src/lib/terminal.js

@@ -19,7 +19,26 @@ export function openAppScreen() {
 }
 
 export function closeAppScreen() {
-  process.stdout.write('\x1b[?25h\x1b[?1049l');
+  process.stdout.write('\x1b[?25h\x1b[?1049l\r\n');
+}
+
+function beginKeyboardCapture() {
+  readline.emitKeypressEvents(process.stdin);
+  process.stdin.resume();
+  process.stdin.setRawMode(true);
+}
+
+function restoreKeyboardState(onKeypress) {
+  if (typeof onKeypress === 'function') {
+    process.stdin.removeListener('keypress', onKeypress);
+  }
+
+  if (process.stdin.isTTY && process.stdin.isRaw) {
+    process.stdin.setRawMode(false);
+  }
+
+  process.stdin.pause();
+  process.stdout.write('\x1b[?25h');
 }
 
 export function clearScreen() {
@@ -64,13 +83,11 @@ export function buildFrame({ eyebrow, title, subtitle, body = [], footer = [] })
 
 export function waitForAnyKey(message = 'Presiona una tecla para continuar.') {
   return new Promise((resolve, reject) => {
-    readline.emitKeypressEvents(process.stdin);
-    process.stdin.setRawMode(true);
+    beginKeyboardCapture();
     let escapePending = false;
 
     const cleanup = () => {
-      process.stdin.removeListener('keypress', onKeypress);
-      process.stdin.setRawMode(false);
+      restoreKeyboardState(onKeypress);
     };
 
     const onKeypress = (_input, key = {}) => {
@@ -124,12 +141,10 @@ export function selectFromList({
     let selectedIndex = 0;
     let escapePending = false;
 
-    readline.emitKeypressEvents(process.stdin);
-    process.stdin.setRawMode(true);
+    beginKeyboardCapture();
 
     const cleanup = () => {
-      process.stdin.removeListener('keypress', onKeypress);
-      process.stdin.setRawMode(false);
+      restoreKeyboardState(onKeypress);
     };
 
     const render = () => {
@@ -247,12 +262,10 @@ export function promptText({
     let value = '';
     let escapePending = false;
 
-    readline.emitKeypressEvents(process.stdin);
-    process.stdin.setRawMode(true);
+    beginKeyboardCapture();
 
     const cleanup = () => {
-      process.stdin.removeListener('keypress', onKeypress);
-      process.stdin.setRawMode(false);
+      restoreKeyboardState(onKeypress);
     };
 
     const render = () => {

package/src/wizard.js

@@ -433,7 +433,22 @@ async function activateClaudeFromSavedProfile() {
     return profile;
   }
 
-  const result = await activateClaudeProfile({ profile });
+  let result;
+
+  try {
+    result = await activateClaudeProfile({ profile });
+  } catch (error) {
+    renderInfoScreen({
+      title: 'No se pudo activar Claude',
+      subtitle: 'Claude Connect no pudo aplicar la conexion en Claude Code.',
+      lines: [
+        colorize(error instanceof Error ? error.message : String(error), colors.warning)
+      ],
+      footer: 'Presiona una tecla para volver'
+    });
+    return await waitForAnyKey();
+  }
+
   const gateway = result.connectionMode === 'gateway'
     ? await restartGatewayInBackground()
     : await stopGateway();