Claude++ 的 Claude 会话标题

简体中文

仅在用户明确要求时重命名 Claude Desktop 会话。此仅限 Main 的 Tweak 适用于 Claude Desktop；它不会向终端 Claude Code 添加工具，也没有 Renderer 设置页面。

要求

• Windows 10 或更新版本。

• 带有 Claude++ Runtime 0.2.9 或更新版本的 Claude Desktop。

Tweak Store 用户不需要 Node.js 或 PowerShell。源码开发需要 Node.js 24 或更新版本，以及 PowerShell 7 或更新版本（pwsh）。

Related MCP server: Claude Desktop Extension

安装和卸载

推荐的安装路径是 Claude++ 经过审核的 Tweak Store：

1. 打开 Claude Desktop 设置 > Tweak Store。

2. 找到 Claude Session Title 并选择 安装。

3. 重启 Claude Desktop。

使用 Store 页面更新 Tweak。使用 设置 > Tweaks 启用或禁用它。要卸载 Store 副本，请禁用它，退出 Claude Desktop，选择 打开 Tweaks 文件夹，删除 com.kpk.claude-session-title，然后重启 Claude Desktop。

源码开发安装

对于受信任的源码检出，仅创建此 Claude++ Tweak Junction，然后重启 Claude Desktop：

pwsh -NoProfile -File .\Inject-ClaudePlusPlus.ps1 -CheckOnly
pwsh -NoProfile -File .\Inject-ClaudePlusPlus.ps1

仅删除此开发 Junction，然后重启 Claude Desktop：

pwsh -NoProfile -File .\Uninject-ClaudePlusPlus.ps1 -CheckOnly
pwsh -NoProfile -File .\Uninject-ClaudePlusPlus.ps1

脚本拒绝替换真实目录、符号链接或不支持的重解析点。卸载也拒绝删除指向其他源的 Junction。此路径用于源码开发，而非正常的 Store 安装。

工具契约

该 Tweak 仅注册一个 Main MCP 服务器，并暴露：

mcp__claudepp_session_title__set_session_title(
  session_id: string,
  title: string
)

两个参数都是必需的。session_id 始终是显式目标。它可以是 Desktop local_* 管理器键，或对话中暴露的 Claude Code 会话 UUID。该 Tweak 不会重写 ID；它会将两个字符串和真实的 MCP 调用上下文转发给 Runtime。Runtime 0.2.9 将 Claude Code UUID 解析为其唯一的实时 Desktop 会话，并在更新之前验证生成的 local_* 管理器键。对于 Claude Desktop 已知的其他会话的显式 ID 仍然支持。未知或模糊的 ID 将被拒绝。成功响应标识请求的会话 ID，但绝不重复标题文本。

行为和兼容性

• Claude Desktop 将会话元数据中的用户标题持久化。该标题在重启后仍然保留，直到再次重命名。

• 该 Tweak 仅使用 Claude++ 的权限限定 Main API。它不读取或写入 Claude MCP 配置、.mcp.json、Claude 设置、路由、钩子、IPC 或 Tweak 文件系统数据。其 MCP 服务器托管在内存中。

• Runtime 0.2.9 恰好是最低版本，因为它提供了此版本使用的 UUID 到 local_* 的解析，以及 api.mcp 和 api.claude.sessionTitles。如果任一功能缺失，启动将失败并显示升级指南。

• Claude++ 的私有 Claude Desktop 适配器是版本锁定的。Runtime 0.2.9 仅支持该 Runtime 声明的 Desktop 版本和私有模块形状。不支持的 Desktop 版本或私有形状将安全失败：Claude 仍然可用，但此工具不会被注入，也没有写入配置的回退方案。

开发

运行独立和 Junction 测试：

npm test
npm run test:windows

针对 Claude++ 0.2.9 或更新版本的源码检出进行验证：

$TweakRoot = (Get-Location).Path
$ClaudePlusPlusRoot = (Resolve-Path ..\claude-plusplus).Path
Set-Location $ClaudePlusPlusRoot
node --import tsx `
  (Join-Path $TweakRoot "scripts/compatibility/validate-claudeplusplus.mjs") `
  $ClaudePlusPlusRoot $TweakRoot

预期输出（runtime 是经过测试的源码检出版本）：

claudeplusplus-compatibility=passed runtime=<host-version> tweak=0.1.2

许可证

MIT 许可证