cc-haha/docs/desktop/05-macos-alias.md

macOS Alias 配置

目标：在 macOS 上通过一个很短的命令启动 Claude Code Haha 桌面端。

先说结论

如果你已经把全局脚本安装到了 PATH（例如 ~/.local/bin/cch-desktop），其实不一定还需要 alias。

最推荐的直接命令是：

cch-desktop

只有在你想要一个更短的命令（例如 cch）时，才建议再配 alias。

前提

确保这台 Mac 上已经有：

• Bun
• Rust / Cargo
• 项目代码
• 可用的全局命令 cch-desktop，或者你知道项目根目录路径

推荐 alias

打开 ~/.zshrc：

nano ~/.zshrc

方案 A：给全局脚本再包一层短别名

如果你已经装好了 cch-desktop，推荐加这行：

alias cch='cch-desktop'

以后直接运行：

cch

方案 B：固定某个仓库路径

如果你不想依赖全局脚本，也可以直接绑到仓库：

alias cch-desktop='cd ~/projects/cc-haha-main && bun run desktop:dev'

保存后重新加载：

source ~/.zshrc

使用方式

如果你配置的是方案 A

cch

如果你配置的是方案 B

cch-desktop

如果你的项目路径不同

把 alias 里的路径换成你自己的项目根目录即可，例如：

alias cch-desktop='cd /Users/yourname/work/cc-haha-main && bun run desktop:dev'

常见问题

1. command not found: cch 或 command not found: cch-desktop

通常是 ~/.zshrc 还没重新加载：

source ~/.zshrc

如果是全局脚本方式，还要确认它已经装到 PATH 中，例如：

which cch-desktop

2. 提示找不到 bun

先确认 Bun 已安装并在 PATH 中：

bun --version

3. 启动后打开了浏览器页但没弹桌面窗口

正确入口是：

cch-desktop

或者：

bun run desktop:dev

最终要使用的是弹出的 Claude Code Haha 原生窗口，而不是直接使用 Vite 的网页地址。