dyrandz/claude-code

🚀 Claude Code Docker Image

📌 Overview

Run Claude Code in a Docker container to enable AI-powered code assistance without installing it on your local system.

✅ Getting Started

1️⃣ Pull the Docker Image

sh
docker pull dyrandz/claude-code:latest

2️⃣ Run a Persistent Container

sh
docker run -dit --name claude-global -v /path/to/your/repository:/repo dyrandz/claude-code:latest bash

🔹 Replace /path/to/your/repository with your actual project directory.

🛠️ Volume Mounting Example for Windows Users

If your local directory is:

Windows Path: D:/Repository

Docker Path: /mnt/d/Repository

sh
docker run -dit --name claude-global -v /mnt/d/Repository:/repo dyrandz/claude-code:latest bash

🔎 Verify That the Volume Is Mounted Correctly Run this inside the container:

sh
mount | grep /repo

✅ Expected Output (if mounted correctly):

/mnt/d/Repository on /repo type drvfs (rw,noatime,...)

🚫 If the output is:

overlay on /repo type overlay (...)

Then Docker failed to mount the Windows folder.

🛠️ Alternative Fix: Use Windows Path Directly

If /repo is still empty, try running:

sh
docker run -dit --name claude-global -v "D:/Repository:/repo" dyrandz/claude-code:latest bash

✅ Why This Works:

Windows sometimes requires D:/Repository instead of /mnt/d/Repository.

Using quotes " " ensures correct path parsing in Git Bash.

🛠️ Volume Mounting Example for macOS & Linux

If your local directory is:

Linux/macOS Path: ~/Repository

Docker Path (Inside Container): /repo

Run:

sh
docker run -dit --name claude-global -v ~/Repository:/repo dyrandz/claude-code:latest bash

Enter the Running Container

sh
docker exec -it claude-global bash

4️⃣ Run Claude Code Once inside, you can use Claude Code:

🔹 Ask Claude to add a new feature:

sh
claude add "Create a new authentication system."

🔹 Ask Claude to explain code:

sh
claude explain .

🔹 Refactor your code:

sh
claude refactor "Optimize database queries in userService.js"

🛑 Stopping & Restarting the Container ✅ Stop the container:

sh
docker stop claude-global

✅ Restart it later:

sh
docker start claude-global

✅ Remove the container completely:

sh
docker rm -f claude-global

📌 Notes 🔹 Replace /path/to/your/repository with your actual project directory.

🔹 The correct Docker image is dyrandz/claude-code:latest.

🔹 If you need help, check the official Claude Code documentation.

🎯 Start using Claude Code now! 🚀