## English

Fork of [brianpugh/unraid-claude-code](https://github.com/brianpugh/unraid-claude-code), an Unraid

plugin that installs [Claude Code](https://github.com/anthropics/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 add a Remote Control feature. 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 changed from upstream:

- Fixed a bug where the plugin could become permanently disabled after a reboot: the plugin

icon was fetched over the network at boot, and if that single request failed (network not up yet

right after a reboot), Unraid aborted the entire plugin install and silently banished it to

/boot/config/plugins-error on every future boot. The icon is now embedded inline, removing that

dependency entirely.

- Added a bilingual (EN/ES, auto-detected) Settings page, a working "Update Claude Code" action, and

a live log viewer.

- Remote Control: 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. Always resumes the same session in its configured directory,

never starts automatically at boot. Requires a claude.ai OAuth login (Pro/Max/Team/Enterprise).

Includes session history, reconnect-to-any-past-session, and auto-recovery if a session gets

archived on the claude.ai side.

Compatibility: requires Unraid 6.12.0+, verified on 7.3.2.

Install (Unraid → Plugins → Install Plugin):

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

Repo & full changelog: https://github.com/Nebur692/claude-code-remote-control-unraid-plugin

Please report issues either in this thread or on GitHub: https://github.com/Nebur692/claude-code-remote-control-unraid-plugin/issues

---

## Español

Fork de [brianpugh/unraid-claude-code](https://github.com/brianpugh/unraid-claude-code), un plugin

de Unraid que instala la CLI de [Claude Code](https://github.com/anthropics/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 añadir una función de

Control Remoto. Todo el crédito del diseño original es de brianpugh — el repo original no

declara licencia, así que este fork se publica dejando el crédito claro al autor original, sin

reclamar autoría del plugin base.

Qué cambia respecto al original:

- Arreglado un bug por el que el plugin podía quedar **deshabilitado permanentemente tras un

reinicio**: el icono se descargaba por red durante el arranque, y si esa petición fallaba (red aún

no lista justo tras reiniciar), Unraid abortaba toda la instalación y lo movía en silencio a

/boot/config/plugins-error en todos los arranques futuros. Ahora el icono va embebido, eliminando

esa dependencia.

- Añadida página de Settings bilingüe (EN/ES automático), una acción real de "Actualizar Claude

Code", y un visor de logs en vivo.

- Control Remoto: ejecuta claude remote-control como proceso supervisado en segundo plano,

para controlar una sesión de Claude Code en este NAS desde claude.ai/code o la app móvil — solo

conexiones HTTPS salientes, nada abierto hacia adentro. Siempre retoma la misma sesión en su

directorio configurado, nunca arranca solo al iniciar Unraid. Requiere login OAuth de claude.ai

(Pro/Max/Team/Enterprise). 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.

Compatibilidad: requiere Unraid 6.12.0+, verificado en 7.3.2.

Instalación (Unraid → Plugins → Install Plugin):

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

Repo y changelog completo: https://github.com/Nebur692/claude-code-remote-control-unraid-plugin

Reporta problemas aquí o en GitHub: https://github.com/Nebur692/claude-code-remote-control-unraid-plugin/issues

From claude debug session the usage sampler creates /mnt/user/... on rootfs while the array is stopped, and that stops emhttpd from mounting the user shares on the next Start.

@sonisame's finding checks out in the plugin source (claude-code.plg, commit 63fb893):

- a cron job runs scripts/usage-sampler.php every 5 minutes (line 1226);

- the sampler calls s_hist_dir() first thing (line 3431), which does mkdir(.../usage-history, 0700, true) under the appdata path, /mnt/user/appdata/claude-code by default (lines 3318-3320);

- nothing checks that the array is started. With the array stopped, /mnt/user is just a folder in RAM, so the cron job creates /mnt/user/appdata/... there, and the next array start finds a non-empty /mnt/user.

The plugin already checks this elsewhere (mountpoint -q /mnt/user, lines 1031 and 4464), so the fix is the same check at the top of the sampler: exit when the appdata path's share is not mounted. Until then, stopping the array is safer with the cron entry removed.

More generally, an agent with root on the host is a big blast radius on Unraid; a container with only the needed shares mapped (and a scoped Unraid API key for server tasks) avoids this whole class of problem.