# Session Transcript

> The file on disk where Claude Code keeps a session.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** Transcript, Session JSONL file, Claude Code transcript

## Think of it like

It is like the notes from a meeting, kept in a drawer.

## Definition

A session transcript is the file where Claude Code keeps a session. By default it lives at ~/.claude/projects/, in a folder for the project, as one file per session. Each message and tool call is one line of JSON in it. Claude Code reads the file back when you resume, which is how a conversation goes on after you close it. You can also read it yourself to see exactly what happened.

## Example

Jack wants to know which command broke his build. He opens the session transcript and finds the exact Bash call and its output.

## Example code

```bash
ls ~/.claude/projects/
```

List the saved projects and their sessions.

## Why it matters

It is the true record of what Claude did, which helps when you need to check or explain a change.

## Common mistake

Pasting a transcript to someone without reading it. It can hold file contents, keys or other private text from the session.

## Three principles

- **A file per session.** Under ~/.claude/projects/.
- **One line per step.** JSON.
- **Read to resume.** And to check.

## Related terms

- [Claude Code Session](https://learn.benibix.com/term/ai/claude-code-session)
- [Claude Code Checkpoint](https://learn.benibix.com/term/ai/claude-code-checkpoint)
- [JavaScript Object Notation (JSON)](https://learn.benibix.com/term/development/json)

## Taught in

- [Claude Code Sessions](https://learn.benibix.com/learn/ai-claude-code/claude-code-sessions): Claude Code, 2/16

![Each message in a session is written as one line in a file under the projects folder.](https://learn.benibix.com/diagrams/cc-session-transcript.svg)

---

Source: https://learn.benibix.com/term/ai/session-transcript
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-19
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
