Docker Claude Code Setup / Docker 环境部署 Claude Code#

Complete guide for deploying Claude Code in Docker containers with web terminal access and persistent sessions.

在 Docker 容器中完整部署 Claude Code 的指南，支持 Web 终端访问和会话持久化。

Quick Start / 快速开始#

1. Install Claude Code / 安装 Claude Code#

bash

# Install Node.js if needed / 如需要先安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt-get install -y nodejs

# Install Claude Code / 安装 Claude Code
npm install -g @anthropic-ai/claude-code

See references/claude-code-installation.md for detailed configuration.

详细配置见 references/claude-code-installation.md。

2. Install ttyd + tmux / 安装 ttyd + tmux#

bash

# Install packages / 安装软件包
apt-get update && apt-get install -y ttyd tmux

# Run setup script / 运行启动脚本
bash scripts/start-ttyd.sh 6080

Access at http://localhost:6080 - sessions persist after browser close!

访问 http://localhost:6080 - 关闭浏览器后会话保持！

See references/ttyd-tmux-setup.md for configuration details.

配置详情见 references/ttyd-tmux-setup.md。

3. Install acpx (Optional) / 安装 acpx (可选)#

bash

# Install acpx / 安装 acpx
bash scripts/install-acpx.sh

# Usage / 使用
acpx claude-code "your task"

See references/acpx-setup.md for multi-agent configuration.

多代理配置见 references/acpx-setup.md。

4. Configure API / 配置 API#

bash

# Set environment variables / 设置环境变量
export ANTHROPIC_API_KEY="your-api-key"
export ANTHROPIC_BASE_URL="https://api.example.com/v1"  # Optional / 可选
export ANTHROPIC_MODEL="model-name"  # Optional / 可选

# Start Claude Code / 启动 Claude Code
claude

See references/api-configuration.md for provider-specific settings.

各提供商配置见 references/api-configuration.md。

Docker Persistence / Docker 持久化#

In Docker containers, map config directories to persistent storage:

在 Docker 容器中，将配置目录映射到持久化存储：

bash

# Create persistent directories / 创建持久化目录
mkdir -p ~/workspace/claude-code/.claude
mkdir -p ~/workspace/.acpx
mkdir -p ~/workspace/.gradle  # For Android projects

# Create symlinks / 创建符号链接
ln -sf ~/workspace/claude-code/.claude ~/.claude
ln -sf ~/workspace/.acpx ~/.acpx
ln -sf ~/workspace/.gradle ~/.gradle

Architecture Overview / 架构概览#

text

┌─────────────────────────────────────────────────┐
│                   Web Browser                    │
│              http://HOST:6080                   │
└─────────────────────┬───────────────────────────┘
                      │
┌─────────────────────▼───────────────────────────┐
│                    ttyd                          │
│            (Web Terminal Server)                │
└─────────────────────┬───────────────────────────┘
                      │
┌─────────────────────▼───────────────────────────┐
│                   tmux                           │
│      (Session Persistence Layer)                │
│    - Survives browser close                     │
│    - Multiple windows/panes                     │
│    - Mouse scroll support                       │
└─────────────────────┬───────────────────────────┘
                      │
┌─────────────────────▼───────────────────────────┐
│                Claude Code                       │
│          (AI Coding Assistant)                  │
│    - Multiple API providers                     │
│    - Project-level instructions (CLAUDE.md)     │
└─────────────────────────────────────────────────┘

Scripts / 脚本#

ScriptDescriptionscripts/start-ttyd.shStart ttyd + tmux web terminalscripts/install-acpx.shInstall acpx multi-agent tool脚本说明scripts/start-ttyd.sh启动 ttyd + tmux Web 终端scripts/install-acpx.sh安装 acpx 多代理工具

Reference Documents / 参考文档#

DocumentContentclaude-code-installation.mdClaude Code installation and configurationttyd-tmux-setup.mdWeb terminal and session persistenceacpx-setup.mdMulti-agent tool configurationapi-configuration.mdAPI provider settings文档内容claude-code-installation.mdClaude Code 安装与配置ttyd-tmux-setup.mdWeb 终端与会话持久化acpx-setup.md多代理工具配置api-configuration.mdAPI 提供商设置

tmux Quick Reference / tmux 快捷键#

ShortcutActionCtrl+B DDetach (keep session running)Ctrl+B CNew windowCtrl+B N/PNext/Previous windowMouse scrollView history快捷键功能Ctrl+B D断开 (会话保持运行)Ctrl+B C新建窗口Ctrl+B N/P下一个/上一个窗口鼠标滚轮查看历史