# Claude Code

Claude Code 내보내기가 연결부터 문제 해결까지 어떻게 작동하는지 설명합니다.

## 연결

Claude Code 카드에서 “연결”을 누릅니다. 숨김 파일이 보이는 상태로 `.claude` 폴더에서 패널이 열리면 “이 폴더 선택”을 누릅니다. Exporter는 그 안의 `projects` 폴더만 읽습니다. 그런 다음 “내보낼 폴더 선택”을 누릅니다.

## 파일이 저장되는 위치

프로젝트별 폴더에 세션마다 Markdown 메모 하나가 생기며, 이름은 세션의 시작 시각과 제목입니다(`wander.md/2026-08-23 2233 fix the changelog header link.md`). 원본 로그는 `originals/<project>/<id>.jsonl`로 복사됩니다. 붙여 넣은 이미지는 `<project>/attachments/`에 들어갑니다.

## 내보내지는 것

카드에서 체크한 세션입니다. 필터는 목록을 거르기만 합니다: 최근(최신순), 가장 긴(질문이 많은 순), 실행 중(최근 2분 안에 로그가 바뀐 세션). 검색창은 세션 제목, 첫 질문, 프로젝트를 비교합니다.

“저장 위치”에서 형식을 고릅니다: Markdown, 원본, 또는 둘 다. 세션 제목은 `/rename`으로 붙인 이름이고, 없으면 Claude Code가 고른 이름, 그것도 없으면 첫 질문입니다.

## 형식

Markdown입니다. 프런트매터 뒤에 턴마다 시각과 블록 ID가 붙은 문단이 이어집니다. 도구 호출은 실행한 내용의 블록, 편집은 diff 블록, 붙여 넣은 이미지는 삽입입니다. 추론, 도구 결과, 스냅샷, 도구 내부 알림은 메모에 들어가지 않습니다.

## 파일

| 키 | 내용 |
| --- | --- |
| `agent`, `session` | `claude-code`와 세션 ID |
| `title`, `project`, `cwd`, `branch` | 세션의 주제와 위치 |
| `model`, `version` | 모델과 Claude Code 버전 |
| `started`, `ended` | 첫 줄과 마지막 줄의 시각 |
| `turns`, `prompts`, `tools` | 얼마나 많은 일이 있었는지 |
| `tokens_in`, `tokens_out` | 캐시 읽기를 제외한 새 입력과 출력 |
| `files` | 세션이 편집하거나 쓴 파일 |

```markdown
**you** · 22:33 ^turn-1

see the changelog page, the header link goes to /contact

**claude** · 22:34 ^turn-2

I'll look at the live page first.

```tool Bash "find docs route" ^toolu_01A
ls src
```
```

## 무료와 잠금 해제

최근 50개 세션은 무료이며 계속 무료로 남습니다. Claude Code가 삭제한 세션도 파일은 남습니다([가격](https://exporter.dev/pricing)).

## 동기화와 전체 재동기화

처음 “지금 동기화”를 누른 뒤에는, 실행 중인 세션이 로그가 늘어날 때마다 메모를 다시 쓰고, 바뀐 로그만 다시 읽습니다.

“전체 재동기화”는 먼저 확인한 뒤, Exporter가 쓴 세션 파일을 지우고 Claude Code에 아직 남은 것을 다시 내보냅니다. Claude Code가 이미 삭제한 세션은 돌아오지 않으니, 누르기 전에 폴더를 백업하세요.

## 문제와 해결 방법

- “이 폴더에 세션 로그가 없습니다(홈 폴더의 .claude 폴더를 선택하세요)”: “연결”을 다시 누르고 패널이 열린 폴더를 선택합니다
- 세션이 없음: 체크가 해제되어 있거나, 상위 세션에 합쳐지는 하위 에이전트의 로그입니다
- 새 세션이 더 이상 들어오지 않음: 무료 50개를 다 썼습니다. Claude Code 잠금을 해제하고 “지금 동기화”를 누릅니다
- 메모가 비어 있음: 세션에 아직 질문이 없고 Claude Code 자체 기록만 있습니다

## Related

- [Claude Code](https://exporter.dev/claude-code): Every session as a note, the original kept
- [Claude Code guides](https://exporter.dev/guides/claude-code): Keep every session as a note
- [MCP server](https://exporter.dev/docs/mcp): Connect Claude and other agents

---

human version: https://exporter.dev/ko/docs/claude-code
every page: https://exporter.dev/llms.txt