一、项目简介

随着 AI 编程工具的发展，Claude Code 已成为开发者常用的智能编程助手。

但原生 Claude Code 主要基于终端使用，对新手不够友好。

为了解决这个问题，社区推出了多个 Web UI 版本，其中 host1syan/claude-cn 就是一个基于 Docker 的 Claude Code 在线网页版方案，可以让你直接在浏览器中使用 Claude Code。

👉 核心特点：

• 一键 Docker 部署
• 浏览器访问 Claude Code
• 无需本地复杂环境配置
• 支持远程服务器运行
• 更适合新手与轻量使用场景

---

二、项目架构说明

该项目本质是：

Claude Code CLI + Web UI + Docker 容器封装

可以理解为：

浏览器（Web UI）
        ↓
后端服务（Node / Web Server）
        ↓
Claude Code CLI
        ↓
Docker 容器环境

这种结构的好处是：

• 前后端隔离
• 环境统一
• 适合部署到 VPS / NAS / 云服务器

---

三、环境要求

在安装前，你需要：

• Linux / Windows / macOS（推荐 Linux 服务器）
• 已安装 Docker
• 至少 2GB 内存（推荐 4GB+）
• 可访问外网（用于 Claude API）

---

四、Docker 一键安装

1. 拉取镜像

docker pull host1syan/claude-cn

---

2. 启动容器

docker run -d \
  --name claude-cn \
  -p 3000:3000 \
  -v claude-data:/app/data \
  host1syan/claude-cn

---

3. 访问 Web UI

启动成功后，在浏览器打开：

http://localhost:3000

如果是服务器部署：

http://你的服务器IP:3000

---

五、推荐 Docker Compose 部署（更稳定）

如果你是长期使用，建议用 Compose：

version: "3"

services:
  claude-cn:
    image: host1syan/claude-cn
    container_name: claude-cn
    ports:
      - "3000:3000"
    restart: unless-stopped
    volumes:
      - claude_data:/app/data

volumes:
  claude_data:

启动：

docker compose up -d

---

六、Claude Code Web 使用方式

部署完成后，你可以在浏览器中：

1. 输入 API Key

首次使用需要配置：

• Anthropic API Key
• 或 Claude Pro / Max 账号授权（视项目支持情况）

---

2. 直接开始编程

支持功能包括：

• 代码生成
• 项目重构
• Bug 修复
• 文件读取与编辑
• Shell 命令执行（部分版本支持）

---

3. 示例使用场景

生成代码

帮我写一个 Node.js Express 登录系统

修复代码

帮我修复这个 Python 报错

生成项目结构

帮我设计一个博客系统后端架构

---

七、端口与安全建议

如果你部署在服务器上，建议：

1. 修改端口

-p 8080:3000

访问：

http://IP:8080

---

2. 配合 Nginx 反代（推荐）

用于绑定域名 + HTTPS：

claude.yourdomain.com

---

3. 安全建议

• 不要暴露 API Key 到前端
• 建议加访问密码
• 生产环境建议 HTTPS

---

八、常见问题（FAQ）

Q1：打不开页面？

检查：

• Docker 是否启动
• 端口是否开放
• 防火墙是否阻止

---

Q2：提示无法调用 Claude？

可能原因：

• API Key 未配置
• 网络无法访问 Anthropic
• Token 过期

---

Q3：能否多用户使用？

取决于版本：

• 单用户：默认支持
• 多用户：需要额外扩展或代理

---

九、项目优势总结

相比传统 Claude Code：

---

十、总结

host1syan/claude-cn 提供了一个非常实用的 Claude Code Web 化方案，让 AI 编程从“命令行工具”变成“可视化网页工具”。

对于：

• 想快速体验 Claude Code
• 不想折腾终端环境
• 想部署 AI 编程平台

这个项目非常适合。