A Docker container that enables running Anthropic's Claude Code on Windows machines without WSL
3.4K
A self-contained Docker setup for running Anthropic's Claude Code with your repository, featuring FCM-compliant architecture and Max plan support.
Claude Code is an agentic coding tool developed by Anthropic that lives in your terminal, understands your codebase, and helps you code faster through natural language commands. By integrating directly with your development environment, Claude Code streamlines your workflow without requiring additional servers or complex setup.
This version restructures the Docker setup for maximum flexibility:
claude/ folderThis implementation fully supports Anthropic's Max plan:
Download this repository into your project:
curl -L https://github.com/deepworks-net/docker.claude-code/archive/main.zip -o claude-docker.zip
unzip claude-docker.zip
mv docker.claude-code-main claude-docker
rm claude-docker.zip
Build and run:
cd claude-docker
docker-compose up -d --build
Enter the container:
docker-compose exec claude-code bash
# Quick start - no files needed!
docker run -it -v .:/home/coder/project deepworks/claude-code:latest
# Or with docker-compose.yml in your project:
version: '3.8'
services:
claude-code:
image: deepworks/claude-code:latest
volumes:
- .:/home/coder/project:rw
# Optional: Add custom config by uncommenting:
# - ./claude/CLAUDE.md:/home/coder/claude/CLAUDE.md:ro
environment:
- ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
working_dir: /home/coder/project
tty: true
stdin_open: true
# Run it
docker-compose up -d
docker-compose exec claude-code bash
# If using SSH
git submodule add [email protected]:deepworks-net/docker.claude-code.git claude-docker
# Or using HTTPS
git submodule add https://github.com/deepworks-net/docker.claude-code.git claude-docker
git submodule update --init --recursive
Both the download method and submodule method place the files in the same
claude-docker directory, so the Docker commands remain identical.
your-project/
├── src/ # Your project source code
├── docs/ # Your project documentation
├── package.json # Your project dependencies
├── claude-docker/ # Claude Code Docker setup (Option 1 or 3)
│ ├── Dockerfile
│ ├── docker-compose.yml
│ ├── startup.sh
│ └── claude/ # Claude configuration folder
│ ├── config/ # Claude config files
│ ├── models/ # FCM pattern definitions
│ └── validation/ # FCM validation tools
└── docker-compose.yml # Simple compose file (Option 2)
This setup supports logging in with your Claude Max plan credentials:
/login to switch to MaxYou can also use a direct API key:
Start Claude Code inside the container:
claude
If using a Max plan, log in with your Claude credentials:
/login
Claude Code will have access to your entire repository and can help with:
With the Max plan, your usage limits are shared across both Claude and Claude Code:
| Plan | Claude Messages | Claude Code Prompts |
|---|---|---|
| Max (5x Pro/$100) | ~225 messages / 5 hrs | ~50-200 prompts / 5 hrs |
| Max (20x Pro/$200) | ~900 messages / 5 hrs | ~200-800 prompts / 5 hrs |
Note: Usage varies based on message length, complexity, file attachments, and other factors.
This setup includes FCM compliance for enhanced structural integrity:
FCM resources are available in the claude/ folder:
claude/models/ - Formal FCM pattern definitionsclaude/config/ - FCM-compliant configurationclaude/validation/ - FCM validation and tracking toolsANTHROPIC_API_KEY - Your Anthropic API key (if not using Max plan login)CLAUDE_USE_MAX_PLAN - Set to "true" to show Max plan information on startupThe docker-compose configuration mounts:
/home/coder/project/repository/home/coder/claudeThis project is licensed under the MIT License - see the LICENSE file for details.
If you're upgrading from a previous version:
config/, models/, and validation/ folders into a new claude/ folder./claude instead of individual folders/home/coder/project/repository (your actual project)claude-docker/ directory so the compose volumes remain the sameContent type
Image
Digest
sha256:9d8a46e2b…
Size
356.3 MB
Last updated
over 1 year ago
docker pull deepworks/claude-code