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 Settings > Tweak Store를 엽니다.

2. Claude Session Title을 찾아 Install을 선택합니다.

3. Claude Desktop을 다시 시작합니다.

Store 페이지를 사용하여 Tweak을 업데이트합니다. Settings > Tweaks를 사용하여 활성화 또는 비활성화합니다. Store 복사본을 제거하려면 비활성화하고, Claude Desktop을 종료한 다음, Open Tweaks Folder를 선택하고, 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

스크립트는 실제 디렉터리, 심볼릭 링크 또는 지원되지 않는 reparse point를 대체하지 않습니다. 제거 시 다른 소스를 가리키는 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 설정, 경로, hooks, IPC 또는 Tweak 파일 시스템 데이터를 읽거나 쓰지 않습니다. MCP 서버는 메모리에 호스팅됩니다.

• Runtime 0.2.9는 이 릴리스에서 사용하는 UUID-to-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 라이선스