sxwins/claude-code

Claude Code Docker环境

基于Ubuntu 24.04的Docker容器环境，专为安全持久地运行Claude Code v2.1.91设计。

特性

• 基于Ubuntu 24.04，以非root用户（ubuntu，uid=1000）运行
• 预安装Node.js 18、Python 3.12和uv包管理器
• 预安装Claude Code v2.1.91，支持--dangerously-skip-permissions模式，允许Claude Code无需逐步确认即可自主执行
• 通过本地目录映射持久化配置文件，容器重建后配置不会丢失
• 工作目录/app映射到本地workspace/，实现代码实时同步
• 通过host.docker.internal访问主机服务

目录结构

claude-docker/
├── docker-compose.yml
├── workspace/          # 工作目录，映射到容器内的/app
└── claude-config/
    ├── .claude/        # Claude Code全局配置、内存和历史记录
    └── claude.json     # Claude Code凭据和偏好设置

快速开始

1. 创建所需的目录结构

bash
mkdir -p claude-config/.claude

创建claude-config/claude.json文件，内容如下：

json
{
  "numStartups": 0,
  "theme": "dark",
  "preferredNotifChannel": "auto",
  "verbose": false,
  "editorMode": "normal",
  "autoCompactEnabled": true,
  "showTurnDuration": true,
  "hasSeenTasksHint": false,
  "hasUsedStash": false,
  "hasUsedBackgroundTask": false,
  "queuedCommandUpHintCount": 0,
  "diffTool": "auto",
  "customApiKeyResponses": {
    "approved": [],
    "rejected": []
  },
  "env": {},
  "tipsHistory": {},
  "memoryUsageCount": 0,
  "promptQueueUseCount": 0,
  "btwUseCount": 0,
  "todoFeatureEnabled": true,
  "showExpandedTodos": false,
  "messageIdleNotifThresholdMs": 60000,
  "autoConnectIde": false,
  "autoInstallIdeExtension": true,
  "fileCheckpointingEnabled": true,
  "terminalProgressBarEnabled": true,
  "cachedStatsigGates": {},
  "cachedDynamicConfigs": {},
  "cachedGrowthBookFeatures": {},
  "respectGitignore": true,
  "copyFullResponse": false
}

2. 创建docker-compose.yml

yaml
services:
  claude-code:
    image: sxwins/claude-code:v2.1.91
    stdin_open: true
    tty: true
    working_dir: /app
    user: "1000:1000"                          # 内置的ubuntu用户
    extra_hosts:
      - "host.docker.internal:host-gateway"    # 映射主机地址
    volumes:
      - ./workspace:/app
      - ./claude-config/.claude:/home/ubuntu/.claude
      - ./claude-config/claude.json:/home/ubuntu/.claude.json

3. 启动容器

bash
docker compose up -d

4. 进入容器并启动Claude Code

bash
docker compose exec claude-code bash

# 以完全自主模式启动Claude Code
ubuntu@<container-id>:/app$ claude --dangerously-skip-permissions

目录权限

Windows

无需操作，Docker Desktop会自动处理权限。

Linux — 单用户服务器，或uid=1000是您的用户

bash
sudo chown -R 1000:1000 ./claude-config/

Linux — 多用户服务器，其中uid=1000不是您的用户

首先检查您的uid/gid：

bash
id

然后修改Dockerfile以匹配您的uid/gid并重建：

dockerfile
RUN usermod -u <your-uid> ubuntu && groupmod -g <your-gid> ubuntu

bash
docker compose build

为什么在Docker中运行Claude Code

在Docker容器中运行Claude Code可将其文件操作和命令执行与主机隔离。这使您能够安全地使用高级权限模式，同时保护本地系统 - 通过目录映射完全访问项目代码。

要求

• Docker Desktop
• 有效的Anthropic API密钥或Claude Pro/Max订阅

源文件

Dockerfile

dockerfile
FROM ubuntu:24.04

ENV DEBIAN_FRONTEND=noninteractive

RUN apt-get update && apt-get install -y \
    curl \
    git \
    python3.12 \
    python3.12-venv \
    python3-pip \
    sudo \
    gosu \
    && rm -rf /var/lib/apt/lists/*

RUN curl -fsSL [***] | bash - \
    && apt-get install -y nodejs \
    && rm -rf /var/lib/apt/lists/*

RUN curl -LsSf [***] | sh
RUN cp /root/.local/bin/uv /usr/local/bin/ \
    && cp /root/.local/bin/uvx /usr/local/bin/ 2>/dev/null || true

RUN npm install -g @anthropic-ai/claude-code

RUN echo "ubuntu ALL=(ALL) NOPASSWD:ALL" > /etc/sudoers.d/ubuntu \
    && chmod 0440 /etc/sudoers.d/ubuntu

WORKDIR /app
CMD ["bash"]