도움말

Claude Code Helper란 무엇인가요?

Claude Code Helper는 사용자 컴퓨터에 저장된 Claude Code 세션을 위한 데스크톱 뷰어입니다. Windows 및 WSL 내에서 세션을 찾아 하나의 검색 가능한 목록으로 표시하고, 각 대화를 읽고 내보낼 수 있는 채팅 형식으로 렌더링합니다.

Claude Code는 과거 세션을 숨겨진, 컴퓨터별 저장 위치에 보관하며, 이는 여러 곳에 분산되어 있습니다: Windows 저장소와 Claude를 실행하는 각 WSL(Windows Subsystem for Linux) 배포판 내의 별도 저장소입니다. 이들을 탐색하거나 다시 읽을 수 있는 내장된 방법은 없습니다. 이 앱은 그 관문입니다: 모든 저장소에서 해당 세션을 찾아내고, 각 세션의 출처를 태그하며, 제목과 대화록 부분을 자동으로 연결하고, 원본을 전혀 건드리지 않고 검색, 복사, 저장할 수 있는 깔끔한 채팅으로 각 대화를 보여줍니다.

이 앱으로 할 수 있는 네 가지는 다음과 같습니다: 세션 찾아보기, 대화록 읽기, 대화록 저장 또는 공유, 그리고 몇 가지 설정 조정입니다.

세션 찾아보기

왼쪽 창에는 이 컴퓨터에서 찾은 모든 Claude Code 세션이 최신순으로 나열됩니다. 각 항목은 세션의 제목, 실행된 프로젝트 폴더, 마지막으로 초점을 맞춘 시점, 그리고 출처를 나타내는 배지를 보여줍니다. 항목을 클릭하면 오른쪽에 해당 대화록이 열립니다.

세션과 대화록

세션은 하나의 Claude Code 대화입니다. 그 대화록은 그 안에서 말하고 행해진 모든 것의 전체 기록입니다. 이 두 가지는 사용자 컴퓨터에 별도로 저장됩니다: 세션의 제목과 기본 세부 정보는 한 곳에 있고, 대화록 자체는 다른 곳에 있습니다. 앱은 둘 다 읽고 공유 세션 ID로 일치시켜 목록과 읽을 수 있는 대화가 하나로 합쳐지도록 합니다.

사용자가 직접 이를 관리할 필요는 없습니다. 단 한 가지 이유 때문에 중요합니다: 세션은 해당 대화록을 실제로 찾을 수 있을 때만 목록에 표시됩니다. Claude Code가 오래된 대화록을 제거했다면(일정 시간이 지나면 삭제함), 읽을 것이 남아있지 않으므로 해당 세션은 빈 항목으로 표시되는 대신 목록에 나타나지 않습니다.

세션의 출처 — 소스 배지

모든 항목에는 해당 세션이 물리적으로 어디에 저장되어 있는지 알려주는 작은 소스 배지가 있습니다:

Windows — 세션이 Windows에서 Claude Code로 실행되었습니다.
배포판 이름 (예: Ubuntu) — 세션이 해당 WSL Linux 환경 내에서 실행되었습니다. Claude Code는 각 WSL 배포판 내에 완전히 별도의 저장소를 유지하며, 앱은 이 모든 저장소를 읽습니다.

동일한 컴퓨터는 서로 관련 없는 저장소에 두 가지 종류를 동시에 쉽게 보관할 수 있습니다. 배지는 항목이 어떤 환경에 속하는지 한눈에 알려줍니다. 현재 실행 중인 WSL 배포판만 스캔됩니다 — 중지된 배포판의 세션은 시작하는 즉시 나타납니다.

목록 위에 저장소당 하나의 소스 칩이 나타납니다 — Windows가 먼저, 그 다음 각 실행 중인 배포판입니다. 각 칩은 개수를 표시하고 해당 소스를 켜거나 끌 수 있어, 예를 들어 WSL 세션에만 목록의 초점을 맞추고 Windows 세션을 숨길 수 있습니다 (이 소스의 세션 표시 또는 숨기기).

