---
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` 参数匹配