harnsy
Empieza gratis
ES

Primeros pasos

Instala harnsy y conoce a tu primer equipo. Elige tu programa de IA y tu ordenador, y los pasos se abren de uno en uno.

¿Prefieres verlo? Un vídeo de 33 minutos, de la instalación a un sitio terminado ↓

O pídeselo a tu programa de IA

Pega esto en tu programa de IA. Lee una guía breve escrita para agentes, te dice qué cambia la instalación y espera tu «sí».

Instala harnsy siguiendo https://harnsy.dev/llms.txt

1. Instalación

Claude Code en Linux

Antes de empezar (páginas de Anthropic, leídas el 8 de noviembre de 2026): Claude Code necesita una cuenta Pro, Max, Ultra, Team, Enterprise o Console; el plan gratuito de claude.ai no lo incluye; tienes que vivir en un país donde Anthropic ofrezca Claude Code; Ubuntu 20.04+/Debian 10+ (Alpine 3.19+), 4 GB de memoria, internet. Enlaces: instrucciones de instalación de Anthropic, precios, guía de la terminal. En el texto no hay precios.

Inicias sesión en la página del proveedor. El código va directamente al programa en este ordenador, que guarda el inicio de sesión donde lo guarda siempre. harnsy no lee el inicio de sesión para usarlo y no lo envía a ningún sitio; solo pregunta al programa si has iniciado sesión. Antes de cambiar el archivo de ajustes del programa, que también puede contener tu inicio de sesión, harnsy guarda una copia de seguridad en este ordenador (consulta «Claves, inicios de sesión y conexiones»).

  1. Abre una terminal

    Una terminal es una ventana donde escribes comandos. Linux: abre tu aplicación de terminal. Los instaladores no piden permisos de administrador.

    Verás: una ventana con un cursor que parpadea.

  2. Crea tu cuenta de Claude y elige un plan

    En el navegador, ve a claude.ai, crea una cuenta y, en la página de precios de Anthropic, elige un plan que incluya Claude Code; págalo allí.

    Verás: has iniciado sesión en claude.ai.

  3. Instala Claude Code

    Es el comando de Anthropic (no de harnsy; puedes leer el script antes abriendo la dirección en un navegador):

    Shell
    curl -fsSL https://claude.ai/install.sh | bash

    Verás: mientras se descarga, no se mueve nada. En Alpine, o sin curl/bash, la página de Anthropic indica los paquetes que faltan.

  4. Compruébalo

    Abre una terminal nueva y ejecuta claude --version.

    Verás: un número de versión. Si no se encuentra claude, la carpeta de instalación no está en tu PATH: la página de instalación de Anthropic tiene la solución.

  5. Inicia sesión

    Ejecuta claude en cualquier carpeta, sigue las indicaciones del navegador, inicia sesión con tu cuenta de Claude y luego ciérralo (Ctrl+C dos veces).

    Verás: Claude Code te pide iniciar sesión y después se abre.

  6. Instala harnsy

    Puedes hacerlo de dos formas. Las dos llevan al mismo instalador.

    Forma A: pídeselo a tu programa de IA. Ábrelo (escribe claude o codex) y dile:

    Read https://harnsy.dev/llms.txt and help me install and set up harnsy.

    Lee una guía breve escrita para agentes. Antes de instalar, te dice qué cambia la instalación (los archivos de ajustes de Claude Code y Codex: hooks y una entrada «permitir harnsy» para que los agentes puedan llamar a harnsy sin preguntar cada vez, en todas tus sesiones de Claude Code en este ordenador; se guarda una copia de seguridad) y espera tu «sí». Después instala harnsy por ti. Si tu programa de IA no puede ejecutar el instalador descargado, te pide que ejecutes el comando tú, en tu propia terminal; es el mismo comando que en la forma B, y no te pregunta nada. No busques otra manera de saltártelo: es la protección propia de tu programa de IA. Después comprueba que harnsy funciona y te hace una pregunta, con botones: desde qué carpeta empezar. Crea tu empresa y tu primer proyecto, abre a tu líder y abre el navegador en tu chat con el líder.

    Forma B: escribe el comando. Puedes leer el script antes de ejecutarlo: abre https://harnsy.dev/install.sh en tu navegador. Esta prueba no cambia nada; muestra lo que haría el instalador:

    Shell
    curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run

    Verás: cada paso que daría el instalador. No se escribe nada.

    Ahora instala. En un ordenador que nunca ha tenido harnsy, añade --first-run:

    Shell
    curl -fsSL https://harnsy.dev/install.sh | sh -s -- --first-run

    Verás: con --first-run el instalador no te pregunta nada. Dice «sí» por adelantado al conjunto propio de harnsy: los agentes pueden abrirse en sus propias ventanas, cada agente nuevo recibe una nota breve sobre harnsy, puedes responder a las preguntas de los agentes desde el navegador, y los agentes pueden hablar con harnsy sin preguntar cada vez. Eso cambia archivos de ajustes de Claude Code y Codex (hooks); cada cambio se muestra y se guarda una copia de seguridad. No instala icono en la bandeja ni línea de estado. Al final imprime «Qué cambió en este ordenador» y cómo deshacerlo (harnsy uninstall). En un ordenador que ya tuvo harnsy (también uno donde se desinstaló, que conserva sus datos), --first-run se ignora y el instalador pregunta como de costumbre.

    Comprueba que funciona. Abre http://127.0.0.1:7788 en tu navegador.

    Verás: el panel de harnsy. En un ordenador que aún no tiene ninguna empresa, empieza con «Elige tu idioma»: es el primer inicio, sigue.

    Tus agentes funcionan en tmux si está instalado (3.1 o posterior) y, si no, en el host de terminal propio de harnsy; no instalas nada, y el panel muestra cada agente en vivo. --first-run lo elige por ti sin preguntar; una instalación normal pregunta una vez y guarda tu respuesta.

Claude Code en macOS

Antes de empezar (páginas de Anthropic, leídas el 8 de noviembre de 2026): Claude Code necesita una cuenta Pro, Max, Ultra, Team, Enterprise o Console; el plan gratuito de claude.ai no lo incluye; tienes que vivir en un país donde Anthropic ofrezca Claude Code; macOS 13+, 4 GB de memoria, internet. Enlaces: instrucciones de instalación de Anthropic, precios, guía de la terminal. En el texto no hay precios.

