Installation

Clew runs on Windows, macOS, Linux, and WSL2. Runtime: Bun 1.3+.

Prerequisites

• Bun 1.3+ — required runtime for both global installs and source builds
• At least one AI provider API key

Via npm (global)

npm install -g @jonusnattapong/claudecode
clew

# Verify
clew --version

Important: the npm package installs the launcher only. You must install Bun separately before running clew.

Via Bun (global)

bun install -g @jonusnattapong/claudecode
clew

From Source

git clone https://github.com/JonusNattapong/claudecode.git
cd claudecode
bun install
bun run build
bun run start

# Development mode with watch
bun run dev

Build output goes to dist/. The build uses Bun bundler with compile-time feature defines (TRANSCRIPT_CLASSIFIER, CHICAGO_MCP).

Platform-Specific Notes

Windows

• Both cmd and PowerShell supported as shell targets
• ripgrep bundled at src/utils/vendor/ripgrep/x64-win32/rg.exe
• WSL2 recommended for best experience
• Windows argv normalization in src/entry.ts
• TTY polyfill for Ink compatibility in src/main.tsx

macOS

• Native support with menu bar app integration (moltbot)
• Voice Wake and Talk Mode overlays
• Keychain prefetch for faster OAuth startup
• WebChat and debug tools available

Linux

• Full support via terminal
• Tailscale Serve/Funnel for remote gateway access

Release Channels

Verifying Installation

/doctor     # Run environment diagnostics
/status     # Check version, model, account, API connectivity