AI 코딩 어시스턴트를 매일 쓰는 개발자라면 한 번쯤 겪는 상황이 있습니다. 어제 진행했던 대화가 어떤 폴더에 저장됐는지 찾으려 Claude Code를 다시 켰는데, 프로젝트별로 나뉜 인코딩 폴더명 탓에 헤매는 경우입니다. GeekNews의 Show GN 카테고리에 게시된 클로드코드 세션 탐색기는 바로 그 지점에서 출발한 1인 개발자 도구입니다.
한눈에 보기
- 문제 인식: Claude Code 세션이 ~/.claude/projects 아래 인코딩된 폴더명으로 저장되어 CLI 환경에서 위치를 파악하기 어려움
- 기존 한계: claude –resume 의 인터랙티브 피커는 현재 디렉토리와 /add-dir 로 추가한 경로로 탐색 범위가 한정됨
- 제안 도구: 로컬 전체 세션을 한곳에 모아 키워드 하나로 전 세션을 가로질러 검색하는 세션 탐색기를 직접 제작해 공개
세션 데이터는 이미 로컬에 있지만, 이를 찾아 쓰는 인터페이스가 부족했다는 점이 이 도구의 핵심 동기입니다.
클로드코드 세션이 왜 흩어지는가
Claude Code를 프로젝트 안에서 한 번만 써도 ~/.claude/projects 하위에는 새로운 세션 디렉토리가 만들어집니다. 문제는 이 폴더명이 사람이 읽기 쉬운 형태가 아니라 인코딩된 문자열이라는 점입니다. 터미널에서 ls로 폴더를 나열해 봐도 어떤 세션이 어느 프로젝트였는지 즉시 구별하기 어렵습니다.
프로젝트 단위 디렉토리 구조와 인코딩 폴더명의 한계
원 글에 따르면 ~/.claude/projects 의 디렉토리명은 인코딩된 형태라 사람이 구조를 기억하기 어렵습니다. 즉, 세션이 실제로는 로컬 디스크에 그대로 존재함에도, 개발자 입장에서는 어디 있는지 모르는 상태가 반복되는 셈입니다. 디스크 점유와 히스토리 양이 늘어나면 이런 탐색 비용은 점점 커집니다.
–resume 인터랙티브 피커의 탐색 범위 제약
Claude Code는 claude –resume 명령으로 이전 세션을 이어갈 수 있는 인터랙티브 피커를 제공합니다. 다만 이 피커는 현재 디렉토리와 /add-dirr 옵션으로 추가한 디렉토리 범위 안에서만 세션을 보여줍니다. 한 번에 여러 프로젝트를 옮겨 다니며 작업하는 1인 개발자에게는 이 범위 제약이 꽤 불편하게 느껴집니다.
| 구분 | 탐색 범위 | 제약 |
|---|---|---|
| 기본 –resume 피커 | 현재 디렉토리 + /add-dir 추가 경로 | 다른 프로젝트 세션은 보이지 않음 |
| ~/.claude/projects 직접 탐색 | 로컬 전체 세션 | 인코딩 폴더명 탓에 식별이 어려움 |
| 세션 탐색기(소개된 도구) | 로컬 전체 세션을 한곳에 목록화 | 키워드 기반 전 세션 검색 지원 |
세션 탐색기 직접 만들어 보기
이런 불편을 직접 느낀 작성자는 도구 하나를 만들어 공개합니다. 게시글 기준 작성자 표기는 skarb8277 이며, GitHub 저장소 위치는 github.com/Noaarhk 입니다. 원 글에서는 이 도구가 로컬에 흩어진 Claude Code 세션을 한곳에 모아 보여주고, 키워드 하나로 전 세션을 가로질러 검색할 수 있도록 설계되었다고 소개합니다.
로컬 전역 세션 목록화와 키워드 전역 검색 구현
기존 –resume 가 가진 범위 제약을 우회하기 위해, 도구는 사용자가 Claude Code를 어떤 경로에서 실행했는지와 무관하게 로컬에 저장된 전체 세션을 모아 봅니다. 사용자는 폴더 구조를 외울 필요 없이, 기억나는 키워드 하나만 입력해 과거 세션을 다시 꺼낼 수 있습니다. 이처럼 탐색의 기준을 경로에서 키워드로 옮긴 것이 이 도구의 핵심 아이디어로 보입니다.
TUI 와 CLI 양쪽에서 접근 가능한 탐색 인터페이스
원 글의 설명에 따르면, 이 도구는 터미널 안에서 바로 쓸 수 있는 탐색 인터페이스를 제공해 키보드만으로 세션을 오갈 수 있게 합니다. 별도 서버나 로그인 없이 로컬에서 동작한다는 점에서, 1인 개발자가 자기 워크플로우에 끼워 넣기 쉬운 형태로 구성되어 있습니다. 다만 구체적인 구현 언어나 의존성, 성능 수치 등은 원문에 명시되지 않아 여기서는 단정하지 않습니다.
1인 개발자 워크플로우 관점의 시사점
AI 코딩 도구가 일상이 된 지금, 대화 세션은 단순한 로그가 아니라 개인 지식 자산에 가깝습니다. 같은 문제를 다시 만나거나, 며칠 전 작성한 코드의 맥락을 다시 끌어와야 할 때, 이 세션을 얼마나 빨리 다시 열 수 있는지가 생산성을 좌우합니다.
AI 코딩 도구 사용 시 세션 지식 재사용 문제
모델의 응답 품질이 좋아져도, 그 응답이 어떤 파일을 기준으로 나왔는지, 어떤 제약을 두고 나왔는지를 잊어버리면 다시 같은 비용을 들여야 합니다. 세션을 빨리 찾는다는 것은 곧 과거 자신의 사고흐름을 재현하는 작업이며, 이는 도구가 가져다주는 가장 큰 실무적 이점 가운데 하나로 분석됨.하는 작업과 연결됩니다. 이 관점에서 보면 세션 탐색 문제는 단순한 도구 부족이 아니라, AI 시대 개발자 워크플로우 전반의 설계 사안으로 보입니다.
오픈소스 개인 도구로 해결하는 실용적 접근
회사가 정식 출시한 기능을 기다리기보다, 직접 만든 작은 도구를 공개해 동료 개발자와 함께 다듬어 가는 방식은 1인 개발자 문화의 상징 같은 흐름입니다. 이번 사례도 그 연장선에서 이해할 수 있습니다. 작은 불편을 직접 코드로 풀어낸 결과물이 GitHub에 공개되어 있고, GeekNews 같은 개발자 커뮤니티에서 자연스럽게 소개된 점은, AI 코딩 도구의 사용 경험 자체가 오픈소스 영역으로 확장되고 있음을 보여줍니다.
정리 포인트
- Claude Code 세션은 ~/.claude/projects 아래 인코딩된 폴더명으로 저장되어 CLI에서 위치 파악이 사실상 불가능합니다.
- claude –resume 의 인터랙티브 피커는 현재 디렉토리와 /add-dir 추가 경로로 탐색 범위가 한정됩니다.
- 제작된 세션 탐색기는 로컬 전체 세션을 한곳에 모아 키워드 기반 전역 검색을 제공합니다.
- 1인 개발자가 AI 시대의 세션 지식 재사용 문제를 작은 오픈소스 도구로 직접 해결한 사례로, 워크플로우 자동화 흐름의 좋은 참고점이 됩니다.