1.1 迁移思路#

cmux 底层是 Ghostty，终端行为配置走 ~/.config/ghostty/config，外观/主题走 cmux 自身的主题系统。iTerm2 的配置存储在 ~/Library/Preferences/com.googlecode.iterm2.plist，需要提取关键值。

1.2 提取 iTerm2 关键配置#

通过读取 plist 文件获取：

关键发现：之前误以为 iTerm2 用的是 One Dark，实际提取 Ansi 色值后确认是 Dracula（#ff5555、#50fa7b、#bd93f9、#8be9fd 等）。

1.3 Ghostty 最终配置#

~/.config/ghostty/config：

1
font-family = Hack Nerd Font
2
font-size = 13
3
theme = Dracula
4
scrollback-limit = 10000
5
split-divider-color = #3e4451
6
working-directory = ~/code
7
copy-on-select = clipboard
8

9
# Cursor (match iTerm2: no blink)
10
cursor-style = block
11
cursor-style-blink = false
12
cursor-color = #bbbbbb
13

14
# Background image
15
background-image = ~/Downloads/壁纸3/IMG_20250505_165711.jpg
16
background-image-opacity = 0.33
17
background-image-fit = stretch
18
background-opacity = 0.8
19

20
# Mouse
21
mouse-reporting = true
22

23
# Window
24
window-save-state = always

踩坑：

• background-opacity 与 background-image-opacity 是独立参数，前者控制终端整体透明度，后者控制背景图透明度。
• 背景图 opacity 从 0.05 调到 0.33 才看清，配合 background-opacity = 0.8 效果最佳。
• copy-on-select 的值要用 clipboard 而不是 true，后者在 macOS 上无效。

1.4 修改后无需重启#

编辑 ~/.config/ghostty/config 后，cmux 会自动热重载，无需重启终端。

2.1 已安装 Skill 列表#

1
# 在项目目录 ~/.claude/skills/ 下
2
cmux              # 核心窗口管理
3
cmux-browser      # 浏览器自动化
4
cmux-markdown     # Markdown 预览面板
5
cmux-debug-windows # 调试窗口（开发用）

安装方式：从 cmux 官网下载 skill 包，解压到 ~/.claude/skills/ 或项目 .claude/skills/ 目录。

2.2 cmux-browser 核心能力#

在 cmux 中打开浏览器 surface，支持完整的 DOM 操作：

1
# 打开网页（自动分屏）
2
cmux browser open https://example.com
3

4
# 获取页面可交互元素快照（含 ref）
5
cmux browser surface:2 snapshot --interactive
6

7
# 点击元素
8
cmux browser surface:2 click e47 --snapshot-after
9

10
# 填表
11
cmux browser surface:2 fill "#email" --text "ops@example.com"
12
cmux browser surface:2 select "#server" "10"
13

14
# 执行 JS
15
cmux browser surface:2 eval "document.title"
16

17
# 导航
18
cmux browser surface:2 navigate https://example.org

2.3 cmux-markdown#

在侧边栏打开实时渲染的 markdown 面板：

1
cmux markdown open plan.md

3.2 cmux.json 配置层级与优先级#

cmux 的设置分两层存储：

1. UI 直接修改 → 保存在 macOS UserDefaults（com.cmuxterm.app）内部存储
2. 手动编辑 cmux.json → 文件级管理，优先级更高

规则：cmux.json 中存在且未注释的设置会覆盖 UI 的值；删掉或注释则回退到 UI 存储的值。

建议把需要固定下来的配置都写到 cmux.json 里做版本管理，换机器或重装时能直接恢复。

3.3 当前完整配置#

~/.config/cmux/cmux.json：