활성, 보관됨, 손실된 세션

모든 세션은 세 가지 범주 중 하나에 속하며, 각 범주에는 자체 필터 칩과 목록 위에 실시간 개수가 표시됩니다:

활성 — 일반적인 현재 세션입니다.
보관됨 — Claude에서 보관한 세션입니다. 여기서는 여전히 완전히 읽을 수 있으며, 태그는 단순히 상태를 반영합니다.
손실됨 — 일치하는 Claude Desktop 항목이 없는 Windows 대화록입니다. 항목이 일반적으로 제목을 포함하기 때문에, 손실된 세션은 저장된 제목이 없으므로 앱은 대화의 첫 번째 메시지에서 제목을 복구합니다. 이것이 없으면 손실된 세션은 목록에 표시할 제목이 없어 보이지 않게 됩니다.

세 개의 칩은 대화를 찾을 때 각 범주를 표시하거나 숨기며, 그 개수는 현재 표시되는 소스를 반영합니다. 이런 방식으로 복구된 항목은 자체적인 손실됨 태그를 가지고 있습니다 — 이를 "여기의 제목은 원본이 아니라 재구성된 것입니다"라고 읽으십시오.

앱은 세션을 변경하지 않습니다

Claude Code Helper는 세션을 읽기만 합니다 — 세션을 쓰거나, 이름을 바꾸거나, 삭제하지 않습니다. 복사 및 내보내기는 새로운 클립보드 텍스트와 새로운 파일을 생성하며, 원본은 그대로 유지됩니다.

이것이 중요한 이유는 이 파일들이 Claude Code 자체의 실시간 작업 데이터이기 때문입니다. 파일을 변경하는 뷰어는 세션을 손상시킬 수 있습니다. 따라서 Claude에 대한 위험 없이 자유롭게 탐색하고 내보낼 수 있습니다.

한 가지 주의할 점: Claude가 해당 세션을 활발하게 사용 중일 때 세션의 기본 파일(예: 폴더에서 대화록 파일 표시로 접근하는 파일)을 수동으로 편집하지 마십시오 — 이는 Claude 몰래 실시간 데이터를 편집하는 것으로, 이 앱이 하는 일과는 다릅니다.

목록 필터링

목록 위의 필터 상자에 입력하기 시작하여 목록을 좁히십시오. 필터는 세션 제목과 프로젝트 경로를 모두 일치시키므로, 세션의 내용이나 실행된 폴더로 세션을 찾을 수 있습니다. 상자 안에 지우기 버튼이 나타나 한 번의 클릭으로 필터를 지우고 모든 것을 다시 볼 수 있습니다. 위에 설명된 소스 및 범주 칩은 텍스트 필터가 남긴 것을 다시 좁힙니다.

제목 또는 경로로 필터링… — 필터 상자; 입력한 내용이 제목 또는 프로젝트 경로에 포함된 항목으로 목록을 좁힙니다.
필터 지우기 — 필터 상자를 지웁니다.

목록 새로 고침

목록은 앱이 열릴 때 한 번 읽힙니다. 앱이 이미 실행 중인 동안 Claude Code에서 세션을 시작하거나 계속하거나 — 이전에 중지되었던 WSL 배포판을 시작하는 경우 — 목록 상단의 새로 고침 컨트롤을 사용하여 저장소를 다시 읽고 새 세션을 가져오십시오.

목록 새로 고침 — 앱이 열린 이후 생성된 세션(또는 시작된 배포판)이 나타나도록 세션 저장소를 다시 읽습니다.

대화록 읽기

세션을 선택하면 해당 대화가 오른쪽 창을 채웁니다.

대화록 표시 방법

대화록은 채팅처럼 배치됩니다. 사용자의 메시지는 오른쪽에 있습니다. Claude의 답변은 왼쪽 너비를 채웁니다. Claude가 그 과정에서 수행한 도구 작업은 답변 내부에 블록으로 나타납니다. 모든 것이 Markdown으로 렌더링됩니다 — 제목, 목록, 코드, 이미지 모두 제대로 표시되므로, 원시 기계 기록이 실제로 나눈 대화처럼 읽힙니다.

