← 返回主页
一键启动 · macOS / Windows

Claude Code 桌面快捷启动

一键启动 Claude Code 对话框，自动进入工作目录。
无需每次打开终端输命令。

1 工作原理

macOS

Claude Code.app → osascript → Terminal.app → Claude Code

双击 Claude Code.app → 通过 osascript 打开 Terminal，自动设置环境变量并运行 Claude Code。
拖入 Dock 可永久保留，点击即用。

Windows

claude-desktop.bat → Windows Terminal → Claude Code

双击 .bat 脚本 → 自动检测 Windows Terminal → 进入项目目录启动 Claude Code。

2 macOS：拖入 Dock 一键启动

找到 Claude Code.app 已在仓库中

克隆仓库后，在 tools/Claude Code.app 即可找到启动器：

GitHub: tools/Claude Code.app

拖入程序坞 推荐

将 Claude Code.app 从 Finder 拖到 Dock 右侧即可。或者按住 Option 键拖动到桌面创建快捷方式。

点击启动 完成

点击 Dock 上的 Claude Code 图标，Terminal 自动打开并进入项目目录，即可开始对话。

首次打开时系统可能提示"无法验证开发者"→ 在 Finder 中右键 .app → 选「打开」→ 确认。只需一次。

3 Windows：bat 启动脚本

在项目目录 tools/ 中创建 claude-desktop.bat，写入以下内容：

@echo off set WORK_DIR=%~dp0.. set CLAUDE_CODE_ENTRYPOINT=cli cd /d "%WORK_DIR%" where wt.exe >nul 2>&1 if %errorlevel% equ 0 ( start "" wt.exe -d "%WORK_DIR%" cmd /k "set CLAUDE_CODE_ENTRYPOINT=cli && claude --dangerously-skip-permissions --no-chrome" exit /b ) claude --dangerously-skip-permissions --no-chrome

双击 claude-desktop.bat 即可启动。右键 → 发送到桌面可创建快捷方式。

参数说明：--dangerously-skip-permissions 跳过每次启动时的权限确认弹窗（信任当前目录）；--no-chrome 禁用 Chrome DevTools 远程调试，减少不必要的端口监听和资源占用。

4 常见问题

⚠ macOS：点击图标后提示"claude 命令未找到"

原因： ~/.local/bin 不在默认 PATH 中。

解决： .app 的 launcher 已内置 PATH 扩展。如果仍有问题，确认 ~/.zshrc 包含 export PATH="$HOME/.local/bin:$PATH"。

⚠ macOS：Terminal 一闪而过

原因： claude 未安装或 PATH 未配置。

解决： 在终端手动输入 claude --version 确认已安装。如用 brew 安装，确认 /opt/homebrew/bin 在 PATH 中。

⚠ Windows：双击后弹出旧式黑窗口

原因： 系统没有安装 Windows Terminal。

解决： Microsoft Store 搜索"Windows Terminal"安装（免费），然后重新双击 bat。

⚙️ 可选配置

配置代理

如果网络需要代理访问 API：

macOS：编辑 .app 内 Contents/MacOS/launcher，在 export PATH 后加：

export HTTPS_PROXY="http://127.0.0.1:7897"

Windows：编辑 bat，在 set CLAUDE_CODE_ENTRYPOINT=cli 后加：

set HTTPS_PROXY=http://127.0.0.1:7897

想用 iTerm2 代替自带终端

编辑 Claude Code.app/Contents/MacOS/launcher，将最后一行的 Terminal 替换为 iTerm 即可。

🔗 相关链接（GitHub）

启动器tools/Claude Code.app
项目仓库github.com/LiHongwei-cn/lihongwei-cn
本页被阅读 ... 次
页面源码 ↗