English

Fork of brianpugh/unraid-claude-code, an Unraid plugin that installs Claude Code CLI — Anthropic's AI-powered coding assistant — on Unraid, with persistent authentication across reboots.

This fork exists to fix a boot-time reliability bug and to make the Settings page bilingual. All credit for the original plugin design goes to brianpugh. No license was declared on the original repository, so this fork is published with clear credit to the original author rather than any claim of authorship over the base plugin.

✨ What's new

• Remote Control now writes what matters to the system log, tagged claude-code: a bridge starting, stopping, dying and being restarted, a session that could not be resumed, an account added, removed or switched to, and an account whose details could not be read. None of it used to leave a trace outside the plugin's own log.

• Fixed both scheduled jobs — the usage sampler and the watchdog above — being installed and then never scheduled: the schedule file went to the wrong place, and updating the plugin did not run the step that writes it.

• Remote Control no longer dies with the page that started it. A bridge started from the web — including the restart an update performs by itself — belonged to the web request that asked for it, so closing the update popup took every account's bridge down with it, and silently: nothing was left running to write a line about it. Bridges now run in a session of their own.

• A watchdog every five minutes covers the other half of that: Remote Control marked as on with nothing actually running is started again, instead of staying down until somebody opens the page. An account stopped on purpose is left stopped.

• An account no longer loses its name and plan when a reading fails. An expired token, or a credentials file caught in the second the CLI was rewriting it, used to empty both — which on the Accounts and Dashboard tabs looks exactly like the account having vanished, while it was sitting there logged in and working. A failed reading keeps what is already on record and says in the log why it could not do better; only removing an account clears it.

• The Dashboard says how much of the plan percentage was spent on this server, measured every five minutes rather than guessed, and says plainly when the figure covers only part of the week.

• Old Claude Code versions are deleted instead of hoarded. On Unraid they sit in RAM, where five of them was well over a gigabyte; the running one and the most recent are kept.

• The help for automatic memory says where it actually lives: sessions on this server, in the same working folder. It does not travel to other machines or to claude.ai even on the same account, and the accounts on this server do share it, because for them it is the same files.

• Each account now has its own identity. Accounts used to share one config home, and the identity lives in a file in it, so claude in a terminal reported whichever account signed in last no matter which one was selected on the page. Every account gets its own config home now, and what is genuinely shared — agent memory, session transcripts, settings.json, plugins, saved plans, prompt history — comes back as symlinks into the main account's home: the same files, not copies, so what one account learns every account has.

• New sync panel on the Accounts tab for the settings that cannot be symlinked because they live inside each account's own files: MCP servers, trusted directories, the tools allowed in them and the permission rules. The main account leads by default — its changes reach the others on their own, while a change made in another account keeps working there and waits to be ticked before it becomes everyone's. A both-ways setting promotes those automatically. Nothing an account changed is ever reverted behind your back.

• Permission rules moved into each account with that split, on purpose: they used to sit in a shared file where one account approving a command granted it to the main account too.

• The Accounts tab asks each account's own token who it is, instead of asking the CLI — which answered with the same cached email for every account.

• 25 more settings in Claude Code Config, written in plain language: waiting for the usage limit to reset and carrying on, push notifications when a session needs you, messages between sessions on different machines, refusing reads outside the working folders, forbidding the no-questions permission mode, automatic-mode controls, undo snapshots, commit and PR signatures, workflows and skill locks. Fast mode and the effort ceiling carry a warning about what they cost.

• Fixed a bug where the plugin could become permanently disabled after a reboot: the plugin icon was fetched over the network via a native FILE/URL directive processed synchronously during Unraid's boot-time plugin install pass — before the author's own network-readiness checks (used for the actual Claude install) ever ran. If that single wget failed (e.g. network not up yet right after a reboot), Unraid aborted the entire plugin install and permanently moved the .plg to /boot/config/plugins-error, silently skipping it on every future boot until manually reinstalled. The icon is now embedded as inline base64 in the .plg itself, removing that network dependency entirely.

• Added a bilingual Settings page (Unraid → Settings → Utilities → Claude Code): it shows English or Spanish automatically based on Unraid's webGUI language (any es_* locale shows Spanish, everything else falls back to English) — same approach as this author's unraid-zabbix_agent-6lts fork.