Inicias sesión en la página del proveedor. El código va directamente al programa en este ordenador, que guarda el inicio de sesión donde lo guarda siempre. harnsy no lee el inicio de sesión para usarlo y no lo envía a ningún sitio; solo pregunta al programa si has iniciado sesión. Antes de cambiar el archivo de ajustes del programa, que también puede contener tu inicio de sesión, harnsy guarda una copia de seguridad en este ordenador (consulta «Claves, inicios de sesión y conexiones»).

  1. Abre una terminal

    Una terminal es una ventana donde escribes comandos. macOS: abre Terminal (Aplicaciones › Utilidades › Terminal). Los instaladores no piden permisos de administrador.

    Verás: una ventana con un cursor que parpadea.

  2. Crea tu cuenta de Claude y elige un plan

    En el navegador, ve a claude.ai, crea una cuenta y, en la página de precios de Anthropic, elige un plan que incluya Claude Code; págalo allí.

    Verás: has iniciado sesión en claude.ai.

  3. Instala Claude Code

    Es el comando de Anthropic (no de harnsy; puedes leer el script antes abriendo la dirección en un navegador):

    Shell
    curl -fsSL https://claude.ai/install.sh | bash

    Si ya usas Homebrew, puedes ejecutar esto en su lugar (necesita macOS 13 o posterior; también es un comando de Anthropic; las instalaciones con Homebrew no se actualizan solas: la página de Anthropic explica cómo actualizar):

    Shell
    brew install --cask claude-code

    Verás: mientras se descarga, no se mueve nada. En Alpine, o sin curl/bash, la página de Anthropic indica los paquetes que faltan.

  4. Compruébalo

    Abre una terminal nueva y ejecuta claude --version.

    Verás: un número de versión. Si no se encuentra claude, la carpeta de instalación no está en tu PATH: la página de instalación de Anthropic tiene la solución.

  5. Inicia sesión

    Ejecuta claude en cualquier carpeta, sigue las indicaciones del navegador, inicia sesión con tu cuenta de Claude y luego ciérralo (Ctrl+C dos veces).

    Verás: Claude Code te pide iniciar sesión y después se abre.

  6. Instala harnsy

    Puedes hacerlo de dos formas. Las dos llevan al mismo instalador.

    Forma A: pídeselo a tu programa de IA. Ábrelo (escribe claude o codex) y dile:

    Read https://harnsy.dev/llms.txt and help me install and set up harnsy.

    Lee una guía breve escrita para agentes. Antes de instalar, te dice qué cambia la instalación (los archivos de ajustes de Claude Code y Codex: hooks y una entrada «permitir harnsy» para que los agentes puedan llamar a harnsy sin preguntar cada vez, en todas tus sesiones de Claude Code en este ordenador; se guarda una copia de seguridad) y espera tu «sí». Después instala harnsy por ti. Si tu programa de IA no puede ejecutar el instalador descargado, te pide que ejecutes el comando tú, en tu propia terminal; es el mismo comando que en la forma B, y no te pregunta nada. No busques otra manera de saltártelo: es la protección propia de tu programa de IA. Después comprueba que harnsy funciona y te hace una pregunta, con botones: desde qué carpeta empezar. Crea tu empresa y tu primer proyecto, abre a tu líder y abre el navegador en tu chat con el líder.

    Forma B: escribe el comando. Puedes leer el script antes de ejecutarlo: abre https://harnsy.dev/install.sh en tu navegador. Esta prueba no cambia nada; muestra lo que haría el instalador:

    Shell
    curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run

    Verás: cada paso que daría el instalador. No se escribe nada.

    Ahora instala. En un ordenador que nunca ha tenido harnsy, añade --first-run:

    Shell
    curl -fsSL https://harnsy.dev/install.sh | sh -s -- --first-run

    Verás: con --first-run el instalador no te pregunta nada. Dice «sí» por adelantado al conjunto propio de harnsy: los agentes pueden abrirse en sus propias ventanas, cada agente nuevo recibe una nota breve sobre harnsy, puedes responder a las preguntas de los agentes desde el navegador, y los agentes pueden hablar con harnsy sin preguntar cada vez. Eso cambia archivos de ajustes de Claude Code y Codex (hooks); cada cambio se muestra y se guarda una copia de seguridad. No instala icono en la bandeja ni línea de estado. Al final imprime «Qué cambió en este ordenador» y cómo deshacerlo (harnsy uninstall). En un ordenador que ya tuvo harnsy (también uno donde se desinstaló, que conserva sus datos), --first-run se ignora y el instalador pregunta como de costumbre.

    Comprueba que funciona. Abre http://127.0.0.1:7788 en tu navegador.

    Verás: el panel de harnsy. En un ordenador que aún no tiene ninguna empresa, empieza con «Elige tu idioma»: es el primer inicio, sigue.

    Nota: las propias notas de harnsy dicen que la instalación en macOS aún no se ha verificado en un Mac real. El instalador no cambia tu PATH: si ~/.local/bin no está en él, el instalador te lo dice y lo añades tú. Si la primera vez que arranca un agente macOS muestra una ventana para instalar las herramientas para desarrolladores, ejecuta antes xcode-select --install.

    Tus agentes funcionan en tmux si está instalado (3.1 o posterior) y, si no, en el host de terminal propio de harnsy; no instalas nada, y el panel muestra cada agente en vivo. --first-run lo elige por ti sin preguntar; una instalación normal pregunta una vez y guarda tu respuesta.

Claude Code en Windows

Antes de empezar (páginas de Anthropic, leídas el 8 de noviembre de 2026): Claude Code necesita una cuenta Pro, Max, Ultra, Team, Enterprise o Console; el plan gratuito de claude.ai no lo incluye; tienes que vivir en un país donde Anthropic ofrezca Claude Code; Windows 10 1809+, 4 GB de memoria, internet. Enlaces: instrucciones de instalación de Anthropic, precios, guía de la terminal. En el texto no hay precios.

Inicias sesión en la página del proveedor. El código va directamente al programa en este ordenador, que guarda el inicio de sesión donde lo guarda siempre. harnsy no lee el inicio de sesión para usarlo y no lo envía a ningún sitio; solo pregunta al programa si has iniciado sesión. Antes de cambiar el archivo de ajustes del programa, que también puede contener tu inicio de sesión, harnsy guarda una copia de seguridad en este ordenador (consulta «Claves, inicios de sesión y conexiones»).

  1. Abre una terminal

    Una terminal es una ventana donde escribes comandos. Windows: abre PowerShell (menú Inicio, escribe «PowerShell») (no CMD: el indicador muestra PS C:\). Los instaladores no piden permisos de administrador.

    Verás: una ventana con un cursor que parpadea.

  2. Crea tu cuenta de Claude y elige un plan

    En el navegador, ve a claude.ai, crea una cuenta y, en la página de precios de Anthropic, elige un plan que incluya Claude Code; págalo allí.

    Verás: has iniciado sesión en claude.ai.

  3. Instala Claude Code

    Es el comando de Anthropic; necesita Windows 10 1809 o posterior y no pide permisos de administrador; Git for Windows es opcional y solo añade una herramienta Bash a Claude Code.

    PowerShell
    irm https://claude.ai/install.ps1 | iex

    Verás: mientras se descarga, no se mueve nada. Si PowerShell dice The token '&&' is not a valid statement separator, estás en PowerShell, que es lo correcto para este comando; si dice 'irm' is not recognized, estás en CMD: abre PowerShell.

  4. Compruébalo

    Abre una ventana nueva de PowerShell y ejecuta claude --version.

    Verás: un número de versión. Si no se encuentra claude, la carpeta de instalación no está en tu PATH: la página de instalación de Anthropic tiene la solución.

  5. Inicia sesión

    Ejecuta claude en cualquier carpeta, sigue las indicaciones del navegador, inicia sesión con tu cuenta de Claude y luego ciérralo (Ctrl+C dos veces).

    Verás: Claude Code te pide iniciar sesión y después se abre.

  6. Instala harnsy

    Puedes hacerlo de dos formas. Las dos llevan al mismo instalador.

    Forma A: pídeselo a tu programa de IA. Ábrelo (escribe claude o codex) y dile:

    Read https://harnsy.dev/llms.txt and help me install and set up harnsy.

    Lee una guía breve escrita para agentes. Antes de instalar, te dice qué cambia la instalación (los archivos de ajustes de Claude Code y Codex: hooks y una entrada «permitir harnsy» para que los agentes puedan llamar a harnsy sin preguntar cada vez, en todas tus sesiones de Claude Code en este ordenador; se guarda una copia de seguridad) y espera tu «sí». Después instala harnsy por ti. Si tu programa de IA no puede ejecutar el instalador descargado, te pide que ejecutes el comando tú, en tu propia terminal; es el mismo comando que en la forma B, y no te pregunta nada. No busques otra manera de saltártelo: es la protección propia de tu programa de IA. Después comprueba que harnsy funciona y te hace una pregunta, con botones: desde qué carpeta empezar. Crea tu empresa y tu primer proyecto, abre a tu líder y abre el navegador en tu chat con el líder.

    Forma B: escribe el comando. Puedes leer el script antes de ejecutarlo: abre https://harnsy.dev/install.ps1 en tu navegador. Esta prueba no cambia nada; muestra lo que haría el instalador:

    PowerShell
    $env:HARNSY_INSTALL_ARGS = "--dry-run"; irm https://harnsy.dev/install.ps1 | iex

    Verás: cada paso que daría el instalador. No se escribe nada.

    Ahora instala. En un ordenador que nunca ha tenido harnsy, añade --first-run:

    PowerShell
    $env:HARNSY_INSTALL_ARGS = "--first-run"; irm https://harnsy.dev/install.ps1 | iex

    Verás: con --first-run el instalador no te pregunta nada. Dice «sí» por adelantado al conjunto propio de harnsy: los agentes pueden abrirse en sus propias ventanas, cada agente nuevo recibe una nota breve sobre harnsy, puedes responder a las preguntas de los agentes desde el navegador, y los agentes pueden hablar con harnsy sin preguntar cada vez. Eso cambia archivos de ajustes de Claude Code y Codex (hooks); cada cambio se muestra y se guarda una copia de seguridad. No instala icono en la bandeja ni línea de estado. Al final imprime «Qué cambió en este ordenador» y cómo deshacerlo (harnsy uninstall). En un ordenador que ya tuvo harnsy (también uno donde se desinstaló, que conserva sus datos), --first-run se ignora y el instalador pregunta como de costumbre.

    Comprueba que funciona. Abre http://127.0.0.1:7788 en tu navegador.

    Verás: el panel de harnsy. En un ordenador que aún no tiene ninguna empresa, empieza con «Elige tu idioma»: es el primer inicio, sigue.

    Nota: el instalador añade su carpeta a tu PATH de usuario: escribe harnsy en una ventana nueva de PowerShell. Windows Security a veces marca harnsy.exe; creemos que es un falso positivo (consulta «Solución de problemas»).

    Tus agentes funcionan en el host de terminal propio de harnsy (ConPTY); no instalas nada, y el panel muestra cada agente en vivo. --first-run lo elige por ti sin preguntar; una instalación normal pregunta una vez y guarda tu respuesta.

