How kurogoma4d/claude-code-server works
Claude Code Server exposes a browser-based terminal for interactive Claude Code sessions. A browser connects to the Socket.io server, whose event handlers validate the requested working directory and delegate session, input, resize, and termination operations to a PTY manager. The manager starts and tracks Claude CLI processes; output and exit events are streamed back to the browser. The README documents the xterm.js interface and security intent; the HTML implementation was not sampled, so its internal behavior is not shown.
Main entry points: ptyHandlers.ts Session event handlers · index.html Web terminal UI · server.ts HTTP and Socket server · ptyManager.ts PTY manager
Components 6
Terminal Client
- Web terminal UI
public/index.html
Web Server
- HTTP and Socket server
src/server.ts
Session Handling
- Session event handlers
src/ptyHandlers.ts
PTY Processes
- PTY manager
src/ptyManager.ts
Other components
- Terminal user
- Claude Code CLI
Connections 8
- Terminal user → Web terminal UI: uses
README.md - Web terminal UI → HTTP and Socket server: connects by WebSocket
README.md - HTTP and Socket server → Web terminal UI: serves static files
src/server.ts - HTTP and Socket server → Session event handlers: dispatches events
src/server.ts - Session event handlers → PTY manager: controls PTYs
src/ptyHandlers.ts - PTY manager → Claude Code CLI: spawns process
src/ptyManager.ts - PTY manager → Session event handlers: calls output callbacks
src/ptyManager.ts - Session event handlers → Web terminal UI: emits terminal events
src/ptyHandlers.ts