Docker container with Claude Code development tools, agent templates, and SuperClaude framework.
Repository: https://github.com/btafoya/claudecontainer
- Quick Start
- What's Installed
- SuperClaude Usage
- VS Code Integration
- Documentation
- Build Info
- Key Features
- Contributing
- License
- Support
# Clone from GitHub
git clone https://github.com/btafoya/claudecontainer.git
cd claudecontainer# Build and start the container
docker-compose up -d
# Access interactive shell
docker-compose exec claudecontainer sh
# Stop the container
docker-compose down
# Rebuild after Dockerfile changes
docker-compose build
docker-compose up -d# Build the image
docker build -t claudecontainer:latest .
# Run with your project
docker run --rm -v $(pwd):/app -v $(pwd)/output:/output claudecontainer:latest
# Interactive shell
docker run --rm -it -v $(pwd):/app claudecontainer:latest sh# Once published to GHCR
# docker pull ghcr.io/btafoya/claudecontainer:latest- Node.js 24.11.1
- Python 3.12.12
- Git 2.49.1
- uv/uvx 0.9.13 (Python package manager)
- Claude CLI 2.0.55 (for MCP management) 🆕
- Claude Agent SDK 0.1.55
- SuperClaude 4.1.9 ⭐
- 8 Agent Templates in
/app/.claude/agents/ - 31 SuperClaude Commands in
/app/.claude/commands/sc/🆕 - Container Operations Skill in
/app/.claude/skills/ - SuperClaude Framework at
/usr/local/bin/superclaude - Claude Code Settings in
/app/.claude/settings.json(Git attribution disabled)
# Check installation
docker run --rm claudecontainer:latest superclaude doctor
# Show version
docker run --rm claudecontainer:latest superclaude --version
# Install SuperClaude commands
docker run --rm -v $(pwd):/app claudecontainer:latest superclaude installNEW: Complete Visual Studio Code integration guide available!
See VSCODE_INTEGRATION.md for:
- 🔧 VS Code setup and configuration
- 🐳 Remote container development
- 🔌 MCP server configuration (Context7, Serena, Sequential Thinking, Playwright)
- 💻 Development workflows and best practices
- 🐛 Debugging and troubleshooting
# Install Remote - Containers extension
code --install-extension ms-vscode-remote.remote-containers
# Open project in container
code .
# Press F1 → "Remote-Containers: Open Folder in Container"- VS Code Integration Guide - Complete VS Code setup, MCP configuration, and development workflows 🆕
- Final Test Report - Comprehensive testing and production readiness validation 🆕
- Dockerfile Test Report - Detailed build and component verification 🆕
- Dockerfile - Complete container configuration
- docker-compose.yml - Docker Compose configuration
- .claude/skills/container-operations.md - Container operations skill (361 lines)
- Base: node:24-alpine
- User: sandboxuser (uid=10001)
- Working Dir: /app
- Build Time: ~120 seconds (first), <10 seconds (cached)
- Image Size: ~550-600 MB
✅ Claude CLI 2.0.55 for MCP management 🆕 ✅ 31 SuperClaude slash commands 🆕 ✅ 16 Claude Code components (agents, commands, settings) ✅ SuperClaude Framework 4.1.9 ✅ Container operations skill (361 lines) ✅ Git attribution disabled (clean commits) 🆕 ✅ Fixed uv/uvx installation ✅ Proper directory permissions ✅ Non-root execution (security) ✅ All tools verified working (9/9 tests passed)
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository: https://github.com/btafoya/claudecontainer/fork
- Create a feature branch:
git checkout -b feature/amazing-feature - Commit your changes:
git commit -m 'Add amazing feature' - Push to the branch:
git push origin feature/amazing-feature - Open a Pull Request
Found a bug or have a suggestion? Open an issue
This project is licensed under the MIT License - see the LICENSE file for details.
- GitHub Repository: https://github.com/btafoya/claudecontainer
- Issues: https://github.com/btafoya/claudecontainer/issues
- Pull Requests: https://github.com/btafoya/claudecontainer/pulls
For questions or support:
- Open an issue
- Check the documentation
- Review the VS Code Integration Guide
Status: ✅ Production Ready Last Updated: 2025-11-28 Maintainer: @btafoya