도구 블록 — 결과와 함께 접힌 호출

Claude가 도구를 사용할 때마다 두 가지 일이 발생했습니다: 요청을 보냈고, 결과를 받았습니다. 앱은 이 쌍을 하나의 접을 수 있는 블록으로 접습니다. 블록을 클릭하여 열면 — 요청이 위에, 결과가 아래에 표시됩니다 — 다시 클릭하여 닫습니다.

도구 요청과 결과는 부피가 크므로, 이 블록들은 닫힌 상태로 시작하여 기계적인 세부 사항을 거치지 않고 대화를 읽을 수 있도록 합니다. 특정 도구가 무엇을 했는지 정확히 보고 싶을 때, 해당 블록을 여십시오. (매우 긴 요청이나 결과는 잘려나가 큰 세션도 빠르게 렌더링됩니다.)

모든 도구 세부 정보 확장 또는 축소

대화록 도구 모음의 모두 확장 컨트롤은 현재 대화록의 모든 도구 블록을 한 번의 클릭으로 열거나 닫습니다 — 전체 그림을 보고 싶거나, 빠르게 훑어보기 위해 모두 다시 접고 싶을 때 유용합니다. 개별 블록은 클릭하여 여전히 열고 닫을 수 있습니다.

도구 세부 정보 확장 또는 축소 — 현재 대화록의 모든 도구 블록을 한 번에 열거나 닫습니다.

전체 세션, 단일 답변 또는 하나의 테이블을 앱에서 내보낼 수 있습니다. 기록 도구 모음의 세 가지 컨트롤은 전체 기록을 클립보드에 복사하거나, 파일로 저장하거나, 디스크에서 원본을 엽니다. 대화 자체에는 두 가지 컨트롤이 더 있으며, 원하는 부분 위로 마우스를 가져가면 나타납니다.

내보낸 마크다운의 모습

마크다운으로 복사와 마크다운 파일로 내보내기는 모두 동일한 결과물을 생성합니다. 즉, 전체 대화 내용이 담긴 독립적인 마크다운 문서입니다. 각 턴은 제목을 가지며, 도구 작업은 인라인으로 작성됩니다. Claude가 받거나 생성한 모든 이미지는 문서에 직접 포함되므로, 이 뷰어가 없어도 문서 자체로 완전합니다. 어떤 편집기나 노트 앱에서도 열고, 렌더링하고, 검색할 수 있습니다.

각 턴은 다음과 같은 형태로 나옵니다:

### User

Can you rename the helper function and update its callers?

### Claude

Done — renamed it and updated the two call sites.

### Tool result

(the file edits Claude made, shown inline)