• Fixed the icon shown on the Plugins tab: Unraid's ShowPlugins.php never treats icon= as a URL — it only ever looks for a local file named plugins/<name>/images/<name>.png. Upstream's remote icon= URL therefore always fell through to a generic fallback icon. Removed icon= and moved the bundled PNG to that exact convention path, so it's now picked up automatically.

• Clicking the plugin's row on the Plugins tab now jumps straight to its Settings page (added launch="Settings/claude-code"), same as the unraid-zabbix_agent-6lts fork.

• Settings page restyled to match unraid-zabbix_agent-6lts's look (bordered sections, a compact status bar, inline help notes) instead of the original ad-hoc table/div layout.

• The Plugins tab now shows "Claude Code Remote Control" with a real bilingual description instead of the bare word claude-code — Unraid renders plugins/claude-code/README.md as that description, so this fork ships one (separate from this top-level README).

• Added a "Logs" section to the Settings page with a "View live logs" link that streams /var/log/claude-code-install.log in real time via Unraid's native openTerminal() mechanism (same one Docker/VMs/NUT use) — no extra scripts needed.

• Fixed that live-log link never showing up in practice: it was hidden until the log file existed, which only ever happened on an actual Unraid reboot. Now always shown.

• Added a real "Update Claude Code" action. The original "Reinstall" button is a no-op once Claude Code already works, so there was no way to fetch a newer release from the plugin at all. The new button runs the CLI's own claude update and re-caches the result into APPDATA_PATH, since the next boot would otherwise silently restore the old cached binary over any update. Reinstall and Update now both log to the file the "View live logs" link follows.

• Remote Control: a new Settings section runs claude remote-control as a supervised background process, so you can drive a Claude Code session on this NAS from claude.ai/code or the Claude mobile app — outbound HTTPS only, nothing opened inbound. It always resumes the same ongoing session in its configured directory (--continue), falling back to a fresh one only the first time, and only ever starts when you click Start — never automatically at boot. Requires a claude.ai OAuth login (Pro/Max/Team/Enterprise); API key auth isn't supported by this Anthropic feature. Defaults to a dedicated /root/claude-remote-control directory rather than /root itself, since Unraid never persists workspace trust for a home directory. Includes session history, reconnect-to-any-past session, and auto-recovery if a session gets archived on the claude.ai side.

• Live resource usage: the Settings page shows the CPU and memory Claude Code is actually using on this server — the Remote Control bridge, the session worker it spawns, and any interactive claude in a terminal — refreshed every few seconds while the page is open, with a per-process breakdown. CPU is a real between-polls delta read from /proc, not ps's pcpu, which is a lifetime average and reads ~99% for a session that has been idle for weeks.

• Plan usage: the page reports your Claude plan's 5-hour and weekly windows, any per-model weekly window, and your credit balance and spend if the account has extra usage enabled, each with a countdown to when it resets. It reads Anthropic's own usage endpoint — the one the CLI's /usage command uses — which is a metadata endpoint: it runs no inference and costs no tokens. Credentials are never rewritten by the page, and the token is never passed on a command line where ps could read it.

• A tabbed Settings page: Dashboard, Accounts, Remote Control, Claude Code Config and Settings, instead of one long scroll. The Dashboard carries the state — versions, array, resources, plan usage — and everything you configure lives under its own tab.

• Claude Code's own configuration, from the browser: the Claude Code Config tab edits the settings.json Claude Code reads — model and fallback models, effort level, output style, extended thinking, response language, theme, editor mode, the permission mode and the allow/ask/deny rules, Remote Control at session start, environment variables, transcript retention, auto memory, hooks and the update channel — with a JSON editor covering every remaining key in Anthropic's settings reference. Saving a field leaves the rest of the file untouched and keeps the previous version beside it as settings.json.bak.

