Claude Code Share

把本地 Claude Code 项目分享到局域网的工具。局域网用户可以通过浏览器与 Claude Code 协同开发，并管理项目文件。

功能

• 实时对话 — 局域网用户通过浏览器与 Claude Code 实时对话，AI 在项目目录中执行
• 文件浏览器 — 完整的项目文件树，支持展开/折叠
• 文件查看/编辑 — 右侧面板查看和编辑文件，实时保存
• 批量上传 — 拖拽上传多个文件，可指定目标目录
• 批量下载 — 勾选文件后打包下载为 ZIP
• 权限管理 — 支持通配符规则，精确控制哪些文件可被用户或 AI 修改
• 实时同步 — 文件变更（包括 AI 修改）实时推送到所有客户端

安装

cd claude-code-share
npm install

依赖

• Node.js 18+
• Claude Code (npm install -g @anthropic-ai/claude-code)

使用

基本用法

# 分享当前目录
node server/index.js

# 分享指定项目目录
node server/index.js /path/to/your/project

# 指定端口
node server/index.js /path/to/your/project --port 8080

全局安装（可选）

npm link
claude-share /path/to/project --port 7788

访问

启动后终端会显示访问地址：

╔════════════════════════════════════════╗
║      Claude Code Share Server          ║
╠════════════════════════════════════════╣
║  项目目录: /path/to/project
║  本地访问: http://localhost:7788
║  局域网:   http://192.168.1.100:7788
╚════════════════════════════════════════╝

局域网内的用户直接访问显示的局域网地址即可。

权限管理

在界面右上角点击 ⊕ 打开权限管理面板。

支持通配符规则（基于 minimatch）：

模式	说明
.env	精确匹配 .env 文件
**/*.lock	所有 lock 文件
src/config.js	指定路径的文件
secrets/**	secrets 目录下所有文件

每条规则可独立设置：

• 用户可改 — 局域网用户是否可以修改/删除
• AI 可改 — Claude 是否可以修改（通过系统提示控制）

默认受保护文件：.env、.env.*、**/*.key、**/*.pem

安全说明

⚠️ 此工具设计用于受信任的局域网环境（家庭网络、公司内网等）。 不建议将服务暴露到公网，否则任何人都可以操控你的项目文件和执行 AI 命令。

建议：

• 仅在局域网内使用
• 及时设置敏感文件的权限规则
• 不分享含有生产密钥的项目

技术架构

claude-code-share/
├── server/
│   ├── index.js        # Express + WebSocket 服务器
│   ├── config.js       # 配置解析
│   └── permissions.js  # 权限管理（minimatch 通配符）
├── public/
│   ├── index.html      # 单页应用
│   ├── css/style.css   # UI 样式
│   └── js/app.js       # 前端逻辑
├── bin/
│   └── claude-share.js # CLI 入口
└── permissions.json    # 权限规则持久化（自动生成）

• 后端: Node.js + Express + ws (WebSocket)
• 前端: 原生 HTML/CSS/JS，无框架依赖
• Claude 集成: 通过 claude --print --output-format stream-json 与 Claude Code CLI 通信
• 文件监听: chokidar 监听文件变更，实时通知客户端