제목(### User, ### Claude, ### Tool result)은 내보낸 문서 자체의 일부이므로, 이 앱과 멀리 떨어져 있어도 명확하게 읽을 수 있습니다.

마크다운으로 복사

전체 대사 기록을 마크다운으로 클립보드에 복사하여 메모, 채팅 또는 편집기에 바로 붙여넣을 수 있도록 합니다.

Markdown으로 복사 — 전체 대사 기록을 마크다운으로 클립보드에 복사합니다.

Claude의 답변 중 하나 복사

때로는 전체 대화가 아닌 하나의 답변만 필요한 경우가 있습니다. Claude의 답변 위에 마우스를 올리면 바로 아래에 복사 버튼이 나타납니다. 이 버튼을 클릭하면 해당 답변이 전체 내보내기에서와 동일한 형식의 마크다운으로 클립보드에 복사됩니다. 버튼은 잠시 동안 확인 표시로 바뀌어 복사가 완료되었음을 알려줍니다.

이 기능은 Claude의 답변에만 제공됩니다. 사용자 본인의 메시지는 이미 사용자가 작성한 텍스트이며, 위에서 설명한 전체 대화 복사 기능으로 처리됩니다.

답변을 Markdown으로 복사 — 해당 답변을 마크다운으로 클립보드에 복사합니다.

표 복사

표는 답변에서 가장 자주 다른 곳에 옮겨 놓으려는 부분입니다. 비교, 설정 목록, 결과 집합 등이 될 수 있습니다. 스크립트의 아무 표 위로 마우스를 가져가면 오른쪽 상단 모서리에 복사 버튼이 나타납니다.

이 버튼은 표를 두 가지 형태로 동시에 복사하며, 붙여넣을 앱이 이해하는 형식을 선택합니다.

스프레드시트, 워드 프로세서 또는 문서 편집기에 붙여넣으면 실제 표를 얻게 됩니다. 행과 열이 텍스트 덩어리가 아닌 온전한 형태로 도착합니다.
일반 텍스트 편집기에 붙여넣으면 탭으로 구분된 행을 얻게 되며, 대부분의 편집기와 데이터 도구는 이를 열로 읽습니다.

둘 중 하나를 선택하기 위해 아무것도 할 필요가 없습니다. 둘 다 단일 복사본으로 함께 이동합니다.

테이블 복사 — 마우스를 가져간 표를 복사합니다.

마크다운 파일로 내보내기

저장 대화 상자를 열어 .md 파일이 저장될 위치와 이름을 선택할 수 있습니다. 세션을 보관하거나 다른 사람에게 전달할 때 사용하세요.

Markdown 파일로 내보내기 — 선택한 마크다운 파일에 대사 기록을 저장합니다.

폴더에서 원본 파일 표시

세션의 원본 대사 기록 파일이 선택된 상태로 파일 관리자를 엽니다. 파일을 백업하거나, 검사하거나, 다른 도구로 가리키는 등 파일 자체가 필요할 때 사용하세요. (읽고 복사하는 것은 안전하지만, Claude가 해당 세션을 사용하는 동안 편집하는 것은 안전하지 않습니다. 앱은 세션을 변경하지 않습니다를 참조하세요.)

폴더에서 스크립트 파일 표시 — 파일 관리자에서 원본 대사 기록 파일을 선택하여 엽니다.

설정

상단 바의 버튼에서 설정을 엽니다. 언어 및 테마를 위한 표시 탭과 앱 버전을 위한 정보 탭이 있습니다.

설정 열기 — 설정 대화 상자(언어, 테마 및 앱 버전)를 엽니다.

언어

목록에서 인터페이스 언어를 선택하세요. 선택한 언어는 다음에 앱을 열 때 기억됩니다.

언어 — 인터페이스 언어를 선택합니다.

테마

밝은 또는 어두운 인터페이스를 선택하세요. 선택 사항은 즉시 적용되며 기억됩니다.

테마 — 밝게 및 어둡게 인터페이스 간에 전환합니다.

업데이트 알림

앱이 실행될 때, 새 버전이 출시되었는지 조용히 확인합니다. 새 버전이 있다면, 상단에 릴리스 노트 링크와 다운로드 버튼이 있는 배너가 나타납니다. 앱은 알려주기만 할 뿐, 스스로 아무것도 설치하지 않습니다.

배너를 처리하는 세 가지 방법이 있습니다.

다운로드 — 새 버전을 받을 수 있는 페이지를 엽니다.
닫기 — 이번 실행 동안 배너를 숨깁니다. 다음 실행 시 다시 나타날 수 있습니다.
이 버전 건너뛰기 — 이보다 더 새로운 버전이 출시될 때까지 배너를 숨겨, 이 버전에 대한 알림을 다시 받지 않도록 합니다.
새로운 기능 — 새 버전에 대한 릴리스 노트를 엽니다.

오프라인이거나, 이미 최신 버전이거나, 광고된 버전을 건너뛴 경우 배너가 나타나지 않습니다.

기타 제어

GitHub — 브라우저에서 GitHub에 있는 앱의 소스 코드 저장소를 엽니다.
도움말 — 현재 언어로 이 도움말 페이지를 엽니다.

도움말