1
{
2
  "$schema": "https://raw.githubusercontent.com/manaflow-ai/cmux/main/web/data/cmux.schema.json",
3
  "schemaVersion": 1,
4

5
  "app": {
6
    "appearance": "system",
7
    "appIcon": "automatic",
8
    "commandPaletteSearchesAllSurfaces": false,
9
    "focusPaneOnFirstClick": false,
10
    "keepWorkspaceOpenWhenClosingLastSurface": false,
11
    "language": "system",
12
    "minimalMode": true,
13
    "newWorkspacePlacement": "afterCurrent",
14
    "preferredEditor": "",
15
    "renameSelectsExistingName": true,
16
    "reorderOnNotification": true,
17
    "sendAnonymousTelemetry": true,
18
    "warnBeforeQuit": true,
19
  },
20

21
  "notifications": {
22
    "command": "",
23
    "customSoundFilePath": "",
24
    "dockBadge": true,
25
    "paneFlash": true,
26
    "showInMenuBar": true,
27
    "sound": "default",
28
    "unreadPaneRing": true,
29
  },
30

31
  "sidebar": {
32
    "branchLayout": "vertical",
33
    "hideAllDetails": false,
34
    "openPortLinksInCmuxBrowser": true,
35
    "openPullRequestLinksInCmuxBrowser": true,
36
    "showBranchDirectory": true,
37
    "showCustomMetadata": true,
38
    "showLog": true,
39
    "showNotificationMessage": true,
40
    "showPorts": true,
41
    "showProgress": true,
42
    "showPullRequests": true,
43
    "showSSH": true,
44
  },
45

46
  "sidebarAppearance": {
47
    "darkModeTintColor": null,
48
    "lightModeTintColor": null,
49
    "matchTerminalBackground": false,
50
    "tintColor": "#000000",
51
    "tintOpacity": 0.1555706521739131,
52
  },
53

54
  "automation": {
55
    "claudeBinaryPath": "",
56
    "claudeCodeIntegration": true,
57
    "portBase": 9100,
58
    "portRange": 10,
59
    "socketControlMode": "cmuxOnly",
60
    "socketPassword": "",
61
  },
62

63
  "browser": {
64
    "defaultSearchEngine": "google",
65
    "hostsToOpenInEmbeddedBrowser": [],
66
    "insecureHttpHostsAllowedInEmbeddedBrowser": [
67
      "localhost",
68
      "127.0.0.1",
69
      "::1",
70
      "0.0.0.0",
71
      "*.localtest.me",
72
    ],
73
    "interceptTerminalOpenCommandInCmuxBrowser": true,
74
    "openTerminalLinksInCmuxBrowser": true,
75
    "reactGrabVersion": "0.1.29",
76
    "showImportHintOnBlankTabs": true,
77
    "showSearchSuggestions": true,
78
    "theme": "system",
79
    "urlsToAlwaysOpenExternally": ["localhost"],
80
  },
81
}

3.4 关键设置说明#

编辑后重载：

1
cmux reload-config

4.1 Dock 功能概述#

Dock 是 cmux 的右侧边栏终端控制面板，可以把常用的 TUI 工具钉在右侧边栏，不占用主终端空间。

• 每个 Dock 面板都是一个独立的 Ghostty 终端实例
• 保持正常键盘行为（j/k、Ctrl-C 等）
• 命令退出后自动进入交互式 shell，方便后续操作

4.2 配置结构#

Dock 通过 JSON 配置文件管理，支持两层优先级：

优先级规则：项目级 > 全局。如果项目目录下存在 .cmux/dock.json，则忽略全局配置。

4.3 全局 Dock 配置#

~/.config/cmux/dock.json（个人全局）：

1
{
2
  "controls": [
3
    {
4
      "id": "git",
5
      "title": "Git",
6
      "command": "lazygit",
7
      "cwd": ".",
8
      "height": 400
9
    }
10
  ]
11
}

全局只保留 lazygit，因为其他功能（文件浏览、搜索）已经有左侧边栏常驻了。

4.4 字段说明#

1
{
2
  "controls": [
3
    {
4
      "id": "stable-unique-id", // 稳定唯一的标识符
5
      "title": "面板标题", // Dock 头部显示的标签
6
      "command": "要执行的命令", // 在登录 shell 中运行
7
      "cwd": ".", // 可选：工作目录
8
      "height": 400, // 可选：面板高度（points）
9
      "env": { "KEY": "value" } // 可选：环境变量（非机密）
10
    }
11
  ]
12
}

4.5 启用 Dock Beta 功能#

Dock 目前是 Beta 功能，需要先手动启用：

1. 进入 cmux 设置 → Beta Features
2. 打开 Dock 开关
3. 完全退出 cmux App，重新打开

踩坑：

• Dock 开关不在 cmux.json 里——这是 App 级别的 Beta 功能，无法通过配置文件开启
• 右侧边栏需要手动打开——按 Cmd+Opt+B 切换右侧边栏可见性，或 Cmd+Shift+P 打开命令面板搜索 “Show Sidebar Dock”
• 快捷键绑定——在 cmux.json 的 shortcuts.bindings 中添加：

  1
  "toggleFileExplorer": "cmd+opt+b",   // 右侧边栏开关
  2
  "focusRightSidebar": "cmd+shift+e"   // 聚焦右侧边栏

4.6 Trust Gate（信任确认）#

项目级 Dock 配置第一次使用时会弹出信任确认——因为项目配置能执行任意命令，cmux 做了安全检查。全局配置不会弹。

4.7 命令退出后的行为#

Dock 面板里的命令退出后（比如 lazygit 按了 q），面板不会消失，而是自动进入交互式 shell，可以继续操作或输入新命令。

