Arch Linux User Repository

@StratosL thanks for clarification - i really didnt know about that button. i think its the best to have CC installed and symlinked before using it in claude desktop (it is also mentioned here https://github.com/patrickjaja/claude-desktop-bin/?tab=readme-ov-file#claude-code-integration)

but if someone is running in same usecase, i have now added linux fixes for it.

2026-01-13

Added

• Local Agent Mode for Linux - New patch (enable_local_agent_mode.py) enables the "chillingSloth" feature on Linux:
• Enables Local Agent Mode sessions with git worktree isolation
• Enables Claude Code for Desktop integration
• Patches qWe() and zWe() platform checks to return "supported" on all platforms
• Note: SecureVM (yukonSilver) and Echo features still require macOS-only Swift modules
• ClaudeVM Linux handling - New patch (fix_vm_session_handlers.py) to gracefully handle VM features not supported on Linux:
• getDownloadStatus returns NotDownloaded on Linux
• getRunningStatus returns Offline on Linux
• download/startVM fail with helpful error messages
• Error handler suppresses unsupported feature errors

Fixed

• Claude Code Linux platform support - Updated fix_claude_code.py to add Linux support:
• Added Linux platform detection to getHostPlatform() (root cause of "Unsupported platform: linux-x64" error)
• Linux checks now run BEFORE getHostTarget() to avoid throwing errors

+ anthropic recently released "Cowork" feature in claude desktop, unfortunately er cannot fix that for linux since it requires @ant/claude-swift macOS native module

On Manjaro KDE the app runs, but if I switch to Claude code, clicking on "install runtime dependencies" fails. I thought I should run claude-desktop with sudo, but the app does not run properly like that (blank).

Then I installed Claude code separately via curl -fsSL https://claude.ai/install.sh | bash

and I have linked sudo ln -s ~/.local/bin/claude /usr/bin/claude

running claude --version

gives me "2.1.3 (Claude Code)" and claude code within the app works fine.

@myfox built in nodejs error is fixed now.

2025-12-17

• MCP node host path fix - Fix incorrect path for MCP server node host on Linux (fix_node_host.py)

• Startup settings fix - Handle Linux platform in startup settings to avoid validation errors (fix_startup_settings.py)

• Tray icon theme fix - Use theme-aware tray icon selection on Linux (fix_tray_icon_theme.py)

@myfox thanks for that detailed bug report.

i have tested it locally isUsingBuiltInNodeForMcp true / false (~/.config/Claude/claude_desktop_config.json). Its always working.

that issue might be related to electron, please ensure your version is updated (v39.2.7 latest) (https://github.com/electron/electron/issues/36411 https://github.com/electron/electron/issues/42978)

Path resolution bug prevents built-in MCP Filesystem server from loading

Package: claude-desktop-bin 1.0.1217-1

Description:

The built-in Filesystem MCP server fails to start due to incorrect path resolution in the Electron wrapper. The application attempts to load the MCP runtime from a malformed path.

Expected path:

/usr/lib/claude-desktop-bin/app.asar/.vite/build/mcp-runtime/nodeHost.js

Actual (broken) path:

/usr/lib/claude-desktop-bin/locales/app.asar/.vite/build/mcp-runtime/nodeHost.js

Reproduction:

1. Install claude-desktop-bin from AUR

2. Launch Claude Desktop

3. Observe errors in ~/.config/Claude/logs/main.log:

[error] Failed to start UtilityProcess: Node host not found at: /usr/lib/claude-desktop-bin/locales/app.asar/.vite/build/mcp-runtime/nodeHost.js

Root Cause:

Current wrapper (/usr/bin/claude-desktop):

#!/bin/bash
exec electron /usr/lib/claude-desktop-bin/app.asar "$@"

Electron's __dirname or resource path resolution incorrectly prepends /locales/ to app.asar paths when launched this way.

Temporary Workaround:

sudo mkdir -p /usr/lib/claude-desktop-bin/locales/app.asar/.vite/build/mcp-runtime
sudo asar extract /usr/lib/claude-desktop-bin/app.asar /tmp/claude-extracted
sudo cp /tmp/claude-extracted/.vite/build/mcp-runtime/nodeHost.js \
    /usr/lib/claude-desktop-bin/locales/app.asar/.vite/build/mcp-runtime/

Suggested Fix:

Update wrapper to properly set resource paths:

#!/bin/bash
export ELECTRON_RUN_AS_NODE=
cd /usr/lib/claude-desktop-bin
exec electron app.asar "$@"

Or investigate if Electron needs explicit --app-path flag or other resource path configuration.

System Info:

• Arch Linux (current)

• electron 33.2.1-1

• nodejs 23.3.0-1

anthropic recently added Claude Code support in Claude Desktop, but hardcoded to only support darwin and win32.

i have added a patch for that, now it supports x86_64 linux (requires to have a /usr/bin/claude binary - just symlink if its installed elsewhere on your OS).

this is how i have reinstalled it:

rm -rf ~/.cache/yay/claude-desktop-bin

yay -S claude-desktop-bin --noconfirm --cleanafter

here the patch: - https://github.com/patrickjaja/claude-desktop-bin/blob/master/patches/fix_claude_code.py

i have noticed a major (from 0.14.10 to 1.0.332) version change in official releases (.exe) and adjusted the automated linux package build. Stay updated:

rm -rf ~/.cache/yay/claude-desktop-bin

yay -S claude-desktop-bin --noconfirm --cleanafter

upstream repo https://github.com/patrickjaja/claude-desktop-bin/releases

@patrickjaja: looks good, thanks for the swift fix!

fixed. i have tested it as far as possible. feedback welcome.

yay -S claude-desktop-bin --cleanafter --rebuild

it doesn't start up any user interface, but throws the following error and then hangs there forever:

$ claude-desktop
2025-10-15 11:44:04 [info] Starting app {
  appVersion: '0.13.64',
  isPackaged: false,
  platform: 'linux',
  arch: 'x64',
  nodeVersion: '22.20.0'
}
App threw an error during load
Error: ENOENT, resources/i18n/en-US.json not found in /usr/lib/claude-desktop-bin/app.asar
    at createError (node:electron/js2c/node_init:2:2060)
    at readFileFromArchiveSync (node:electron/js2c/node_init:2:10198)
    at t.readFileSync (node:electron/js2c/node_init:2:10982)
    at Lie (/usr/lib/claude-desktop-bin/app.asar/.vite/build/index.js:135:7769)
    at Object.<anonymous> (/usr/lib/claude-desktop-bin/app.asar/.vite/build/index.js:135:6903)
    at Module._compile (node:internal/modules/cjs/loader:1714:14)
    at Module._extensions..js (node:internal/modules/cjs/loader:1848:10)
    at Module.load (node:internal/modules/cjs/loader:1448:32)
    at Module._load (node:internal/modules/cjs/loader:1270:12)
    at c._load (node:electron/js2c/node_init:2:17993)
A JavaScript error occurred in the main process
Uncaught Exception:
Error: ENOENT, resources/i18n/en-US.json not found in /usr/lib/claude-desktop-bin/app.asar
    at createError (node:electron/js2c/node_init:2:2060)
    at readFileFromArchiveSync (node:electron/js2c/node_init:2:10198)
    at t.readFileSync (node:electron/js2c/node_init:2:10982)
    at Lie (/usr/lib/claude-desktop-bin/app.asar/.vite/build/index.js:135:7769)
    at Object.<anonymous> (/usr/lib/claude-desktop-bin/app.asar/.vite/build/index.js:135:6903)
    at Module._compile (node:internal/modules/cjs/loader:1714:14)
    at Module._extensions..js (node:internal/modules/cjs/loader:1848:10)
    at Module.load (node:internal/modules/cjs/loader:1448:32)
    at Module._load (node:internal/modules/cjs/loader:1270:12)
    at c._load (node:electron/js2c/node_init:2:17993)