100 lines
3.5 KiB
Markdown
100 lines
3.5 KiB
Markdown
|
---
|
|||
|
|
tags:
|
|||
|
|
- windows
|
|||
|
|
- claude-code
|
|||
|
|
- tooling
|
|||
|
|
created: 2026-05-31
|
|||
|
|
---
|
|||
|
|
# Windows Terminal 快捷方式启动 Claude Code 项目
|
|||
|
|
|
|||
|
|
## 原理
|
|||
|
|
|
|||
|
|
桌面快捷方式（`.lnk`）先启动 Windows Terminal，再由 Windows Terminal 的 Profile 定义工作目录和启动命令，最终自动进入指定项目的 Claude Code 会话。
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
桌面快捷方式 (.lnk)
|
|||
|
|
→ wt.exe -p "ProfileName"
|
|||
|
|
→ Windows Terminal 读取 settings.json 中对应 Profile
|
|||
|
|
→ cmd.exe /k "cd 项目目录 && claude --dangerously-skip-permissions"
|
|||
|
|
→ Claude Code 启动，进入交互会话
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 两层结构
|
|||
|
|
|
|||
|
|
### 1. Windows Terminal Profile（settings.json）
|
|||
|
|
|
|||
|
|
位置：`%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json`
|
|||
|
|
|
|||
|
|
每个项目一个 Profile，例如：
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"guid": "{30e2bee9-2311-49a4-9798-fe50e1fb872e}",
|
|||
|
|
"name": "AIDM",
|
|||
|
|
"commandline": "cmd.exe /k \"cd /d D:\\MatrixTA\\AIGameDev\\AIDM && set CLAUDE_CODE_DISABLE_TERMINAL_TITLE=1 && claude --dangerously-skip-permissions\"",
|
|||
|
|
"startingDirectory": "D:\\MatrixTA\\AIGameDev\\AIDM",
|
|||
|
|
"tabColor": "#16A34A",
|
|||
|
|
"suppressApplicationTitle": true,
|
|||
|
|
"icon": "🎮",
|
|||
|
|
"hidden": false
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
字段说明：
|
|||
|
|
|
|||
|
|
| 字段 | 作用 |
|
|||
|
|
|------|------|
|
|||
|
|
| `guid` | 唯一标识，内部匹配用 |
|
|||
|
|
| `name` | 显示在下拉菜单和标签页标题，也是 `-p` 参数的匹配值 |
|
|||
|
|
| `commandline` | 实际执行的命令，通过 `cmd.exe /k` 保证窗口保持 |
|
|||
|
|
| `startingDirectory` | 初始工作目录 |
|
|||
|
|
| `tabColor` | 标签页颜色，方便区分项目 |
|
|||
|
|
| `suppressApplicationTitle` | 禁止应用修改终端标题 |
|
|||
|
|
| `icon` | 标签页图标（emoji） |
|
|||
|
|
|
|||
|
|
### 2. 桌面快捷方式（.lnk）
|
|||
|
|
|
|||
|
|
PowerShell 创建方式：
|
|||
|
|
|
|||
|
|
```powershell
|
|||
|
|
$shell = New-Object -ComObject WScript.Shell
|
|||
|
|
$desktop = [Environment]::GetFolderPath('Desktop')
|
|||
|
|
$shortcut = $shell.CreateShortcut("$desktop\AIDM.lnk")
|
|||
|
|
$shortcut.TargetPath = "C:\Users\loujiajie\AppData\Local\Microsoft\WindowsApps\wt.exe"
|
|||
|
|
$shortcut.Arguments = '-p "AIDM"'
|
|||
|
|
$shortcut.WorkingDirectory = "D:\MatrixTA\AIGameDev\AIDM"
|
|||
|
|
$shortcut.Save()
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
字段说明：
|
|||
|
|
|
|||
|
|
| 属性 | 值 | 说明 |
|
|||
|
|
|------|-----|------|
|
|||
|
|
| `TargetPath` | `wt.exe` 完整路径 | Windows Terminal 可执行文件 |
|
|||
|
|
| `Arguments` | `-p "ProfileName"` | 匹配 settings.json 中 Profile 的 `name` 字段 |
|
|||
|
|
| `WorkingDirectory` | 项目目录 | 与 Profile 中的 `startingDirectory` 一致 |
|
|||
|
|
|
|||
|
|
## 新增项目的步骤
|
|||
|
|
|
|||
|
|
> [!note] 完整流程
|
|||
|
|
> 1. 在 `settings.json` 的 `profiles.list` 数组中添加新 Profile
|
|||
|
|
> 2. 生成新的 GUID（PowerShell: `[guid]::NewGuid()`）
|
|||
|
|
> 3. 创建桌面 `.lnk` 快捷方式指向 `wt.exe -p "新Profile名"`
|
|||
|
|
|
|||
|
|
## 已有项目 Profile 一览
|
|||
|
|
|
|||
|
|
| 项目 | Tab 颜色 | 图标 | 目录 |
|
|||
|
|
|------|----------|------|------|
|
|||
|
|
| CharacterMaker | `#1E3CB4` (蓝) | 🔥 | `D:\AI\Website\CharacterMaker` |
|
|||
|
|
| AIDM | `#16A34A` (绿) | 🎮 | `D:\MatrixTA\AIGameDev\AIDM` |
|
|||
|
|
| POPODocs | `#0078D7` (蓝) | 📄 | `D:\AI\Skill\MatrixAITA-POPODocs-Skill` |
|
|||
|
|
| NeteaseAITA_Artlib | `#808080` (灰) | 🎨 | `D:\AI\Website\NeteaseAITA_Artlib` |
|
|||
|
|
|
|||
|
|
## 关键细节
|
|||
|
|
|
|||
|
|
- **`cmd.exe /k`**：执行完后续命令后保持窗口不关闭，用户可继续交互
|
|||
|
|
- **`--dangerously-skip-permissions`**：跳过 Claude Code 的权限提示，适合本地开发
|
|||
|
|
- **`CLAUDE_CODE_DISABLE_TERMINAL_TITLE=1`**：禁止 Claude Code 修改终端标题，保持 Profile 名称显示
|
|||
|
|
- **`suppressApplicationTitle: true`**：配合上一条，双重保障标题不被覆盖
|
|||
|
|
- **GUID 必须唯一**：每个 Profile 的 `guid` 用于内部匹配，`name` 用于 `-p` 参数匹配
|