• A preset selector on the Config tab: Automatic (Claude Code's own automatic model choice), Default (clears every field the preset manages, exactly as if the tab had never been touched), and Optimized for Opus 5 — which pins the model to Opus 5, keeps auto-compact on, follows the stable update channel, and caps how much raw text a very verbose command is allowed to dump into the conversation, without lowering the effort level, turning off extended thinking, or falling back to a weaker model on overload: choosing Opus 5 means staying on Opus 5, at full intelligence. A preset only fills in the fields; you still review and save.

• A way out when a session cannot be resumed. Remote Control has a "Start a new session" button next to Start and Stop: Start resumes the session an account was last using, and this opens an empty one instead, which is what you need when the old session was archived, expired or never attached to a bridge. The supervisor also recognises those failures now — any error naming the session drops it and starts a new one at once, instead of asking for the same dead session every five seconds forever — and only a session that actually connected is remembered as an account's own, so an id that never worked cannot be resumed on the next start.

• Old sessions can be deleted from the session list, which removes the entry and Claude's note about the last session of that directory and nothing else: conversation transcripts are left alone, and the agent memory stored beside them is never touched by anything on this page. A session that is connected, or that an account is still set to resume, has no Delete button.

• Update restarts Remote Control for you. Applying a new Claude Code version used to leave any running bridge on the old binary until you stopped and started it by hand. Update (and Reinstall, when it finds a newer binary already cached) now restarts each account's bridge that is actually running, and only when the version genuinely changed.

• Plan figures that don't disappear: Claude Code renews its access token while it is in use, so an account left idle for hours can no longer refresh its usage. The plan line then shows the last reading that worked together with the time it was taken, instead of going blank, and every reset countdown also gives the date and time it lands on. The line also says whether the subscription is active and when it renews next (the monthly anniversary of the start date — Anthropic reports that date, not the billing one, so it is marked as an estimate).

• Several Claude accounts on one server, off by default. Turn it on under Accounts, add an account, and pick which one the server uses; the choice applies to Remote Control and to claude in a terminal alike. You choose whether the accounts share the agent's memory, settings and MCP servers, or whether each account keeps its own — sharing is the default, so adding a second account doesn't leave you starting from nothing. Several accounts can be signed in and connected at the same time.

• Signing in happens in the browser, with no terminal: the page opens the authorisation URL, you paste back the code it gives you, and that's it. The one-time code is posted, never logged.

• Everything is reported per account once you have more than one: plan usage and limits, sign-in state, CPU and memory (attributed by reading which account each process actually selected), and Remote Control — each account runs its own supervised session, with its own directory, log, session id and history, and they can be connected simultaneously.

• Your existing login is never touched. It stays exactly where it is as the main account, extra accounts get their own folder beside it, and removing an account deletes its credentials and settings and nothing else — the agent's memory and session transcripts are always preserved.

✅ Compatibility

Requires Unraid 6.12.0+ (inherited from upstream). Verified on this fork's own NAS running Unraid 7.3.2. The plugin relies on standard Dynamix webGUI mechanisms (.page files, /update.php, dynamix.cfg) present throughout the 6.x/7.x line, so it should work on any reasonably recent install. If you try it on an older or newer release, please open an issue with the result.

📦 Installation

Plugin URL (Unraid → Plugins → Install Plugin):

https://raw.githubusercontent.com/Nebur692/claude-code-remote-control-unraid-plugin/main/claude-code.plg

See the releases page for the full changelog.

🧭 Usage

Open the Unraid terminal and run:

claude

Authentication and settings persist across reboots automatically. Configure the appdata path via Settings → Utilities → Claude Code.

This covers the permission rules too. Claude Code keeps them per working directory, and Remote Control works in /, which on Unraid is a filesystem held in RAM — so that list is moved into appdata and linked back at boot, instead of being lost and asked for again after every reboot.

🩹 Troubleshooting

Check the install log:

cat /var/log/claude-code-install.log

Manually re-run the installer:

/usr/local/emhttp/plugins/claude-code/scripts/install-claude.sh

If the plugin ever stops loading after a reboot, check whether it landed in /boot/config/plugins-error/claude-code.plg — if so, reinstall it from Plugins in the Unraid web UI using the install URL above.

💙 Support

None of this would be possible without the community's support. If this project has been useful to you, consider supporting it via GitHub Sponsors, Ko-fi or PayPal — every bit helps keep it maintained.

Español

Fork de brianpugh/unraid-claude-code, un plugin de Unraid que instala la CLI de Claude Code —el asistente de programación con IA de Anthropic— en Unraid, con autenticación persistente entre reinicios.

Este fork existe para arreglar un fallo de fiabilidad en el arranque y para hacer bilingüe la página de configuración. Todo el crédito del diseño original del plugin es de brianpugh. El repositorio original no declara ninguna licencia, así que este fork se publica dejando el crédito claro al autor original, sin reclamar autoría del plugin base.

✨ Novedades

• El Control Remoto ya escribe lo que importa en el syslog, con la etiqueta claude-code: un puente que arranca, se para, se muere o se reinicia, una sesión que no se pudo retomar, una cuenta añadida, eliminada o seleccionada, y una cuenta cuyos datos no se pudieron leer. Nada de esto dejaba rastro fuera del log del propio plugin.

• Arreglado que las dos tareas programadas —el muestreo de uso y el vigilante de arriba— se instalaran y luego no quedaran programadas: el fichero del horario iba a un sitio equivocado, y actualizar el plugin no ejecutaba el paso que lo escribe.

• El Control Remoto ya no se muere con la página que lo arrancó. Un puente arrancado desde la web —incluido el reinicio que hace la propia actualización— pertenecía a la petición web que lo había pedido, así que al cerrar la ventana de la actualización se llevaba por delante los puentes de todas las cuentas, y en silencio: no quedaba nada vivo que lo escribiera en el log. Ahora cada puente corre en una sesión propia.

• Un vigilante cada cinco minutos cubre la otra mitad del problema: un Control Remoto marcado como encendido sin nada corriendo de verdad se vuelve a arrancar, en vez de quedarse caído hasta que alguien abra la página. Una cuenta parada a propósito se queda parada.

• Una cuenta ya no pierde su nombre ni su plan cuando falla la lectura. Un token caducado, o un fichero de credenciales pillado en el segundo en que el CLI lo estaba reescribiendo, vaciaba los dos —y en las pestañas de Cuentas y Panel eso se ve igual que si la cuenta hubiera desaparecido, mientras seguía ahí con la sesión iniciada y funcionando—. Una lectura fallida conserva lo que ya había y explica en el log por qué no pudo hacer más; sólo al eliminar una cuenta se borra.

• El Panel dice cuánto del porcentaje del plan se ha gastado en este servidor, medido cada cinco minutos en vez de estimado, y avisa con claridad cuando la cifra sólo cubre parte de la semana.

• Las versiones viejas de Claude Code se borran en vez de acumularse. En Unraid viven en RAM, donde cinco de ellas pasaban del gigabyte de largo; se conservan la que está corriendo y la más nueva.

• La ayuda de la memoria automática dice dónde vive de verdad: las sesiones de este servidor y de la misma carpeta de trabajo. No viaja a otras máquinas ni a claude.ai aunque sea la misma cuenta, y las cuentas de este servidor sí la comparten, porque para ellas son los mismos ficheros.

• Cada cuenta tiene ya su propia identidad. Antes todas compartían un mismo directorio de configuración, y la identidad vive en un fichero de ahí dentro, así que claude en una terminal decía la última cuenta que hubiera iniciado sesión, daba igual cuál estuviera elegida en la página. Ahora cada cuenta tiene el suyo, y lo que de verdad se comparte —la memoria del agente, las transcripciones, settings.json, los plugins, los planes guardados y el historial de órdenes— vuelve como enlaces al directorio de la cuenta principal: los mismos ficheros, no copias, así que lo que aprende una cuenta lo tienen todas.

• Panel nuevo en la pestaña de Cuentas para los ajustes que no se pueden enlazar porque viven dentro de los ficheros propios de cada cuenta: servidores MCP, directorios de confianza, herramientas permitidas en ellos y reglas de permisos. Manda la cuenta principal: sus cambios llegan solos a las demás, y un cambio hecho en otra cuenta sigue funcionando ahí y espera a que lo marques antes de pasar a ser de todas. Hay un modo bidireccional que los sube automáticamente. Un cambio hecho en una cuenta nunca se deshace a tus espaldas.

• Las reglas de permisos pasan a ser de cada cuenta con ese cambio, y a propósito: antes estaban en un fichero compartido donde una cuenta aprobando un comando se lo concedía también a la principal.

• La pestaña de Cuentas le pregunta a la API con el token de cada cuenta quién es, en vez de preguntárselo al CLI, que respondía el mismo email cacheado para todas.

• 25 ajustes más en Config. de Claude, explicados en lenguaje llano: esperar a que se reinicie el límite de uso y continuar, avisos al móvil cuando una sesión te necesita, mensajes entre sesiones de máquinas distintas, no leer fuera de las carpetas de trabajo, prohibir el modo sin preguntas, controles del nuevo modo automático, copias para deshacer, firmas en commits y PRs, flujos de trabajo y cierres para las skills. El modo rápido y el tope de esfuerzo llevan aviso de lo que cuestan.

• Arreglado un bug por el que el plugin podía quedar deshabilitado de forma permanente tras un reinicio: el icono del plugin se descargaba por red mediante una directiva nativa FILE/URL procesada de forma síncrona durante el paso de instalación de plugins en el arranque de Unraid —antes incluso de que se ejecutaran las propias comprobaciones de red del autor original (usadas para instalar Claude). Si ese único wget fallaba (por ejemplo, porque la red aún no estaba lista justo después de reiniciar), Unraid abortaba la instalación completa del plugin y movía permanentemente el .plg a /boot/config/plugins-error, saltándoselo silenciosamente en todos los arranques futuros hasta reinstalarlo a mano. Ahora el icono va embebido en base64 dentro del propio .plg, eliminando por completo esa dependencia de red.

• Añadida una página de Settings bilingüe (Unraid → Settings → Utilities → Claude Code): muestra inglés o español automáticamente según el idioma del webGUI de Unraid (cualquier locale es_* muestra español, el resto cae a inglés) — mismo enfoque que el fork de este mismo autor unraid-zabbix_agent-6lts.

• Arreglado el icono que se veía en la pestaña Plugins: ShowPlugins.php de Unraid nunca trata icon= como una URL — solo busca un fichero local llamado plugins/<name>/images/<name>.png. Por eso la URL remota del icon= original siempre caía en un icono genérico. Se quitó icon= y se movió el PNG a esa ruta exacta, así que ahora se detecta automáticamente.

• Al hacer clic en la fila del plugin en la pestaña Plugins, ahora lleva directamente a su página de Settings (añadido launch="Settings/claude-code"), igual que el fork unraid-zabbix_agent-6lts.

• Rediseñada la página de Settings para seguir el estilo de unraid-zabbix_agent-6lts (secciones con borde, una barra de estado compacta, notas de ayuda en línea) en vez del layout original de tabla/div improvisado.

• La pestaña Plugins ahora muestra "Claude Code Remote Control" con una descripción bilingüe real en vez de la palabra pelada claude-code — Unraid renderiza plugins/claude-code/README.md como esa descripción, así que este fork incluye uno (separado de este README principal).

• Añadida una sección "Logs" en la página de Settings con un enlace "Ver logs en vivo" que sigue en tiempo real /var/log/claude-code-install.log usando el mecanismo nativo openTerminal() de Unraid (el mismo que usan Docker/VMs/NUT) — sin necesidad de scripts extra.

• Arreglado que ese enlace de log en vivo nunca aparecía en la práctica: estaba oculto hasta que existía el fichero de log, y eso solo pasaba tras un reinicio real de Unraid. Ahora siempre se muestra.

• Añadida una acción real de "Actualizar Claude Code". El botón original "Reinstalar" no hace nada una vez que Claude Code ya funciona, así que no había forma de obtener una versión nueva desde el plugin. El nuevo botón ejecuta el propio claude update de la CLI y vuelve a cachear el resultado en APPDATA_PATH, ya que el siguiente arranque, si no, restauraría en silencio el binario cacheado antiguo sobre cualquier actualización. Reinstalar y Actualizar ahora escriben ambos en el fichero que sigue el enlace "Ver logs en vivo".

• Control Remoto: una nueva sección en Settings ejecuta claude remote-control como un proceso en segundo plano supervisado, para que puedas controlar una sesión de Claude Code en este NAS desde claude.ai/code o la app móvil de Claude — solo conexiones HTTPS salientes, nada abierto hacia adentro. Siempre retoma la misma sesión en curso en su directorio configurado (--continue), y solo arranca una sesión nueva la primera vez; nunca se inicia solo al arrancar Unraid, solo cuando pulsás Iniciar. Requiere haber iniciado sesión con OAuth de claude.ai (Pro/Max/Team/Enterprise); esta función de Anthropic no admite autenticación por API key. Por defecto usa un directorio dedicado /root/claude-remote-control en vez de /root directamente, porque Unraid nunca recuerda la confianza del workspace para un directorio home. Incluye historial de sesiones, reconexión a cualquier sesión pasada, y recuperación automática si una sesión queda archivada en claude.ai.

• Consumo de recursos en vivo: la página de ajustes muestra la CPU y la memoria que Claude Code consume de verdad en este servidor — el puente de Control Remoto, el proceso de sesión que lanza y cualquier claude interactivo que tengas en una terminal — actualizado cada pocos segundos mientras la página esté abierta, con el desglose por proceso. La CPU es una diferencia real entre medidas leída de /proc, no el pcpu de ps, que es una media de toda la vida del proceso y marca ~99% en una sesión que lleva semanas parada.

• Uso del plan: la página informa de las ventanas de 5 horas y semanal de tu plan de Claude, de las ventanas semanales por modelo si las hay, y del saldo y lo gastado si la cuenta tiene uso adicional activado, cada uno con la cuenta atrás hasta que se reinicia. Lee el propio endpoint de uso de Anthropic, el mismo que usa el comando /usage del CLI, que es un endpoint de metadatos: no ejecuta inferencia y no consume tokens. La página nunca reescribe las credenciales, y el token jamás viaja en una línea de comandos donde ps pudiera leerlo.

• Página de ajustes con pestañas: Panel, Cuentas, Control Remoto, Config. de Claude y Ajustes, en vez de un único scroll interminable. El Panel reúne el estado — versiones, array, recursos, uso del plan — y todo lo que se configura vive en su propia pestaña.

• La configuración del propio Claude Code, desde el navegador: la pestaña Config. de Claude edita el settings.json que lee Claude Code — modelo y modelos de respaldo, nivel de esfuerzo, estilo de salida, pensamiento extendido, idioma de las respuestas, tema, modo de edición, el modo de permisos y las reglas de permitir/preguntar/denegar, el Control Remoto al iniciar sesión, las variables de entorno, cuánto se conservan las transcripciones, la memoria automática, los hooks y el canal de actualización — más un editor JSON que cubre todas las demás claves de la referencia de ajustes de Anthropic. Guardar un campo no toca el resto del archivo y deja la versión anterior al lado como settings.json.bak.

• Un selector de preajustes en la pestaña Config.: Automática (la selección automática de modelo del propio Claude Code), Por defecto (borra todos los campos que gestiona el preajuste, tal y como si nunca se hubiera tocado la pestaña) y Optimizado para Opus 5 — que fija el modelo en Opus 5, mantiene la compactación automática activada, sigue el canal de actualización estable y limita cuánto texto en bruto puede volcar un comando muy «hablador» en la conversación, sin bajarle el nivel de esfuerzo, sin desactivar el pensamiento extendido ni caer a un modelo más simple si Opus está saturado: elegir Opus 5 significa seguir usando Opus 5, con toda su inteligencia intacta. Un preajuste solo rellena los campos; tú sigues revisando y guardando.

• Una salida cuando una sesión ya no se puede retomar. El Control Remoto tiene un botón «Iniciar sesión nueva» junto a Iniciar y Detener: Iniciar retoma la sesión que la cuenta estaba usando, y este abre una vacía, que es lo que hace falta cuando la anterior fue archivada, caducó o nunca llegó a conectarse. Además el supervisor ya reconoce esos fallos — cualquier error que nombre la sesión hace que se descarte y arranque otra al momento, en vez de pedir la misma sesión muerta cada cinco segundos indefinidamente — y solo se recuerda como sesión de una cuenta la que llegó a conectarse de verdad, así que un id que nunca funcionó no se reintenta en el siguiente arranque.

• Las sesiones viejas se pueden borrar de la lista, lo que quita la entrada y la nota de Claude sobre cuál fue la última sesión de ese directorio, y nada más: las transcripciones de las conversaciones se quedan donde están, y la memoria persistente del agente que se guarda junto a ellas no la toca nada de esta página. Una sesión conectada, o que una cuenta todavía va a retomar, no tiene botón de Borrar.

• Actualizar reinicia el Control Remoto por ti. Aplicar una versión nueva de Claude Code dejaba cualquier puente en marcha usando el binario antiguo hasta pararlo y arrancarlo a mano. Ahora Actualizar (y Reinstalar, cuando encuentra un binario más nuevo ya en caché) reinicia el puente de cada cuenta que esté realmente en marcha, y solo cuando la versión ha cambiado de verdad.

• Las cifras del plan ya no desaparecen: Claude Code renueva su token de acceso mientras se usa, así que una cuenta que lleva horas parada ya no puede refrescar su consumo. La línea del plan muestra entonces la última lectura válida junto con la hora a la que se tomó, en vez de quedarse en blanco, y cada cuenta atrás indica además la fecha y hora exactas en las que cae. La línea dice también si la suscripción está activa y cuándo renueva (el aniversario mensual de la fecha de alta: Anthropic informa de esa fecha, no de la de facturación, así que se marca como estimada).

• Varias cuentas de Claude en un mismo servidor, desactivado por defecto. Lo activas en Cuentas, añades una cuenta y eliges cuál usa el servidor; esa elección vale igual para el Control Remoto y para el claude de la terminal. Tú decides si las cuentas comparten la memoria del agente, los ajustes y los servidores MCP, o si cada una tiene los suyos — compartir es lo predeterminado, así que añadir una segunda cuenta no te deja empezando de cero. Puede haber varias cuentas con sesión iniciada y conectadas a la vez.

• Iniciar sesión se hace en el navegador, sin terminal: la página abre la URL de autorización, pegas el código que te da y ya está. El código de un solo uso viaja por POST y nunca se escribe en ningún log.

• Todo se informa por cuenta en cuanto tienes más de una: uso y límites del plan, estado de la sesión, CPU y memoria (atribuidas leyendo qué cuenta ha seleccionado realmente cada proceso) y el Control Remoto — cada cuenta ejecuta su propia sesión supervisada, con su directorio, su log, su id de sesión y su histórico, y pueden estar conectadas a la vez.

• Tu sesión actual no se toca jamás. Se queda exactamente donde está como cuenta principal, las cuentas nuevas van a su propia carpeta al lado, y eliminar una cuenta borra sus credenciales y sus ajustes y nada más: la memoria del agente y los transcripts de sesión se conservan siempre.

✅ Compatibilidad

Requiere Unraid 6.12.0 o superior (heredado del original). Verificado en el propio NAS de este fork, con Unraid 7.3.2. El plugin depende de mecanismos estándar del webGUI Dynamix (ficheros .page, /update.php, dynamix.cfg) presentes en toda la línea 6.x/7.x, así que debería funcionar en cualquier instalación razonablemente reciente. Si lo pruebas en una versión más antigua o más nueva, abre un issue contando el resultado.

📦 Instalación

URL del plugin (Unraid → Plugins → Install Plugin):

https://raw.githubusercontent.com/Nebur692/claude-code-remote-control-unraid-plugin/main/claude-code.plg

Consulta la página de releases para el changelog completo.

🧭 Uso

Abre la terminal de Unraid y ejecuta:

claude

La autenticación y la configuración persisten automáticamente entre reinicios. Puedes configurar la ruta de appdata desde Settings → Utilities → Claude Code.

Los permisos concedidos también. Claude Code los guarda por carpeta de trabajo, y Control Remoto trabaja en /, que en Unraid es un sistema de ficheros que vive en RAM: por eso esa lista se traslada a appdata y se enlaza de vuelta en cada arranque, en lugar de perderse y volver a pedirse tras cada reinicio.

🩹 Solución de problemas

Consulta el log de instalación:

cat /var/log/claude-code-install.log

Vuelve a ejecutar el instalador manualmente:

/usr/local/emhttp/plugins/claude-code/scripts/install-claude.sh

Si el plugin deja de cargar tras un reinicio, comprueba si ha acabado en /boot/config/plugins-error/claude-code.plg. Si es así, reinstálalo desde Plugins en la interfaz web de Unraid usando la URL de instalación de arriba.

💙 Apoya el proyecto

Sin el apoyo de la comunidad estos proyectos no serían posibles. Si te ha resultado útil, puedes apoyarlo vía GitHub Sponsors, Ko-fi o PayPal — cualquier aportación ayuda a seguir manteniéndolo.