DevOps

Docker

Claude Code reads Dockerfiles, writes docker-compose configs, debugs container issues, and optimizes images — all from your terminal.

Setup

1.
Ensure Docker is installed and running
Claude Code executes Docker commands directly in your terminal. Make sure the Docker daemon is running and your user has permission to run docker commands.
```
docker --version && docker info
```
2.
Start Claude Code in your project directory
Navigate to a project that uses Docker (or where you want to add Docker support) and launch Claude Code. It will detect existing Dockerfiles and docker-compose files automatically.
```
cd /path/to/project && claude
```
3.
Add Docker conventions to CLAUDE.md
Specify your base image preferences, multi-stage build requirements, and registry details so Claude Code generates Docker configurations that match your team standards.
```
echo "# Docker\n- Base image: node:20-alpine\n- Use multi-stage builds\n- Registry: ghcr.io/our-org" >> CLAUDE.md
```

Features

+Reads and writes Dockerfiles with best practices (multi-stage builds, layer caching, minimal images)
+Generates and modifies docker-compose.yml files for multi-service applications
+Debugs container issues by reading logs, inspecting containers, and tracing errors
+Optimizes image size by analyzing layers and suggesting improvements
+Creates .dockerignore files to reduce build context and image size
+Writes CI/CD pipeline steps for building, testing, and pushing Docker images

Use Cases

Dockerize an existing application

Point Claude Code at a project without Docker support and ask it to containerize it. It analyzes your dependencies, creates an optimized Dockerfile, adds a .dockerignore, and verifies the build works.

Debug failing container builds

Paste a Docker build error and Claude Code will read your Dockerfile, identify the issue (missing dependency, wrong base image, permission problem), and apply the fix.

Optimize image size

Ask Claude Code to analyze your Docker image. It runs docker history, identifies large layers, and refactors your Dockerfile to use multi-stage builds, Alpine base images, and proper layer ordering.

Create a full development environment

Describe your stack (e.g., Node + PostgreSQL + Redis) and Claude Code generates a complete docker-compose.yml with volumes, networks, health checks, and environment variables.

How Claude Code understands Docker

Claude Code reads your Dockerfile the same way it reads any source file — as text. But it also understands the semantics: base image selection, layer ordering, cache invalidation, multi-stage builds, and security best practices. When you ask it to create or modify Docker configurations, it applies these best practices automatically.

Because Claude Code can execute shell commands, it goes beyond just writing files. It runs docker build to verify the image compiles, docker run to test the container, and docker images to check the final size. This feedback loop means it catches errors that a text-only assistant would miss.

Example: multi-stage Node.js Dockerfile

Docker Compose generation

Claude Code excels at generating docker-compose configurations for complex stacks. It understands service dependencies, health checks, volume mounts, and network isolation. Ask it to add a service and it will wire everything together, including environment variables and proper startup ordering with depends_on conditions.

Can Claude Code run Docker commands?+

Yes. Claude Code executes docker build, docker run, docker-compose up, and any other Docker CLI command directly in your terminal. It uses the output to verify its changes work.

Does Claude Code support Docker Compose v2?+

Yes. Claude Code generates docker-compose.yml files compatible with Docker Compose v2 syntax and can migrate v1 files to v2 format.

Can Claude Code work with private registries?+

Yes. If your Docker CLI is authenticated to a private registry (via docker login), Claude Code can pull base images and push built images to that registry.

Related tools

Claude Code →Codex CLI →

Master Claude Code in days, not months

37 hands-on lessons from beginner to CI/CD automation. Module 1 is free.

START FREE →

← ALL INTEGRATIONS