Installation

Claude Code runs on Windows, macOS, Linux, and WSL2. Runtime: Bun 1.3+ or Node.js 22.12.0+.

Prerequisites

Bun 1.3+ — recommended runtime (for development and source builds)
Node.js 22.12.0+ — alternative runtime (enforced at startup by src/infra/runtime-guard.ts)
At least one AI provider API key

Via npm (global)

npm install -g @jonusnattapong/claudecode
claude

# Verify
claude --version

Via Bun (global)

bun install -g @jonusnattapong/claudecode
claude

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

Channel	npm Tag	Description
stable	`latest`	Tagged releases (vYYYY.M.D)
beta	`beta`	Prereleases (vYYYY.M.D-beta.N)
dev	`dev`	Moving main branch

Verifying Installation

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