클로드 세션 어디서나 보기
0. 생긴 일
사무실 컴퓨터에서 클로드에게 긴 일을 맡기고 퇴근했습니다. 집 컴퓨터에서 진행 상황을 보려고 클로드 데스크톱 앱을 열었는데, 사무실에서 시킨 세션이 목록에 없었습니다. 두 컴퓨터가 같은 서버에 붙어 있었는데도 그랬습니다.
1. 왜 안 보이나
- 클로드 데스크톱 앱의 세션 목록은 그 세션을 띄운 앱 안에 저장됩니다. 다른 컴퓨터의 앱으로는 넘어가지 않습니다.
- 같은 서버에 같은 주소로 SSH 연결을 추가해도 소용없습니다. 목록은 서버가 아니라 앱이 들고 있기 때문입니다.
- 대신 대화 기록 자체는 서버에 쌓입니다. 클로드 코드는 세션마다
~/.claude/projects/<폴더>/<세션ID>.jsonl파일 하나에 대화와 도구 호출을 모두 적습니다. 어느 컴퓨터에서 시켰든 일한 곳이 그 서버라면 기록은 전부 거기 있습니다.
그러니 서버에서 이 기록을 읽어 웹으로 보여 주면, 어느 컴퓨터에서든 같은 화면을 볼 수 있습니다.
2. 쓴 도구 — claude-code-viewer
- 저장소: d-kimuson/claude-code-viewer (MIT 라이선스)
- 하는 일:
~/.claude/projects의 기록을 읽어 프로젝트별 세션 목록, 대화 내용, 도구 호출, 고친 파일, 서브에이전트를 웹으로 보여 줍니다. 돌고 있는 세션도 실시간으로 갱신됩니다. - 비밀번호를 걸 수 있고, 폰에서는 「홈 화면에 추가」로 앱처럼 쓸 수 있습니다.
다른 후보와 비교
| 도구 | 라이선스 | 고르지 않은 이유 |
|---|---|---|
| CloudCLI (siteboon/claudecodeui) | AGPL-3.0 | 기능은 많지만 메시지 보내기가 중심인 도구라 보기 용도로는 과합니다 |
| claude-code-webui (sugyan) | MIT | 채팅 화면 중심이고 기록 열람이 약합니다 |
| claude-code-viewer | MIT | 기록 보기와 실시간 보기가 중심이라 이번 목적에 맞습니다 |
구독 계정이면 알아 둘 것
2026년 4월부터 Anthropic 약관은 구독 계정으로 Agent SDK 를 써서 메시지를 보내는 것을 막고 있습니다. 그래서 이 도구는 첫 화면에서 이용 방식을 묻습니다.
- Subscription 을 고르면 보내기와 이어서 시키기는 꺼집니다. 대신 같은 일을 하는
claude명령을 복사해 주는 버튼이 생깁니다. - 기록 보기, 실시간 보기, 검색은 SDK 를 거치지 않아서 그대로 다 됩니다.
- 이 선택은 브라우저마다 따로 저장됩니다. 컴퓨터마다 처음 한 번씩 고르면 됩니다.
3. 설치
서버(클로드가 일하는 기계)에서 합니다.
- Node.js 24 이상이 필요합니다. 22 에서는 「requires Node.js >=24.0.0」 오류로 멈춥니다. nvm 을 쓴다면 24 를 깔아 기본값으로 바꾸고, 22 에 깔려 있던 전역 패키지를 24 에 다시 깝니다.
- npm 11 은 설치 스크립트를 기본으로 막습니다. esbuild·sharp 처럼 스크립트가 필요한 꾸러미는
npm config set allow-scripts=...로 허용해야 합니다. - 22 는 지우지 말고 남겨 둡니다. 이미 돌고 있는 클로드 프로세스가 22 경로의 파일을 쓰고 있기 때문입니다.
- npm 11 은 설치 스크립트를 기본으로 막습니다. esbuild·sharp 처럼 스크립트가 필요한 꾸러미는
- 설치:
npm install -g @kimuson/claude-code-viewer - 실행:
claude-code-viewer --hostname <서버의 사설망 주소> --port 3400 --password <비밀번호>- 비밀번호는 명령줄에 박지 말고
.env에 두고, systemd 서비스의EnvironmentFile로 넘깁니다. - 서버가 켜질 때 같이 뜨도록 systemd 서비스로 등록합니다.
- 비밀번호는 명령줄에 박지 말고
처음 한 번은 오래 걸립니다
처음 뜰 때 기존 기록을 전부 읽어 색인을 만듭니다. 우리 서버는 기록 1.8GB, 세션 1,447개에 약 7분이 걸렸고, 그동안은 포트가 열리지 않았습니다. 서비스는 「active」인데 접속이 안 되면 이 단계일 가능성이 큽니다. 다음부터는 바로 뜹니다.
4. 보안 — 사설망에 묶었다고 끝이 아닙니다
- 인터넷에 열지 않고 Tailscale 같은 사설망 주소에만 묶었습니다.
- 그래도 사설망 묶기는 인증이 아닙니다. 같은 사설망에 다른 조직의 기계가 들어와 있을 수 있습니다. 그래서 비밀번호를 꼭 겁니다.
- 확인은 직접 불러 봤습니다. 비밀번호 없이 API 를 부르면 401, 맞는 비밀번호로 로그인하면 200 이 나왔습니다.
- 대화 기록에는 업무 내용이 그대로 들어 있습니다. 공개 주소로 내보내려면 조직 로그인 뒤에 둬야 합니다.
5. 써 보니
- 컴퓨터를 옮겨 다녀도 「아까 거기서 시킨 일」을 바로 볼 수 있습니다. 일을 맡겨 두고 자리를 뜨는 일이 많을수록 쓸모가 큽니다.
- 클로드 코드 새 버전이 남긴 기록 일부는 「Schema Error」로 표시됩니다. 뷰어가 아직 모르는 형식이라서이고, 대화를 읽는 데는 지장이 없습니다.
- 이어서 시키려면 뷰어가 복사해 준 명령을 그 서버의 터미널에서 실행합니다(
claude --resume <세션ID>). 다만 세션이 아직 돌고 있으면 같은 대화를 두 곳에서 쓰게 되니, 끝난 뒤에 합니다.