Codex en Linux

Antes de empezar (páginas de OpenAI, leídas el 8 de noviembre de 2026): la página de precios de OpenAI dice que Codex está incluido en los planes ChatGPT Free, Go, Plus, Pro, Business, Edu y Enterprise (las funciones varían según el plan; hay límites de uso), y que en su lugar puedes pagar por uso de la API con una clave de API. Enlaces: Codex CLI, precios, formas de iniciar sesión. En el texto no hay precios. También tienes que vivir en un país donde OpenAI ofrezca ChatGPT y Codex (la lista está en las páginas de OpenAI).

Inicias sesión en la página del proveedor. El código va directamente al programa en este ordenador, que guarda el inicio de sesión donde lo guarda siempre. harnsy no lee el inicio de sesión para usarlo y no lo envía a ningún sitio; solo pregunta al programa si has iniciado sesión. Antes de cambiar el archivo de ajustes del programa, que también puede contener tu inicio de sesión, harnsy guarda una copia de seguridad en este ordenador (consulta «Claves, inicios de sesión y conexiones»).

  1. Abre una terminal

    Una terminal es una ventana donde escribes comandos. Linux: abre tu aplicación de terminal. Los instaladores no piden permisos de administrador.

    Verás: una ventana con un cursor que parpadea.

  2. Consigue una cuenta de ChatGPT con un plan que incluya Codex

    En el navegador, ve a chatgpt.com, crea una cuenta si no tienes, y elige un plan en la página de precios de OpenAI (Codex está incluido en Free, Go, Plus, Pro, Business, Edu y Enterprise; hay límites de uso). O usa una clave de API y paga por uso de la API (página de precios de OpenAI). Una clave de API es un secreto: guárdala en tu propio entorno (por ejemplo, OPENAI_API_KEY); no la pongas en un prompt, en un archivo ni en un mensaje a un agente, y no la pegues en harnsy.

    Verás: has iniciado sesión en chatgpt.com.

  3. Instala Codex

    Es el comando de OpenAI (no de harnsy; puedes leer el script antes abriendo la dirección en un navegador):

    Shell
    curl -fsSL https://chatgpt.com/codex/install.sh | sh

    La página de OpenAI también tiene pestañas para npm y Homebrew; léelas allí.

    Verás: el instalador termina y codex se puede iniciar en una terminal nueva.

  4. Inicia sesión

    En una carpeta de proyecto, ejecuta codex. La primera vez, elige «Sign in with ChatGPT» y termina en el navegador. En una máquina sin navegador, OpenAI recomienda codex login --device-auth (en beta; escribes un código en la página de OpenAI). Con una clave de API: printenv OPENAI_API_KEY | codex login --with-api-key. Para comprobarlo: codex login status.

    Verás: una página del navegador para iniciar sesión y después se abre Codex. Ciérralo cuando hayas entrado.

  5. Instala harnsy

    La forma «pídeselo a tu programa de IA» está escrita para Claude Code; no se ha probado con Codex. Si la usas y Codex te pide aprobar un comando, lee antes el comando.

    Forma B: escribe el comando. Puedes leer el script antes de ejecutarlo: abre https://harnsy.dev/install.sh en tu navegador. Esta prueba no cambia nada; muestra lo que haría el instalador:

    Shell
    curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run

    Verás: cada paso que daría el instalador. No se escribe nada.

    Ahora instala. En un ordenador que nunca ha tenido harnsy, añade --first-run:

    Shell
    curl -fsSL https://harnsy.dev/install.sh | sh -s -- --first-run

    Verás: con --first-run el instalador no te pregunta nada. Dice «sí» por adelantado al conjunto propio de harnsy: los agentes pueden abrirse en sus propias ventanas, cada agente nuevo recibe una nota breve sobre harnsy, puedes responder a las preguntas de los agentes desde el navegador, y los agentes pueden hablar con harnsy sin preguntar cada vez. Eso cambia archivos de ajustes de Claude Code y Codex (hooks); cada cambio se muestra y se guarda una copia de seguridad. No instala icono en la bandeja ni línea de estado. Al final imprime «Qué cambió en este ordenador» y cómo deshacerlo (harnsy uninstall). En un ordenador que ya tuvo harnsy (también uno donde se desinstaló, que conserva sus datos), --first-run se ignora y el instalador pregunta como de costumbre.

    Comprueba que funciona. Abre http://127.0.0.1:7788 en tu navegador.

    Verás: el panel de harnsy. En un ordenador que aún no tiene ninguna empresa, empieza con «Elige tu idioma»: es el primer inicio, sigue.

    Tus agentes funcionan en tmux si está instalado (3.1 o posterior) y, si no, en el host de terminal propio de harnsy; no instalas nada, y el panel muestra cada agente en vivo. --first-run lo elige por ti sin preguntar; una instalación normal pregunta una vez y guarda tu respuesta.

Codex en macOS

Antes de empezar (páginas de OpenAI, leídas el 8 de noviembre de 2026): la página de precios de OpenAI dice que Codex está incluido en los planes ChatGPT Free, Go, Plus, Pro, Business, Edu y Enterprise (las funciones varían según el plan; hay límites de uso), y que en su lugar puedes pagar por uso de la API con una clave de API. Enlaces: Codex CLI, precios, formas de iniciar sesión. En el texto no hay precios. También tienes que vivir en un país donde OpenAI ofrezca ChatGPT y Codex (la lista está en las páginas de OpenAI).