5.1 需求分析#

手动兑换流程繁琐：

1. 打开 https://jsbt.thecm8.com/index/cdk/
2. 关闭公告弹窗
3. 选区服 → 填账号 → 点击获取角色
4. 选角色 → 填 CDK
5. 看验证码 → 输入 → 点击领取

前 4 步完全固定，可以自动化；第 5 步验证码需手动（OCR 识别率太低）。

5.2 技术方案#

• 页面自动化：cmux-browser API（open、click、fill、select、eval）
• 弹窗处理：snapshot 获取元素 ref，点击 Close
• 角色获取：点击”获取”后轮询 roles.options.length，再用 eval 遍历匹配角色名
• 验证码：脚本填完表单后退出，用户在浏览器面板手动输入

5.3 踩坑记录#

5.4 最终脚本#

claudecode/.claude/skills/cdk-exchanger/scripts/exchange.sh：

• 参数硬编码（十区 / 18507730419 / seeing / js2024666）
• 5 步自动化：打开页面 → 关弹窗 → 填表单 → 获取角色 → 提示手动完成
• 仅通过 /cdk-exchanger 命令触发

5.5 文件结构#

1
claudecode/.claude/skills/cdk-exchanger/
2
├── SKILL.md              # Skill 说明
3
└── scripts/
4
    └── exchange.sh       # 主脚本

7.1 现象#

迁移到 cmux 后发现 Lemon（腾讯柠檬清理）显示 cmux 内存占用高达 2-3 GB，而 iTerm2 仅 338 MB。产生疑问：cmux 本身是否比 iTerm2 更吃内存？

7.2 排查过程#

第一步：拆解 cmux 进程树

1
ps -eo pid,ppid,rss,comm | grep -E "cmux|claude"

发现 cmux 主进程本身只有 ~180 MB，但底下挂了多个 Claude Code 会话，每个 300-400 MB。

第二步：对比统计口径

关键发现：iTerm2 的 338 MB 只是 iTerm2 自身，Claude 进程挂在 tmux 名下，Lemon 不会把它们加在一起。

第三步：关掉自动挂载对比

将 automation.claudeCodeIntegration 从 true 改为 false：

• 之前：cmux 2-3 GB（含多个自动挂载的 Claude 会话）
• 之后：cmux ~1.2 GB（仅剩当前会话）

结论：内存高不是 cmux 本身的问题，而是 claudeCodeIntegration: true 时，每个新终端 tab 都会自动启动一个 Claude Code 进程。

7.3 隐藏的常驻进程#

排查中还发现一个不属于 cmux 但挂在 cmux 名下的进程：

1
PPID 11689 → /Users/xiangwang/.bun/bin/bun .../claude-mem/10.6.2/scripts/worker-service.cjs --daemon

这是 claude-mem MCP 插件的守护进程（常驻后台搜索服务），PID 88742，常驻内存 ~280 MB。它是 --daemon 模式，不会自动退出。

7.4 统计口径差异#

ps 统计的 cmux 直系子进程 ~1 GB，但 Lemon 显示 1.6-2 GB，差距来自：

cmux 基于 Metal GPU 加速，内嵌浏览器引擎、字体缓存等共享内存 ps 的 RSS 不计入，但系统级监控工具会算进去。

7.5 关键决策#

是否关掉 claudeCodeIntegration？

最终选择：改回 true。因为桌面通知和 Claude 完成任务的反馈对 workflow 更重要，内存开销是 Claude Code 本身特性，不是 cmux 的问题。

7.6 踩坑#

• Homebrew formula 版本滞后：brew info claude-code 显示 2.1.126，但实际 cmux 内置版本已是 2.1.138。Claude Code 不是通过 Homebrew 安装的，而是通过 cmux 内置的 /Applications/cmux.app/Contents/Resources/bin/claude。
• Agent View 需要 v2.1.139：当前 cmux 内置版本 2.1.138 尚不支持，需等 cmux App 更新。
• claude-mem 守护进程常驻：如果不需要跨会话记忆检索，可以在 /config 里移除 claude-mem MCP server 来释放 ~280 MB 内存。

7.7 经验#

1. cmux 自身内存并不高（~180 MB），高的是它集成的 AI 代理进程
2. 每个 Claude Code 会话 ~300-400 MB 是正常开销，跟终端无关
3. 监控工具的统计口径不同会导致认知偏差——Lemon 把 cmux 所有子孙进程都算到 cmux 头上，而 iTerm2 的 Claude 进程被 tmux 隔离了
4. 不要凭单一监控工具做判断，要结合 ps、top、Activity Monitor 多方验证