jiangmuran

jiangmuran / claude-in-box

Public

Portable Claude Code dev environment in a Docker container — multi-session, hook-driven, web-managed, with transparent SOCKS5. Runs on a Raspberry Pi.

ai-dev-tools anthropic claude claude-code docker
23
0
85% credibility
Found May 21, 2026 at 23 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Go
AI Summary

claude-in-box is an open-source project that packages Claude Code into a Docker container and exposes it as a web service. It lets you run Claude Code on a real server and drive it from any device — browser, phone, or even tiny embedded microcontrollers. The container includes a complete development environment with Node, Python, Go, and Rust, plus Claude Code itself. You access it through a web UI showing three simultaneous views: a raw terminal, a chat-style transcript, and an API inspector. Sessions are persistent and resumable, and you can issue scoped API tokens for different clients. The service supports multiple authentication methods (Anthropic subscription via OAuth or API key), includes a programmable hooks system for automating workflows, and runs transparently through a SOCKS5 proxy when needed. Multi-arch images (amd64 and arm64) are available.

How It Works

1
📦 Imagine your coding assistant lives on a server

Instead of Claude Code sitting on your laptop, you run it on a powerful machine somewhere you own, accessible from anywhere.

2
🐳 You spin up a container with everything included

One Docker image gives you a complete development environment: Node, Python, Go, Rust, plus Claude Code itself — no setup required.

3
🌐 A web panel opens in your browser

You log in with a master password the container generates at startup, and you see your active conversations listed on the left sidebar.

4
💬 You create a new conversation and watch it come alive

Claude Code starts running interactively inside the container. The panel shows you three views at once: a raw terminal, a chat-style transcript, and an API inspector.

5
You connect from whatever device fits the moment
💻
Desktop browser

Full dashboard with terminal, chat, and inspector views running side by side.

📱
Phone or tablet

A responsive, mobile-friendly version of the same interface.

🔌
Tiny device (ESP32, STM32)

A special lightweight protocol lets microcontrollers join conversations too.

6
🔗 Your work stays persistent and shareable

Sessions remember everything — you can resume a conversation from your phone that you started on your laptop. Each session gets its own API token for sharing with other tools.

✨ Claude Code lives everywhere you do

You unlocked Claude Code from your desk. Now you can pair-program with it from a café, automate tasks from a server, or let an embedded gadget join the conversation.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 23 to 23 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is claude-in-box?

claude-in-box is a Docker container that moves Claude Code off your laptop and onto a real server you control. You spin it up on a cloud VM, home server, or even a Raspberry Pi, then access it through a web browser or API from anywhere. Inside the container, Claude runs in full interactive mode with a complete dev environment pre-installed: Node, Python, Go, Rust, plus Redis, PostgreSQL, and Docker. The container exposes one port that multiplexes a web UI, REST API, WebSocket, and SSE streams simultaneously.

Why is it gaining traction?

The killer feature is multi-session management with structured event streaming. Instead of screen-scraping a terminal, you get typed JSON frames for text deltas, tool calls, todo updates, and token usage. Hooks fire on every lifecycle event, letting you intercept or modify Claude's behavior programmatically. The transparent SOCKS5 proxy routes all outbound traffic through one upstream without configuring each tool individually. For embedded use, there's an AES-256-GCM envelope transport so an ESP32 or STM32 can participate as a first-class client with just an HTTP client and crypto library.

Who should use this?

Developers who want Claude Code accessible from multiple devices without re-authenticating each time. Teams wanting a shared Claude instance with per-session billing via OAuth tokens. Embedded systems engineers building firmware that drives or monitors Claude sessions. Anyone behind restrictive firewalls who needs all Claude traffic routed through a proxy. The embedded client library in C makes this practical for microcontroller projects.

Verdict

This is a compelling architecture for teams standardizing on Claude Code, but the 0.8500000238418579% credibility score reflects an early-stage project: only 23 stars, heavy reliance on roadmap features (Anthropic/OpenAI API adapters), and limited production hardening. The Go implementation is clean and test coverage exists, but the Docker image hasn't shipped yet. Worth watching, worth prototyping with, but don't deploy to production until M1 milestones are checked off.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.