# CLI — Ghosty desde la terminal

> Instala el CLI oficial de Ghosty Studio, entra con tu cuenta y configura, prueba y platica con tus agentes desde la terminal.

URL: https://www.ghosty.studio/docs/cli

`ghosty` es el CLI oficial de Ghosty Studio. Sirve para lo mismo que el panel —configurar, probar y platicar con tus agentes— pero desde la terminal, y está hecho para que **tu agente de código** (Claude Code, Codex, Cursor) también lo use.

## Instalar

:::tabs
```bash tab=npx
npx -y @ghostystudio/cli --help
```
```bash tab=Global
npm i -g @ghostystudio/cli
ghosty --help
```
:::

Necesitas Node 22 o más nuevo.

## Entrar

```bash
ghosty login
```

Se abre tu navegador, entras con tu cuenta de Ghosty (Google, Apple o correo) y listo: la terminal queda con sesión. Si ya tenías sesión abierta en ghosty.studio, no tienes que hacer nada más que abrir la liga.

- Si el navegador no se abre solo, la terminal imprime la liga para que la copies.
- La sesión se renueva sola; dura 90 días sin uso antes de pedirte entrar de nuevo.
- Si corres un comando sin sesión, el login arranca solo.
- ¿Estás por SSH o en otra máquina? `ghosty login --device` te da una liga y un código para autorizar desde tu teléfono (por SSH lo hace solo).
- `ghosty whoami` te dice con qué cuenta estás; `ghosty logout` cierra la sesión y la revoca.

### Que tu agente de código lo haga por ti

Pídele a Claude Code «entra a Ghosty con el CLI». Él corre `ghosty login`, te pasa la liga en el chat, tú la abres y él sigue solo. Detalle en [CLI para agentes de código](/docs/cli/agentes-de-codigo).

## Primeros pasos

```bash
ghosty agents ls                          # tus agentes
ghosty try <agent-id> "hola, ¿quién eres?"  # un turno de prueba
ghosty chat <agent-id>                    # conversación en vivo
```

Todos los comandos, con ejemplos, en la [referencia de comandos](/docs/cli/comandos).

## Dónde se guarda la sesión

En `~/.config/ghosty/config.json`, con permisos sólo para tu usuario. Para apuntar a otro servidor usa la variable `GHOSTY_URL`.