Inicias sesión en la página del proveedor. El código va directamente al programa en este ordenador, que guarda el inicio de sesión donde lo guarda siempre. harnsy no lee el inicio de sesión para usarlo y no lo envía a ningún sitio; solo pregunta al programa si has iniciado sesión. Antes de cambiar el archivo de ajustes del programa, que también puede contener tu inicio de sesión, harnsy guarda una copia de seguridad en este ordenador (consulta «Claves, inicios de sesión y conexiones»).

  1. Abre una terminal

    Una terminal es una ventana donde escribes comandos. macOS: abre Terminal (Aplicaciones › Utilidades › Terminal). Los instaladores no piden permisos de administrador.

    Verás: una ventana con un cursor que parpadea.

  2. Consigue una cuenta de ChatGPT con un plan que incluya Codex

    En el navegador, ve a chatgpt.com, crea una cuenta si no tienes, y elige un plan en la página de precios de OpenAI (Codex está incluido en Free, Go, Plus, Pro, Business, Edu y Enterprise; hay límites de uso). O usa una clave de API y paga por uso de la API (página de precios de OpenAI). Una clave de API es un secreto: guárdala en tu propio entorno (por ejemplo, OPENAI_API_KEY); no la pongas en un prompt, en un archivo ni en un mensaje a un agente, y no la pegues en harnsy.

    Verás: has iniciado sesión en chatgpt.com.

  3. Instala Codex

    Es el comando de OpenAI (no de harnsy; puedes leer el script antes abriendo la dirección en un navegador):

    Shell
    curl -fsSL https://chatgpt.com/codex/install.sh | sh

    La página de OpenAI también tiene pestañas para npm y Homebrew; léelas allí.

    Verás: el instalador termina y codex se puede iniciar en una terminal nueva.

  4. Inicia sesión

    En una carpeta de proyecto, ejecuta codex. La primera vez, elige «Sign in with ChatGPT» y termina en el navegador. En una máquina sin navegador, OpenAI recomienda codex login --device-auth (en beta; escribes un código en la página de OpenAI). Con una clave de API: printenv OPENAI_API_KEY | codex login --with-api-key. Para comprobarlo: codex login status.

    Verás: una página del navegador para iniciar sesión y después se abre Codex. Ciérralo cuando hayas entrado.

  5. Instala harnsy

    La forma «pídeselo a tu programa de IA» está escrita para Claude Code; no se ha probado con Codex. Si la usas y Codex te pide aprobar un comando, lee antes el comando.

    Forma B: escribe el comando. Puedes leer el script antes de ejecutarlo: abre https://harnsy.dev/install.sh en tu navegador. Esta prueba no cambia nada; muestra lo que haría el instalador:

    Shell
    curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run

    Verás: cada paso que daría el instalador. No se escribe nada.

    Ahora instala. En un ordenador que nunca ha tenido harnsy, añade --first-run:

    Shell
    curl -fsSL https://harnsy.dev/install.sh | sh -s -- --first-run

    Verás: con --first-run el instalador no te pregunta nada. Dice «sí» por adelantado al conjunto propio de harnsy: los agentes pueden abrirse en sus propias ventanas, cada agente nuevo recibe una nota breve sobre harnsy, puedes responder a las preguntas de los agentes desde el navegador, y los agentes pueden hablar con harnsy sin preguntar cada vez. Eso cambia archivos de ajustes de Claude Code y Codex (hooks); cada cambio se muestra y se guarda una copia de seguridad. No instala icono en la bandeja ni línea de estado. Al final imprime «Qué cambió en este ordenador» y cómo deshacerlo (harnsy uninstall). En un ordenador que ya tuvo harnsy (también uno donde se desinstaló, que conserva sus datos), --first-run se ignora y el instalador pregunta como de costumbre.

    Comprueba que funciona. Abre http://127.0.0.1:7788 en tu navegador.

    Verás: el panel de harnsy. En un ordenador que aún no tiene ninguna empresa, empieza con «Elige tu idioma»: es el primer inicio, sigue.

    Nota: las propias notas de harnsy dicen que la instalación en macOS aún no se ha verificado en un Mac real. El instalador no cambia tu PATH: si ~/.local/bin no está en él, el instalador te lo dice y lo añades tú. Si la primera vez que arranca un agente macOS muestra una ventana para instalar las herramientas para desarrolladores, ejecuta antes xcode-select --install.

    Tus agentes funcionan en tmux si está instalado (3.1 o posterior) y, si no, en el host de terminal propio de harnsy; no instalas nada, y el panel muestra cada agente en vivo. --first-run lo elige por ti sin preguntar; una instalación normal pregunta una vez y guarda tu respuesta.

Codex en Windows

Antes de empezar (páginas de OpenAI, leídas el 8 de noviembre de 2026): la página de precios de OpenAI dice que Codex está incluido en los planes ChatGPT Free, Go, Plus, Pro, Business, Edu y Enterprise (las funciones varían según el plan; hay límites de uso), y que en su lugar puedes pagar por uso de la API con una clave de API. Enlaces: Codex CLI, precios, formas de iniciar sesión. En el texto no hay precios. También tienes que vivir en un país donde OpenAI ofrezca ChatGPT y Codex (la lista está en las páginas de OpenAI).

Inicias sesión en la página del proveedor. El código va directamente al programa en este ordenador, que guarda el inicio de sesión donde lo guarda siempre. harnsy no lee el inicio de sesión para usarlo y no lo envía a ningún sitio; solo pregunta al programa si has iniciado sesión. Antes de cambiar el archivo de ajustes del programa, que también puede contener tu inicio de sesión, harnsy guarda una copia de seguridad en este ordenador (consulta «Claves, inicios de sesión y conexiones»).

  1. Abre una terminal

    Una terminal es una ventana donde escribes comandos. Windows: abre PowerShell (menú Inicio, escribe «PowerShell») (no CMD: el indicador muestra PS C:\). Los instaladores no piden permisos de administrador.

    Verás: una ventana con un cursor que parpadea.

  2. Consigue una cuenta de ChatGPT con un plan que incluya Codex

    En el navegador, ve a chatgpt.com, crea una cuenta si no tienes, y elige un plan en la página de precios de OpenAI (Codex está incluido en Free, Go, Plus, Pro, Business, Edu y Enterprise; hay límites de uso). O usa una clave de API y paga por uso de la API (página de precios de OpenAI). Una clave de API es un secreto: guárdala en tu propio entorno (por ejemplo, OPENAI_API_KEY); no la pongas en un prompt, en un archivo ni en un mensaje a un agente, y no la pegues en harnsy.

    Verás: has iniciado sesión en chatgpt.com.

  3. Instala Codex

    Instala Codex en el propio Windows, siguiendo la pestaña Windows de la página de OpenAI sobre Codex CLI, para que codex funcione en PowerShell. harnsy no encuentra un Codex instalado solo dentro de WSL: es otro PATH y otra carpeta personal. (OpenAI describe la vía de WSL por separado; sirve para trabajar dentro de WSL, no para esta guía.)

  4. Inicia sesión

    En una carpeta de proyecto, ejecuta codex. La primera vez, elige «Sign in with ChatGPT» y termina en el navegador. En una máquina sin navegador, OpenAI recomienda codex login --device-auth (en beta; escribes un código en la página de OpenAI). Con una clave de API: printenv OPENAI_API_KEY | codex login --with-api-key. Para comprobarlo: codex login status.

    Verás: una página del navegador para iniciar sesión y después se abre Codex. Ciérralo cuando hayas entrado.

  5. Instala harnsy

    La forma «pídeselo a tu programa de IA» está escrita para Claude Code; no se ha probado con Codex. Si la usas y Codex te pide aprobar un comando, lee antes el comando.

    Forma B: escribe el comando. Puedes leer el script antes de ejecutarlo: abre https://harnsy.dev/install.ps1 en tu navegador. Esta prueba no cambia nada; muestra lo que haría el instalador:

    PowerShell
    $env:HARNSY_INSTALL_ARGS = "--dry-run"; irm https://harnsy.dev/install.ps1 | iex

    Verás: cada paso que daría el instalador. No se escribe nada.

    Ahora instala. En un ordenador que nunca ha tenido harnsy, añade --first-run:

    PowerShell
    $env:HARNSY_INSTALL_ARGS = "--first-run"; irm https://harnsy.dev/install.ps1 | iex

    Verás: con --first-run el instalador no te pregunta nada. Dice «sí» por adelantado al conjunto propio de harnsy: los agentes pueden abrirse en sus propias ventanas, cada agente nuevo recibe una nota breve sobre harnsy, puedes responder a las preguntas de los agentes desde el navegador, y los agentes pueden hablar con harnsy sin preguntar cada vez. Eso cambia archivos de ajustes de Claude Code y Codex (hooks); cada cambio se muestra y se guarda una copia de seguridad. No instala icono en la bandeja ni línea de estado. Al final imprime «Qué cambió en este ordenador» y cómo deshacerlo (harnsy uninstall). En un ordenador que ya tuvo harnsy (también uno donde se desinstaló, que conserva sus datos), --first-run se ignora y el instalador pregunta como de costumbre.

    Comprueba que funciona. Abre http://127.0.0.1:7788 en tu navegador.

    Verás: el panel de harnsy. En un ordenador que aún no tiene ninguna empresa, empieza con «Elige tu idioma»: es el primer inicio, sigue.

    Nota: el instalador añade su carpeta a tu PATH de usuario: escribe harnsy en una ventana nueva de PowerShell. Windows Security a veces marca harnsy.exe; creemos que es un falso positivo (consulta «Solución de problemas»).

    Tus agentes funcionan en el host de terminal propio de harnsy (ConPTY); no instalas nada, y el panel muestra cada agente en vivo. --first-run lo elige por ti sin preguntar; una instalación normal pregunta una vez y guarda tu respuesta.

