Claudex

Claudex es una TUI de IA para terminal con proveedores directos. Esta version esta pensada para instalarse con un solo comando, abrir claudex, escoger proveedor/modelo desde /model y trabajar sin depender de un gateway externo como backend.

Instalacion Rapida

Cuando el paquete este publicado en npm:

npm install -g @balckyshadownis/claudex
claudex

Instalacion por curl:

curl -fsSL https://raw.githubusercontent.com/JaredBautist/CLAUDEX/main/scripts/install.sh | bash
claudex

Si todavia no esta publicado en npm, puedes instalar directo desde GitHub:

npm install -g github:JaredBautist/CLAUDEX
claudex

El nombre del paquete npm es @balckyshadownis/claudex, pero el comando global instalado es siempre:

claudex

Requisitos

• Node.js 20 o superior.
• npm 9 o superior.
• Cuenta, OAuth o API key del proveedor que quieras usar.

Claudex incluye Bun como dependencia npm para poder abrir la TUI desde una instalacion global. Si el usuario ya tiene bun instalado en el sistema, Claudex tambien puede usarlo como fallback.

Proveedores

Soporte directo actual:

• Claude / Anthropic
• OpenAI / ChatGPT
• Gemini / Google

Desde la TUI usa:

/model

Ese comando sirve para elegir proveedor, iniciar sesion o seleccionar modelo.

Uso

Abrir la TUI:

claudex

Enviar un prompt directo sin abrir la TUI:

claudex chat "explica este proyecto"

Configurar proveedor con API key:

claudex auth claude
claudex auth openai
claudex auth gemini

Guardar una key sin prompt interactivo:

claudex key openai "$OPENAI_API_KEY"

Cambiar proveedor/modelo activo:

claudex use claude claude-3-5-sonnet-latest
claudex use openai gpt-5.5
claudex use gemini gemini-2.5-pro

Ejecutar con override temporal:

claudex -p openai -m gpt-4o-mini chat "resume el repo"

Configuracion Local

Claudex guarda la configuracion del usuario fuera del repo:

~/.config/claudex/direct-providers.json
~/.config/claudex/claude-runtime/

Tambien puedes usar variables de entorno:

ANTHROPIC_API_KEY=...
ANTHROPIC_AUTH_TOKEN=...
OPENAI_API_KEY=...
GEMINI_API_KEY=...

Desarrollo

Instalar dependencias:

npm install

Ejecutar desde el repo:

npm start

Abrir la TUI desde el codigo fuente:

node src/direct/chat.js

Empaquetar localmente:

npm pack

Probar el paquete local:

npm install -g ./jaredbautist-claudex-0.1.0.tgz
claudex --help
claudex

Publicacion En Npm

El nombre claudex ya existe en npm, por eso este proyecto publica como paquete scoped:

{
  "name": "@balckyshadownis/claudex",
  "bin": {
    "claudex": "src/direct/chat.js"
  }
}

Dry-run antes de publicar:

npm publish --dry-run --access public --tag next

Publicar:

npm login
npm publish --access public

Despues de publicar, cualquier usuario instala:

npm install -g @balckyshadownis/claudex
claudex

Troubleshooting

Si claudex no aparece despues de instalar:

npm bin -g
npm prefix -g

Asegurate de que el directorio global de npm este en tu PATH.

Si la TUI no abre, verifica:

node --version
npm --version
claudex --help

Si cambias de proveedor y no hay credenciales guardadas:

claudex auth openai
claudex use openai gpt-4o-mini
claudex