Consilium para VS Code
Comparte la sesión de Claude Code de la carpeta que tengas abierta, desde un
botón en la barra de estado. Sin terminal.
Qué hace exactamente
Al pulsar Compartir sesión:
- Toma la carpeta abierta como
SESSION_WORKDIR — eso es «el proyecto compartido».
- Arranca el
runner en tu máquina, apuntando a la sala que configuraste.
- Te da el enlace de invitación, listo para copiar.
Quien reciba el enlace entra por el navegador, escribe, y sus mensajes se
inyectan en tu sesión con su nombre por delante.
Qué NO hace
No ejecuta Claude en la nube. Claude corre aquí, en tu máquina, bajo tu
suscripción y sobre tus ficheros. La sala (Vercel o donde la despliegues) solo
reparte mensajes; nunca habla con Claude.
Por eso hace falta que este proceso esté vivo: si cierras VS Code o pulsas
«dejar de compartir», la sala se queda sin sesión.
Instalación
La extensión es autónoma: trae su propio runner empaquetado, así que no hace
falta clonar nada para usarla.
Desde el Marketplace, o con el .vsix que sirve tu propia instalación:
Extensiones → ⋯ → Install from VSIX…
La primera vez que compartas descargará el motor de Claude (~250 MB) en el
almacén de la extensión. No va dentro del paquete a propósito: es un binario
distinto por sistema operativo, y así cada máquina se trae el suyo. Solo pasa
una vez; hace falta tener node y npm en el PATH.
Necesitas Claude Code y tu suscripción para compartir. Para unirte al
proyecto de otra persona no hace falta nada de eso: basta el enlace que te pasen.
Primer uso
La primera vez pide dos datos: la URL de tu sala y su RUNNER_SECRET. Quedan
guardados (el secreto, cifrado) y no se vuelven a pedir en esa máquina.
El orden en el que busca:
- Almacén cifrado de VS Code (donde queda tras la primera vez).
.env del clon, si has configurado consilium.repoPath.- Te lo pregunta.
El secreto no se guarda en settings.json: va al almacén cifrado del
editor. Si tenías la versión anterior, se migra solo y se borra del ajuste.
Consilium: olvidar el secreto guardado lo borra si quieres cambiarlo.
Ajustes
| Ajuste |
Por defecto |
Para qué |
consilium.relayUrl |
— |
URL de la sala |
consilium.repoPath |
— |
Solo desarrollo: usar el runner de un clon |
consilium.model |
claude-opus-5 |
Modelo de la sesión |
consilium.toolAllowlist |
Read,Glob,Grep,TodoWrite |
Herramientas que no piden permiso |
consilium.shareOnStartup |
false |
Compartir al abrir una carpeta |
Sobre los permisos
Todo lo que no esté en consilium.toolAllowlist —Write, Edit, Bash…—
pide permiso antes de ejecutarse, con un banner en la sala. Sin respuesta en
120 segundos, se deniega.
Quién puede aprobar lo decides tú con consilium.whoApproves, o desde el menú
del botón → Quién aprueba herramientas:
| Valor |
Quién aprueba |
writers (por defecto) |
tú y quien tenga enlace de escritura |
host |
solo tú |
Un enlace de solo lectura no aprueba nunca. Ten presente qué estás concediendo:
aprobar un Bash ejecuta un comando en tu máquina, con tus credenciales y
tus ficheros.
Ampliar la allowlist es una decisión consciente: lo que añadas ahí deja de
pedir permiso para todos los participantes, no solo para ti.
Seguridad
- El secreto se guarda en los ajustes de usuario. Usa los de usuario, no los
del espacio de trabajo, para que no acabe en un repositorio.
- Si tienes
ANTHROPIC_API_KEY en el entorno, la extensión te avisa y el runner
se niega a arrancar: facturaría contra la API en vez de usar tu suscripción.
- Quien entre en la sala como
host puede aprobar permisos sobre tu máquina.
En un despliegue accesible desde internet, pon AUTH_MODE=token en la sala.