La guía completa · 33 min

De la instalación a un sitio web que funciona, en una sola grabación.

Una ejecución real en una máquina de pruebas: instala harnsy, empieza un primer proyecto, encarga tareas a tu líder, contrata a un diseñador y obtén el sitio terminado de un pequeño negocio. Usa los capítulos para ir a la parte que necesitas.

Una ejecución real, acelerada. Voz generada, en inglés; los subtítulos, en inglés, se activan solos y puedes quitarlos en el reproductor. El cliente y el trabajo del vídeo son datos de ejemplo.

2. Primer equipo

  1. Elige tu idioma

    Verás: «Elige tu idioma». Debajo: English, Русский, Español, y la marca «idioma del navegador» en el que ha adivinado. «El panel estará en este idioma, y el líder de tu equipo te hablará en él».

    Elige: tu idioma y luego Continuar.

    Después: la pantalla del programa.

  2. Elige un programa para tu equipo

    Verás: «Elige un programa para tu equipo», con una tarjeta para Claude Code («de Anthropic») y otra para Codex («de OpenAI»). Mientras harnsy busca, cada una dice «Comprobando este equipo…»; después, «Instalado» o «No se ha encontrado en este equipo», y «Sesión iniciada» o «Hay que iniciar sesión». Bajo el título: «Tu equipo es un grupo de ayudantes de IA que trabajan juntos. Tú decides en qué trabajan».

    Elige: el programa que instalaste. Si no se encuentra, pulsa Instala Claude (o Instala Codex): abre las instrucciones del propio programa. Si hay que iniciar sesión, pulsa Iniciar sesión en Claude (o Iniciar sesión en Codex) y sigue el paso 3. Después, Volver a comprobar. Para usar el otro programa: Usar Codex / Elegir otro programa.

    Después: cuando la tarjeta diga «Claude está listo» (o «Codex está listo»), sigue.

  3. Inicia sesión (solo si hace falta)

    Claude: «Iniciar sesión en Claude», en dos pasos: «Abre la página de inicio de sesión de Anthropic» («Inicia sesión allí con tu cuenta de Claude.»), y luego «Pega el código de esa página» («Después de iniciar sesión, la página mostrará un código: pégalo aquí.»). Si el código no sirve: «El código no sirvió. Copia el código completo de la página y pégalo de nuevo.»

    Codex: harnsy ejecuta por ti el inicio de sesión propio de Codex con código de dispositivo: «Abre la página de OpenAI» («Sirve cualquier dispositivo.»), «Escribe allí este código» (un código como WQT2-BZDCE), «El código es válido hasta 15 minutos». Si no termina: «El inicio de sesión en Codex no terminó. Pulsa «Iniciar sesión en Codex» de nuevo.»

    Dónde se guarda tu inicio de sesión: en el lugar propio del programa, en este ordenador. Para Claude Code: harnsy no lee el inicio de sesión para usarlo y no lo envía a ningún sitio; solo pregunta a Claude Code si has iniciado sesión. Antes de cambiar el archivo de ajustes de Claude Code, que también puede contener tu inicio de sesión, harnsy guarda una copia de seguridad en este ordenador (consulta «Claves, inicios de sesión y conexiones»). Para Codex: harnsy mira en el archivo de inicio de sesión propio de Codex si hay un inicio de sesión guardado (solo lee si está ahí, y no lo copia, no lo guarda ni lo envía), o comprueba si OPENAI_API_KEY está definida.

    Después: vuelta al paso 2; «… está listo».

  4. Ponle nombre a tu empresa

    Verás: «Ahora eres CEO.» «¿Cómo llamamos a tu empresa?», con «Mi primera empresa» ya escrito. «Tu empresa tendrá equipos, líderes y empleados de IA. Tú marcas la dirección. Ellos hacen el trabajo.»

    Elige: deja el nombre o escribe el tuyo, y luego Continuar.

    Conviene saber: el primer inicio dice «empresa»; después, el panel dice «Organización». Es lo mismo.

  5. Tu primer proyecto, y de qué tipo

    Verás: «Toda empresa empieza con un proyecto.» «Nombre del proyecto», con «Mi primer proyecto» ya escrito. «Los proyectos organizan el trabajo. Cada proyecto tiene su propio equipo, tareas y objetivos.» Bajo «Qué tipo de proyecto», dos opciones: Proyecto nuevo («Empezar desde cero. Creamos una carpeta vacía para él.») y Mi proyecto («Trabajar en una carpeta que ya tienes: un sitio web, una app, tus documentos.»).

    Elige: Proyecto nuevo → ve al paso 6. Mi proyecto → ve al paso 5b.

  6. Muestra tu carpeta

    Verás: «La carpeta de tu proyecto» (un ejemplo: ~/code/my-project). Mientras escribes, «Comprobando la carpeta…», y luego «Carpeta encontrada: <carpeta>».

    Elige: escribe la ruta completa (empezando por / o ~) y luego Revisar mi proyecto.

    Si la rechaza: «No existe esa carpeta en este equipo. Revisa la ruta.» · «Esta carpeta está fuera de tu carpeta personal. harnsy solo trabaja con carpetas dentro de ella.» · «Esta es toda tu carpeta personal. Escribe la ruta de la carpeta del proyecto dentro de ella.» · «harnsy no puede usar esta carpeta: es oculta, temporal o contiene los datos de harnsy. Elige una carpeta de proyecto propia.»

    Después: «Revisando tu proyecto»: «Tu líder lo abre solo para leer. No se cambia nada en tu carpeta.» (El líder funciona en modo de solo lectura.) Luego, una tarjeta «Plan listo». Hasta que aceptes, «los agentes de este ordenador no cambian nada». Pulsa Aceptar el plan (o Detener). Después, el líder empieza a trabajar. Salta al paso 8.

  7. ¿En qué trabajará tu equipo?

    Verás: «¿En qué trabajará tu equipo?» Cuatro opciones: Desarrollo de software («Crear sitios web y programas informáticos.»), Marketing y contenido («Escribir textos y dar a conocer tu trabajo.»), Operaciones del negocio («Organizar el trabajo diario, como informes y listas.»), Otra cosa («Elige esta opción si ninguna de las otras encaja.»). Debajo: «¿Qué quieres conseguir?», con un ejemplo: «un sitio web para mi panadería con el menú y el horario». «Te propondremos los empleados de IA adecuados para tu proyecto.»

    Elige: un tipo de trabajo, y escribe tu objetivo con tus propias palabras.

  8. Conoce a tu primer equipo

    Verás: «Conoce a tu primer equipo.» «Equipo propuesto para «<proyecto>», del catálogo de harnsy. Quita a quien quieras o contrata más.» El líder lleva la marca «hablas con este». Cada persona tiene una tarjeta con sus habilidades.

    Elige: Quitar: <nombre> para quien no quieras, + Contratar más especialistas para abrir el catálogo, y luego Crear mi equipo (con un número: «Crear mi equipo (2)»). Si el catálogo no responde: «El catálogo no respondió, así que mostramos el equipo integrado.» En el primer inicio hay un límite: «Es el máximo en el primer inicio: contrata al resto luego en Roles.»

    Conviene saber: «Cada cambio que aceptas se guarda en git, para que puedas volver atrás. Puedes desactivarlo en los ajustes del proyecto.»

  9. Formando tu equipo

    Verás: «Formando tu equipo». Tres líneas se marcan una tras otra: «Guardando tu empresa, proyecto y equipo», «Abriendo la ventana de tu líder» («Claude en una nueva ventana de terminal»), «Tu líder está leyendo su rol» («Suele tardar 10–30 segundos»). «Tu líder se inicia en su propia ventana. El chat se abre en cuanto esté listo.» Al terminar: «Empresa, proyecto y equipo guardados», «Ventana del líder abierta», «Tu líder está listo».

    Si falla: «Tu líder no se inició. Tu empresa, proyecto y equipo están guardados. Solo falló iniciar al líder.» Pulsa Abrir la ventana del líder o Intentar de nuevo; consulta «Si algo sale mal».

    Después: se abre el chat con tu líder.

  10. Habla con tu líder y dale la primera tarea

    Qué pasa: tu líder te saluda en tu idioma, dice en una línea lo que ha entendido, propone un primer objetivo en una frase y empieza. Elige una primera tarea lo bastante pequeña para terminarla en una hora y que tú puedas ver, y contrata para ella el equipo más pequeño del catálogo (normalmente uno o dos roles; las tarjetas de contratación están en el chat y eres tú quien pulsa para contratar, así que nadie entra sin ti). Luego te dice quién se encarga, qué tarea, dónde mirar («Tareas») y cómo sigue el trabajo a partir de ahí: escribe al líder en el chat o comenta una tarjeta; el líder lo divide en tareas para el equipo; si algo no está bien, díselo y el líder lo rehace.

    Verás: la barra de la guía «Primera vez · paso n de 6»: Programa e inicio de sesión · Empresa y proyecto · El líder forma el equipo · Conversación con el líder · Primera tarea · Revisa el resultado. Una tarjeta de objetivo para que la confirmes; el líder te hace una pregunta cada vez, con opciones, y solo cuando el trabajo necesita la respuesta.

    Elige: responde a las preguntas del líder; confirma el objetivo; pulsa las tarjetas de contratación.

    Después: el tablero de tareas «Tareas»: cada tarjeta es una parte del trabajo. Cuando la primera tarea llegue a Revisión, ábrela y pulsa Aceptar (o Devolver… y di qué hay que corregir). Luego pide al líder lo siguiente. Mostrar todo el panel termina la guía.

