cc-docker

A Docker-based development environment management tool for AI coding assistants

A convenient way to set up and manage a containerized development environment with pre-installed AI coding tools (Claude Code, OpenAI Codex, etc.).

Topics: docker development-environment ai-coding claude-code openai-codex python nodejs devtools containerization bash-script

Features

• 🐳 Pre-configured development environment (Python 3.12 + Node.js LTS)
• 🤖 Pre-installed AI coding tools (Claude Code, OpenAI Codex, etc.)
• 🛠️ Interactive menu for container management
• 🔧 Flexible environment variable configuration
• 📦 Auto-build Docker image

Installation

git clone https://github.com/ushell/cc-docker.git
cd cc-docker
chmod +x ccdocker

# Optional: Add to PATH
sudo ln -s $(pwd)/ccdocker /usr/local/bin/ccdocker

Quick Start

# Interactive menu
./ccdocker

# Or use commands directly
./ccdocker enter      # Enter container
./ccdocker start      # Start container
./ccdocker stop       # Stop container
./ccdocker status     # Show status
./ccdocker build      # Build image

Note: Docker image (aicoding-dev:latest) will be automatically built on first use.

Usage

Command-Line Options

./ccdocker [command]

Commands:
  (no args)       Open interactive menu
  enter           Enter container
  exec <command>  Execute command in container
  start           Start container
  stop            Stop container
  restart         Restart container
  status          Show container status
  clean           Remove container
  build           Build/rebuild image
  init            Initialize environment variable files
  help            Show help information

Configuration

Environment variable configuration:

• .docker/env - Container-specific environment variables

Container names are auto-generated: {directory-name}-ccdocker-{random-string}

Docker Image

Image includes:

• Python 3.12 (slim)
• Node.js LTS
• AI tools: @anthropic-ai/claude-code, @openai/codex, opencode-ai
• Development tools: git, vim, curl, wget, build-essential, sudo
• Non-root user developer (sudo privileges)

Build image:

./ccdocker build
# or
docker build -t aicoding-dev:latest -f Dockerfile .

Troubleshooting

# Docker not running
docker info
sudo systemctl start docker  # Linux

# Permission issues
chmod +x ccdocker
sudo usermod -aG docker $USER  # Linux, logout required

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see the LICENSE file for details.

Support

If you encounter any issues or have questions, please open an issue on GitHub.

---

Note: Make sure you have proper API keys and configurations set up in your environment variables.