Myrlin-Workbook 是专为 Claude Code 设计的本地管理面板，它无需复杂配置，会自动发现并连接你电脑上所有 Claude Code 会话与项目。核心是：先装好 Claude Code → 再启动 Myrlin → 浏览器直接管理。

一、准备工作（必须）

确保 Claude Code CLI 已安装、登录、能正常运行：

# 安装（如未装）
npm install -g @anthropic/claude-code

# 登录授权
claude login

# 测试（能启动会话即正常）
claude

二、安装与启动 Myrlin-Workbook

方式1：快速体验（npx，无需安装）

npx myrlin-workbook gui

方式2：本地克隆（推荐，稳定）

git clone https://github.com/therealarthur/myrlin-workbook.git
cd myrlin-workbook
npm install
npm run gui

• 首次启动：控制台会输出随机密码（保存于 state/config.json）
• 自定义密码：

  # Bash/zsh
  CWM_PASSWORD=你的密码 npm run gui
  
  # PowerShell
  $env:CWM_PASSWORD="你的密码"; npm run gui
  

• 启动成功：浏览器自动打开 http://localhost:3456。

三、自动连接 Claude Code（核心原理）

Myrlin 会自动扫描 Claude Code 本地数据目录：

• macOS/Linux：~/.claude/
• Windows：%USERPROFILE%\.claude\
• 读取：projects/、sessions/、usage.jsonl（费用日志）

连接后功能：

1. 多会话管理：4分屏终端，同时控制多个 Claude Code 会话

2. 费用追踪：按会话/项目统计 Opus/Sonnet/Haiku 消耗

3. 冲突检测：多会话同时改同一文件时告警

4. 项目工作台：文档、看板、任务、规则、路线图

5. 会话模板：一键新建带上下文的标准会话

四、手机远程访问（关键！你要的场景）

1. 同一局域网（最简单）

• 电脑：查看本机内网 IP（ifconfig/ipconfig）
• 手机：浏览器访问 http://[电脑IP]:3456 → 输入控制台密码

2. 跨网络/外网（推荐：Tailscale）

1. 电脑+手机装 Tailscale（免费个人版）
2. 电脑获取 Tailscale IP（形如 100.x.x.x）
3. Myrlin 绑定所有网卡（允许外部访问）：

   # 启动时指定监听 0.0.0.0
   CWM_HOST=0.0.0.0 npm run gui
   

4. 手机：http://[电脑TailscaleIP]:3456 → 密码登录

3. 安全加固（建议）

# 强制密码 + 仅限本地
CWM_HOST=127.0.0.1 CWM_PASSWORD=强密码 npm run gui

# 外网仅用 Tailscale/WireGuard，不直接端口映射

五、常用操作（浏览器内）

• 新建会话：Workspace → New Session → 自动在后台启动 claude 命令
• 连接已有会话：左侧 Sessions 面板 → 点击直接接入
• 重启/停止：终端右上角菜单 → Restart / Stop
• 费用：顶部 Insights → 实时 Token/费用统计

六、常见问题

• 看不到会话
  1. 确认 Claude Code 已正常登录、至少启动过1次
  2. 重启 Myrlin：Ctrl+C → 重新 npm run gui
  3. 检查路径权限：Myrlin 需读 ~/.claude/
• 手机连不上
  1. 电脑防火墙放行 3456 端口
  2. 用 CWM_HOST=0.0.0.0 启动
  3. 优先用 Tailscale，避免公网端口暴露
• 修改端口

  CWM_PORT=5678 npm run gui