Organización y proyecto

El primer inicio dice «empresa»; después, el panel dice «Organización». Es lo mismo.

  • Una organización es tu empresa: el grupo que contiene tus proyectos.
  • Un proyecto es una carpeta con su propio líder, equipo, tareas y objetivos.

Ejemplo. Llevas un pequeño estudio, «Acme Studio». Eso es una organización. Dentro hay dos proyectos: «Sitio web» y «App móvil»: dos carpetas, dos líderes, dos equipos. Una segunda organización solo se crea para otro cliente u otro negocio cuyas personas, objetivos y roles no deben mezclarse.

Para añadir más. En la página «Organizaciones», pulsa «Nueva organización» y «Añadir organización», o «Nuevo proyecto en <organización>».

Límites. harnsy gratis tiene una organización y dos proyectos, sin límite de agentes. harnsy Max permite más organizaciones y proyectos. Si llegas al límite, un mensaje te lo dice y tu organización sigue funcionando.

Tu segundo proyecto

El primer inicio guiado solo aparece mientras el nodo no tiene ninguna empresa. Para un proyecto nuevo más adelante, pulsa «Nuevo proyecto en <organización>» en la página «Organizaciones». Su líder tiene su propia primera reunión contigo; no hay recorrido guiado.

En qué se diferencian las rutas de Claude Code y Codex

  • Mensajes: harnsy entrega los mensajes a Codex a través de su cola; un Codex en marcha recibe un mensaje al final de su turno. La respuesta de una persona a una pregunta de un agente también va como un único mensaje en la cola.
  • Preguntas y permisos: las preguntas propias de Codex pueden aparecer en el panel (una opción por pregunta; se admite una respuesta escrita). Las solicitudes de aprobación de Codex no llegan al panel: se quedan en su ventana de terminal. Con Claude Code llegan las dos.
  • Hooks: el instalador añade su hook de nota informativa a ~/.codex/hooks.json solo si existe ~/.codex; la próxima vez que arranque, Codex puede pedirte que confíes en el hook nuevo. harnsy abre su Codex con la confianza en la carpeta dada mediante opciones de la línea de comandos y con la comprobación de actualizaciones desactivada.
  • Teléfono: el acceso de harnsy desde el teléfono es su propio acceso al panel.
  • El líder: el líder puede funcionar con Claude Code o con Codex; lo eliges en la primera pantalla.

Si algo sale mal

  • «El líder no se abrió: no se encontró Claude». harnsy no encuentra Claude Code. Instálalo e inicia sesión. Si ya está instalado, ejecuta harnsy install en una terminal donde claude funcione (guarda ese PATH), reinicia harnsy y pulsa «Intentar de nuevo».
  • «El líder no se abrió: no hay terminal». No hay ninguna terminal elegida. Pulsa «Elegir terminal», o pon terminal.driver: tmux en ~/.harnsy/config.yaml, reinicia y pulsa «Intentar de nuevo».
  • Claude cerró tu sesión. La página del líder te pide iniciar sesión otra vez (un enlace y un código). Después, harnsy envía él mismo al líder su primer mensaje.
  • «Mi proyecto» rechaza la carpeta. Escribe la ruta completa, empezando por / o ~. La carpeta tiene que existir y estar dentro de tu carpeta personal; se rechazan las carpetas ocultas, las temporales, las propias de harnsy y la propia carpeta personal.
  • Dos instalaciones de Claude Code, y la antigua va primero. Ejecuta claude --version (en Windows, where.exe claude) y deja solo una.
  • Detrás de un proxy de empresa no se conecta nada. Ajustes › Acceso desde fuera › Proxy, y «Comprobar».
  • Más: Solución de problemas (en inglés).

