← 返回主页
一键启动 · 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
全局规范一套规范部署到所有 AI Agent（6 Agent 适配）
Hermes Hermes Agent 一键启动器
项目仓库github.com/LiHongwei-cn/lihongwei-cn
本页被阅读 ... 次