Troubleshooting (English)

Actualización

Actualizar

harnsy nunca busca actualizaciones por su cuenta. Compruébalo y luego actualiza:

Shell
harnsy update --check
harnsy update

En el panel, los botones «Buscar actualizaciones» y «Actualizar» hacen lo mismo. Volver a ejecutar el comando de instalación también sirve. Tus datos en ~/.harnsy se quedan. El nodo se reinicia durante unos segundos y las sesiones de los agentes siguen funcionando.

Nota: Un mensaje enviado en esos segundos no llega: envíalo otra vez. En Windows, el instalador pregunta antes de reiniciar el nodo.

Volver atrás

Después de una actualización:

Shell
harnsy update --rollback --yes

O instala una versión anterior encima de una más nueva (la variable va a sh, no a curl):

Shell
curl -fsSL https://harnsy.dev/install.sh | HARNSY_VERSION=<tag> sh -s -- --allow-older

Desinstalación

Shell
harnsy uninstall --dry-run
harnsy uninstall

Quita el servicio, la bandeja, el programa y solo las entradas de ajustes que añadió la propia instalación (los hooks de la nota informativa y de las respuestas, las entradas del modo automático, la línea de estado; la tuya se restaura si la instalación la envolvió), después de mostrarte un diff y preguntarte.

Nota: Las copias de seguridad anteriores no se restauran. Conserva tus datos en ~/.harnsy, tus copias de seguridad y la terminal que hayas elegido tú. No deshace las reglas de permisos ni la confianza en carpetas que diste a Claude Code. Sin terminal, no pregunta nada y deja las entradas de ajustes.

Más sobre el instalador

Qué hace el instalador

Todo lo que escribe, todo lo que pregunta y lo que deja como está. harnsy install --dry-run imprime cada paso, el diff de cada archivo que cambiaría y la ruta de cada archivo que crearía, y no cambia nada.

Se queda en tu cuenta de usuario.

Todo va a tus propios directorios de usuario. Sin sudo ni derechos de administrador. En Linux y macOS no cambia el PATH ni el perfil de tu shell; si ~/.local/bin no está en el PATH, te lo dice y lo añades tú mismo o llamas a harnsy por su ruta completa. En Windows añade %LOCALAPPDATA%\harnsy\bin al PATH de tu usuario (una vez, sin derechos de administrador); las ventanas abiertas antes conservan el PATH anterior, así que escribe harnsy en una nueva. Si no puede leer o cambiar el PATH de tu usuario, te lo dice y te pide que añadas la carpeta a mano (Configuración → Variables de entorno). harnsy uninstall quita esa entrada.

Comprueba la descarga.

El instalador de un solo comando descarga desde GitHub por HTTPS la versión para tu sistema y tu CPU, y se detiene si el archivo no aparece en el SHA256SUMS de la versión o no coincide. En Linux y macOS lo descomprime en una carpeta temporal, ejecuta harnsy install desde ahí y borra la carpeta al terminar. La comprobación detecta una descarga dañada o cortada; las sumas vienen de la misma versión.

Instala tres cosas sin preguntar.

El programa, un registro de instalación y un servicio en segundo plano solo para tu usuario. El servicio arranca ya y en cada inicio de sesión.

Lo que se escribe sin preguntar en una instalación nueva
LinuxmacOSWindows
El programa (una copia)~/.local/bin/harnsy y el enlace ~/.local/bin/ccbuscomo en Linux%LOCALAPPDATA%\harnsy\bin\harnsy.exe
Registro de instalación~/.local/share/harnsy/install.json y hooks/harnsy-introduce.pycomo en Linux%LOCALAPPDATA%\harnsy\install.json
Un servicio: arranca ya y al iniciar sesión, se reinicia tras un fallounidad de usuario de systemd ~/.config/systemd/user/harnsy.serviceLaunchAgent ~/Library/LaunchAgents/com.github.butschster.harnsy.plist, registro en ~/Library/Logs/harnsy/tarea harnsy del Programador de tareas, con privilegios mínimos; si Windows la rechaza, el valor harnsy en HKCU\Software\Microsoft\Windows\CurrentVersion\Run (sin reinicio tras un fallo)

Si ya hay otro archivo de servicio u otra tarea, te lo muestra y lo reemplaza solo después de tu sí. Un archivo ~/.local/bin/ccbus existente se mueve a ccbus.pre-harnsy.

Cuando lo ejecutas tú, pregunta antes de todo lo demás.

Cada uno es una pregunta [y/N]. Solo cuenta y o yes; sin respuesta, sin terminal o con --dry-run significa no. Desde la 0.8.0, sin terminal significa no solo si no dijiste que sí de antemano (mira «Di sí de antemano»); --dry-run es siempre no.

  • Si un terminal ejecuta a tus agentes, mientras no haya nada elegido (tmux si está instalado; si no, el host de terminal propio de harnsy; en Windows, su host propio), guardado como terminal.driver en el config.yaml de harnsy.
  • El icono de bandeja (Linux y Windows): en Linux, ~/.local/bin/harnsy-tray. Iniciarlo al iniciar sesión es otra pregunta.
  • Un hook de inicio para las sesiones nuevas en ~/.claude/settings.json y ~/.codex/hooks.json, solo si existe ~/.claude o ~/.codex (no en Windows).
  • Una línea de estado en ~/.claude/settings.json, solo si no tienes ninguna.

Para cada archivo de configuración, primero te muestra el cambio exacto. Un archivo que ya existe se copia antes en ~/.local/share/harnsy/backups/ (Windows: %LOCALAPPDATA%\harnsy\backups\). --accept y --yes responden que sí por ti, solo cuando tú las das (desde la 0.8.0). --no-tray, --no-hooks y --no-statusline omiten un paso.

Se queda en tu máquina.

El panel en 127.0.0.1:7788 y el puerto de agentes en 127.0.0.1:7790 solo escuchan en este ordenador. El servicio también recibe 127.0.0.1:7789 para otros nodos; ese puerto solo se abre después de que emitas un token de nodo, y nunca sin una clave de harnsy Max. harnsy no tiene telemetría y nunca busca actualizaciones. De forma predeterminada solo habla con tus herramientas en esta máquina y con los nodos que conectes; los servicios a los que puede llegar cuando añades una clave o activas una función están en la pregunta frecuente «¿Adónde van mis datos?». Mientras hay una clave instalada, harnsy la comprueba con el servicio de licencias (lic.harnsy.dev) más o menos una vez al día y envía la clave completa, un hash del ID de la máquina (el ID en sí nunca sale de la máquina), un valor aleatorio de un solo uso, el nombre de la máquina en el panel de licencia, el sistema operativo y la arquitectura, la versión de harnsy y su fecha de compilación.

No toca:

  • los servidores MCP: imprime la línea opcional claude mcp add para que la ejecutes tú
  • ~/.claude.json
  • el ~/.codex/config.toml de Codex
  • los ajustes de OpenCode

Más adelante, mientras funciona: solo con claude.auto_trust: true en config.yaml (desactivado por defecto) harnsy marca como de confianza la carpeta de un proyecto en ~/.claude.json antes de abrir Claude Code en ella, después de copiar el archivo a claude.json.bak en ~/.harnsy. Codex abierto por harnsy recibe la confianza en la carpeta como opciones de línea de comandos; no se escribe ningún archivo.

Una versión concreta, o volver a una anterior

Una versión concreta, o volver a una anterior: curl -fsSL https://harnsy.dev/install.sh | HARNSY_VERSION=<tag> sh (la variable va después de la barra vertical). La base de datos solo gana tablas y columnas, así que una versión anterior la sigue abriendo.

harnsy version muestra la versión que tienes.

Detrás de un proxy corporativo

Detrás de un proxy corporativo (desde la versión 0.9.1): indica en HTTPS_PROXY (y HTTP_PROXY) el proxy y en NO_PROXY los hosts que van directos, y deja localhost,127.0.0.1,::1 en él. harnsy los lee una sola vez, al arrancar: en Windows defínelos como variables de usuario y cierra sesión y vuelve a iniciarla; en Linux y macOS añádelos al servicio de harnsy (unidad de systemd o plist de launchd) y reinícialo. harnsy net check te dirá entonces, host por host, si se puede llegar a él o por qué no (inicio de sesión del proxy, inspección TLS, sin ruta).

Abrir agentes desde harnsy

harnsy abre cada uno de tus agentes en una ventana que él maneja, una pestaña por agente, para poder abrirlos, listarlos y volver a abrirlos. No tienes que instalar ni configurar una terminal: harnsy elige una para tu sistema. Sin ella, los mensajes, los equipos y el panel funcionan igual; harnsy simplemente no puede abrir ni volver a abrir agentes.

~/.harnsy/config.yaml

terminal: driver: tmux # or: conpty

Se configura a mano en ~/.harnsy/config.yaml; el instalador o --first-run lo configura por ti.

Preguntas sobre la instalación

Antes de empezar

¿Qué necesito primero? Un ordenador con Linux, macOS 13 o posterior, o Windows 10 (1809) o posterior; y Claude Code o Codex, instalado y con sesión iniciada, con un plan o una clave de API de Anthropic o OpenAI que funcione con él. Los pasos de arriba te guían por la cuenta, la instalación y el inicio de sesión. harnsy no instala Claude Code ni Codex por ti.

¿Qué plan necesito? Qué planes incluyen Claude Code o Codex es una regla del proveedor, y cambia. Lee las páginas de precios de Anthropic y OpenAI, enlazadas en el paso 1. harnsy solo pregunta al programa si has iniciado sesión.

¿Necesito una terminal especial? No. harnsy ejecuta tus agentes en una terminal que él maneja, y elige una para tu sistema: en Linux y macOS, tmux si está instalado (3.1 o posterior) y, si no, el host de terminal propio de harnsy; en Windows, siempre el host de terminal propio de harnsy. No instalas nada para esto, y el panel muestra cada agente en vivo. Sin terminal, los mensajes, los equipos y el panel siguen funcionando; harnsy simplemente no puede abrir ni volver a abrir agentes.

¿Tengo que saber programar? No: describes los objetivos con palabras sencillas y el equipo planifica y hace el trabajo. Para empezar, instalas tu programa de IA y harnsy (uno o dos comandos en una terminal) e inicias sesión; los pasos de arriba te muestran cómo. Valorar los resultados técnicos, como el código, es más fácil si tienes cerca a alguien técnico.

Instalación

¿Qué debo saber antes de ejecutar un comando que descarga un script? Puedes leer el script antes: abre la dirección en tu navegador. --dry-run imprime cada paso y cada cambio y no escribe nada. El instalador funciona en tu cuenta de usuario y no pide permisos de administrador, y comprueba la descarga con el SHA256SUMS de la versión (eso muestra que el archivo llegó entero, no quién lo hizo). Cada cambio en tus propios archivos de ajustes se muestra antes como un diff, y se guarda una copia de seguridad.

¿Qué cambia el instalador en mi ordenador? Pone el programa en tu carpeta de usuario y lo arranca como servicio en segundo plano para tu cuenta. Con --first-run, además dice «sí» por adelantado al conjunto propio de harnsy (los agentes se abren en sus propias ventanas, cada agente nuevo recibe una nota breve sobre harnsy, puedes responder a las preguntas de los agentes desde el navegador, los agentes hablan con harnsy sin preguntar cada vez); eso cambia los archivos de ajustes de Claude Code y Codex (hooks). No instala icono en la bandeja ni línea de estado. Al final imprime «Qué cambió en este ordenador» y cómo deshacerlo. La lista completa está más abajo, en «Qué hace el instalador». Para deshacer la instalación, ejecuta harnsy uninstall: quita el programa, el servicio y la bandeja que instaló harnsy y, después de mostrarte cada cambio y preguntarte, las entradas que harnsy añadió a tus ajustes de Claude Code (sus hooks, las entradas de permisos del modo automático y la línea de estado si la configuró); antes se hace una copia de seguridad, y las copias de seguridad, tus datos en ~/.harnsy y todo lo que hayas añadido después a esos ajustes se quedan. Si se ejecuta sin terminal, no pregunta nada y deja esas entradas de ajustes en su sitio.

Windows dice que harnsy.exe es una amenaza. ¿Qué hago? Windows Security a veces marca harnsy.exe; creemos que es un falso positivo. Comprueba primero la descarga y después excluye solo la carpeta de harnsy: los pasos están en «Solución de problemas».

«harnsy: command not found» después de instalar. En Linux y macOS, el instalador no cambia el PATH ni el perfil de tu shell; si ~/.local/bin no está en el PATH, te lo dice y lo añades tú. En Windows, añade %LOCALAPPDATA%\harnsy\bin a tu PATH de usuario (sin permisos de administrador, una vez); las ventanas abiertas antes conservan el PATH antiguo, así que escribe harnsy en una nueva. Si no puede leer o cambiar tu PATH de usuario, te lo dice y te pide que añadas la carpeta a mano (Configuración → Variables de entorno). harnsy uninstall vuelve a quitar esa entrada.

¿Puedo instalar sin terminal? harnsy se instala con un comando, así que necesitas una terminal para ese único paso. Puedes pedirle a tu programa de IA que lo haga por ti (la frase de arriba de esta página); te dice qué cambia la instalación y espera tu «sí». Si tu programa de IA no puede ejecutar el instalador, te pide que ejecutes el comando tú.

Primer equipo

¿Por qué el primer inicio dice «empresa» y el panel «Organización»? Son lo mismo: tu empresa es el grupo que contiene tus proyectos. El primer inicio usa la palabra más sencilla.

¿El líder siempre estudia primero mi proyecto? Solo cuando empiezas desde una carpeta que ya tienes («Mi proyecto»): lee la carpeta sin cambiar nada, muestra un plan y espera a que lo aceptes. Para un proyecto nuevo, hace unas pocas preguntas, propone un primer objetivo y se pone a trabajar.

¿Puedo usar Codex en lugar de Claude Code? Sí: Codex es la otra opción de la primera pantalla, y el líder puede funcionar con cualquiera de los dos. Las preguntas de Codex llegan al panel, pero sus solicitudes de aprobación se quedan en su propia ventana de terminal.

¿Ve harnsy mi inicio de sesión de Claude? harnsy no lo lee para usarlo y no lo envía a ningún sitio; pregunta a Claude Code si has iniciado sesión. Una copia de seguridad del archivo de ajustes de Claude Code, que puede contener el inicio de sesión, se queda en este ordenador: consulta «Claves, inicios de sesión y conexiones». Con Codex, solo mira si hay un inicio de sesión guardado; no lo copia, no lo guarda ni lo envía.

¿Por qué no puedo añadir un tercer proyecto? harnsy gratis tiene una organización y dos proyectos, sin límite de agentes; harnsy Max permite más. Si llegas al límite, un mensaje te lo dice y tu organización sigue funcionando. (Desde la 0.11.0.)

¿Dónde pregunto algo que no está aquí? Haz una pregunta.