Cách resume session và xem lịch sử Claude Code
Hướng dẫn resume Claude Code bằng tên, ID hoặc picker, kèm vị trí transcript plaintext trên máy chạy agent và lưu ý khác biệt giữa các phiên bản.
Cách tiếp tục một session Claude Code
Để tiếp tục một session Claude Code, chạy claude --continue để mở cuộc hội thoại gần đây nhất trong thư mục hiện tại, hoặc claude --resume để chọn một cuộc hội thoại cũ hơn từ danh sách. Trong một session đang chạy, lệnh /resume chuyển sang cuộc hội thoại khác mà không thoát. Dạng viết ngắn là -c và -r.
claude --continue
claude --resume
claude --resume auth-refactorNếu đã biết tên hoặc ID của session, hãy truyền nó làm đối số. Claude Code sẽ mở thẳng session đó mà không hiển thị trình chọn.
Mọi nội dung bên dưới khớp với tài liệu session chính thức tại thời điểm tháng 11 năm 2026. Claude Code thường xuyên phát hành phiên bản mới, và tên flag cùng phím tắt có thể thay đổi giữa các phiên bản. Vì vậy, hãy xem claude --help và trang đó là nguồn tham chiếu chính nếu nội dung ở đây không khớp với những gì terminal hiển thị.
Session thực sự là gì
Một session là một cuộc hội thoại đã lưu, gắn với một thư mục project. Session chứa toàn bộ lịch sử tin nhắn, bao gồm các tool call mà Claude đã thực hiện và kết quả trả về. Claude Code liên tục ghi session xuống disk trong lúc bạn làm việc, không đợi đến cuối mới ghi, nên cuộc hội thoại vẫn tồn tại khi bạn đóng terminal hoặc mất kết nối SSH.
Khi resume, Claude khôi phục nhiều hơn phần văn bản. Toàn bộ lịch sử hội thoại được khôi phục, cùng với model mà session đang dùng và subagent đã khởi chạy session nếu bạn đã dùng --agent. Permission mode cũng được khôi phục khi bạn resume từ shell bằng --continue hoặc session ID, ngoại trừ một trường hợp để đảm bảo an toàn: bypass-permissions mode không bao giờ được khôi phục. Vì vậy, session kết thúc ở mode này sẽ resume bằng mode mà một session mới sẽ bắt đầu. Plan mode được khôi phục, kể cả khi bạn chọn session từ picker hoặc chuyển sang session bằng /resume; hai cách này bình thường không truyền mode đã lưu sang session. Terminal resume đã khôi phục mode này từ v2.1.290. Picker và /resume đã khôi phục mode này từ v2.1.292. Các bản phát hành cũ cũng loại bỏ plan mode khi resume. Từ shell, --permission-mode sẽ ghi đè mode được khôi phục.
Một số thiết lập không được khôi phục vì chúng là flag lúc khởi chạy, không phải state đã lưu. Các directory được thêm bằng --add-dir và những tùy chọn như --mcp-config, --settings và --plugin-dir phải được truyền lại khi bạn resume. Các file settings như settings.json được đọc lại khi khởi chạy, nên không cần truyền lại những thiết lập nằm trong đó. Credentials cũng thuộc nhóm này: Claude Code xác định cách xác thực lúc khởi chạy, dựa trên thông tin đăng nhập và environment của bạn, thay vì khôi phục cùng conversation. Vì vậy, nếu resume một session trên VPS nơi một ANTHROPIC_API_KEY không mong muốn đã lọt vào shell, Claude Code sẽ gặp lỗi API key không hợp lệ, dù lần trước session vẫn chạy bình thường.
Vì sao lịch sử session quan trọng hơn trên VPS
Có một thực tế khiến nhiều người bất ngờ. Transcript được ghi trên máy nơi agent chạy. Nó không nằm trong account của bạn và không được đồng bộ lên cloud. Đó là một file trên disk của máy đó.
Vì vậy, session bạn để lại trong một cửa sổ tmux trên VPS sẽ không xuất hiện trong danh sách chọn trên laptop, và session từ laptop cũng không xuất hiện trên VPS. Không có dữ liệu nào được chuyển giữa hai máy. Nếu bạn làm việc theo cách phổ biến là chạy Claude Code trong tmux trên VPS, server sẽ là nơi tích lũy lịch sử hội thoại thực tế của bạn, còn danh sách chọn hiển thị cục bộ sẽ chứa một tập session khác và nhỏ hơn nhiều.
Việc phân tách tương tự cũng áp dụng giữa các giao diện. Desktop app và VS Code extension mỗi bên lưu lịch sử session riêng, và lịch sử của chúng không phải lịch sử của CLI, dù desktop app cũng có thể resume một CLI session. Claude Code trên web cũng có lịch sử riêng. Cowork còn tách biệt hơn: mặc định, session của Cowork chạy trên cloud của Anthropic và được lưu vào Claude account của bạn thay vì phần cứng bạn sở hữu; chỉ các desktop deployment hiện có mới giữ execution cục bộ. Vì vậy, nếu bạn đang cân nhắc Cowork và Claude Code, nơi transcript được lưu cũng là một phần của quyết định.
Trong cùng một máy, phạm vi tìm kiếm rộng hơn bạn có thể nghĩ. claude --resume <session-id> trước tiên tìm trong thư mục project hiện tại và các git worktree của thư mục đó, sau đó tìm trong mọi project khác trên máy. Cụm từ cần ghi nhớ là “trên máy đó”. Session ID từ một host khác sẽ không trả về kết quả nào, và Claude Code thông báo điều này bằng No conversation found with session ID: <session-id>.
Claude Code lưu lịch sử session ở đâu
Theo mặc định, transcript được lưu trong thư mục cấu hình của Claude Code, tại đường dẫn có dạng ~/.claude/projects/<project>/<session-id>.jsonl.
<project> là đường dẫn đến thư mục làm việc của bạn, trong đó mọi ký tự không phải chữ và số được thay bằng dấu gạch ngang. Vì vậy, session bắt đầu trong /home/deploy/apps/api sẽ được lưu trong thư mục có tên -home-deploy-apps-api. Nếu tên sau khi chuyển đổi dài hơn 200 ký tự, Claude Code sẽ cắt ngắn tên đó rồi thêm hash của đường dẫn đầy đủ. Nhờ vậy, tên thư mục vẫn nằm trong giới hạn của filesystem.
File này dùng định dạng JSONL: mỗi dòng là một object JSON. Mỗi dòng có thể là một message, một lần tool được sử dụng hoặc kết quả của tool, một record về request mà Claude Code gửi đến model, hoặc một entry metadata. Đây là text có thể đọc được và việc đọc file này không có vấn đề gì.
Tuy nhiên, không nên viết parser dựa trực tiếp vào file này. Định dạng entry là nội bộ của Claude Code và có thể thay đổi giữa các version. Vì vậy, script đọc trực tiếp các file này có thể bị lỗi sau bất kỳ lần update nào. Tài liệu chính thức của Anthropic khuyến nghị dùng /export hoặc các script interface được documented thay thế. Đây là khuyến nghị hợp lý chính vì lý do đó.
Có 2 setting thay đổi vị trí và thời gian lưu các file này. CLAUDE_CONFIG_DIR di chuyển toàn bộ thư mục cấu hình. Bạn có thể dùng setting này để lưu transcript trên volume riêng hoặc volume được mã hóa. cleanupPeriodDays trong settings.json kiểm soát thời gian lưu chúng. Giá trị mặc định là 30 ngày và giá trị tối thiểu là 1.
Thực tế các file transcript chứa gì
Mọi kết quả từ tool đều được ghi lại. Vì vậy, transcript chứa nội dung các file mà Claude đã đọc và output của các lệnh Claude đã chạy. Trang sử dụng dữ liệu của Anthropic nêu rõ: Claude Code lưu transcript của session cục bộ dưới dạng plaintext tại ~/.claude/projects/. Vì transcript cũng ghi lại những gì Claude Code gửi cho model, nó có thể chứa system prompt, định nghĩa tool, tham số request và các file CLAUDE.md đã được nạp.
Hãy xem điều đó có ý nghĩa gì trên server. Nếu Claude đọc file .env để tìm nguyên nhân khiến một service không khởi động, nội dung file đó giờ nằm trong một file JSONL trong home directory của bạn. Nếu một lệnh in ra connection string, chuỗi đó cũng nằm trong file. Không có gì bị rò rỉ. Transcript chỉ ghi lại những gì đã xảy ra, đó chính là mục đích của nó, và cũng là lý do bạn phải đưa nó vào threat model.
- Backup: backup dạng plain của
/homehoặc/rootsẽ sao chép transcript của bạn đến nơi lưu backup. Hãy thêm exclusion, hoặc chấp nhận rằng bản sao của prompt và nội dung file của bạn sẽ nằm trong backup store. - Snapshot và image: VPS snapshot được tạo vì bất kỳ lý do nào cũng chứa toàn bộ directory. Image bạn clone để tạo server thứ hai cũng vậy.
- Các account khác trên máy: tự kiểm tra mode bằng
ls -ld ~/.claude ~/.claude/projectsthay vì mặc định rằng quyền đã được giới hạn chặt. - Upload có chủ đích: lệnh
/feedbackcố ý gửi lịch sử hội thoại đến Anthropic, còn/bugvà/sharecũng report qua cùng path. Hộp thoại feedback cũng có thể bao gồm các session khác trong cùng project trong 24 giờ hoặc 7 ngày gần nhất, không chỉ session hiện tại. Đây là những thao tác bạn chủ động thực hiện, vì vậy hãy biết rõ mình đang đồng ý với điều gì trước khi xác nhận.
Nếu không muốn có transcript, CLAUDE_CODE_SKIP_PROMPT_HISTORY sẽ tắt việc ghi transcript, còn --no-session-persistence sẽ tắt việc ghi cho một lần chạy claude -p non-interactive. Hãy hiểu rõ đánh đổi trước khi đặt một trong hai tùy chọn này. Resume đọc transcript, nên không có transcript thì không thể resume.
Cách tìm một cuộc trò chuyện cũ
Mở picker bằng claude --resume, hoặc bằng /resume khi đang ở trong một session đang chạy. Mỗi dòng hiển thị tên session nếu bạn đã đặt tên, hoặc title được tạo tự động nếu chưa đặt tên, cùng với thời gian kể từ lần hoạt động cuối, git branch và kích thước file.
Picker có chức năng tìm kiếm. Nhấn /, hoặc chỉ cần bắt đầu nhập, để lọc danh sách. Các shortcut đáng nhớ là những shortcut mở rộng phạm vi tìm kiếm: Ctrl+A hiển thị session từ mọi project trên máy này, Ctrl+W hiển thị mọi worktree của repository hiện tại, còn Ctrl+B chỉ lọc theo git branch hiện tại. Nhấn Space để xem trước nội dung của session trước khi chọn tiếp tục, và Ctrl+R để đổi tên session đang được chọn.
Đặt tên cho session giúp mọi việc dễ hơn nhiều. Bắt đầu một session bằng claude -n auth-refactor, hoặc chạy /rename auth-refactor giữa chừng, ngay khi bạn nhận ra cuộc trò chuyện đã trở thành một phần việc thực sự. Sau đó, bạn có thể resume session đã đặt tên bằng chính tên đó từ shell.
Session không có tên vẫn được tạo một title tự động. Title này do một request chạy nền gửi đến một model nhỏ, nhanh để tóm tắt prompt đầu tiên của bạn. Title đó giúp bạn nhận ra dòng tương ứng trong picker và cũng dùng được làm handle để resume: claude --resume xử lý nó giống như tên bạn tự đặt. Tuy nhiên, tên hiển thị mặc định, chẳng hạn my-app-3f, mà một interactive session không có tên dùng trong danh sách các session đang chạy thì không hoạt động theo cách này. Nếu truyền tên đó cho claude --resume, Claude Code sẽ không tìm thấy session.
Tìm session phù hợp bằng cách grep transcript
Đôi khi bạn chỉ nhớ một cụm từ và không nhớ gì khác. Transcript là các file text, nên bạn có thể tìm kiếm trong đó.
grep -rl "nftables" ~/.claude/projects/Lệnh này in ra path của các transcript khớp. Tên file không có extension .jsonl là session ID và claude --resume <session-id> chấp nhận ID này. claude --resume cũng chấp nhận trực tiếp absolute path của transcript. Dùng grep để xác định session bạn cần, sau đó resume session hoặc export session để đọc nội dung thực tế.
Có 2 điểm cần lưu ý. Nội dung được escape theo định dạng JSON, nên một cụm từ chứa ký tự quote hoặc bị tách qua line break có thể không khớp khi tìm bằng chuỗi literal. Ngoài ra, kết quả khớp bên trong tool result chỉ cho biết Claude đã thấy đoạn text đó, không có nghĩa là có người đã nhập nó.
Đọc và xuất một cuộc hội thoại
/export kết xuất cuộc hội thoại hiện tại dưới dạng văn bản thuần túy. Tin nhắn và output của tool được ghi lại theo cách dễ đọc thay vì dưới dạng JSON. Nếu không có đối số, lệnh mở menu cho phép chọn clipboard hoặc một file. Khi có tên file, /export handover.txt ghi thẳng vào đường dẫn đó. Đây là cách phù hợp để chuyển một cuộc hội thoại từ server sang laptop hoặc đính kèm cuộc hội thoại vào một ticket.
Với các tác vụ tự động, hãy dùng những interface được thiết kế để ổn định. Hook và lệnh status line nhận trường transcript_path làm input, vì vậy hook SessionEnd có thể lưu trữ transcript khi session kết thúc. Bạn cũng có thể đặt câu hỏi cho một session đã lưu mà không cần mở session đó:
claude -p --resume <session-id> --output-format json "summarize what we changed" | jq -r '.result'Lệnh này gửi một prompt tiếp theo vào cuộc hội thoại cũ và trả về JSON có cấu trúc. Đây là nền tảng tốt hơn nhiều so với việc parse định dạng JSONL, vốn có thể thay đổi trong release tiếp theo.
Khi bắt đầu phiên mới tốt hơn tiếp tục phiên cũ
Tiếp tục phiên cũ sẽ khôi phục toàn bộ lịch sử, và mọi request sau đó đều phải mang theo toàn bộ lịch sử này. Một conversation kéo dài 4 giờ hôm qua sẽ tốn nhiều chi phí nếu tiếp tục hôm nay. cách mức sử dụng token cộng dồn trong một session dài giải thích chi phí đó thực sự phát sinh từ đâu.
Đôi khi Claude Code tự chọn giải pháp trung gian cho bạn. Nếu bạn để một conversation dài không hoạt động trong interactive terminal session và conversation đó đang dùng prompt cache 1 giờ, tùy chọn mà gói Claude subscription cấp mặc định cho conversation chính trong giới hạn sử dụng của plan, idle compaction sẽ compact conversation sau khoảng 54 phút, ngay trước khi cache hết hạn. Tính năng này chỉ áp dụng khi context của conversation đạt ngưỡng token, mặc định là 200,000, auto-compaction đang bật và máy vẫn đang hoạt động tại thời điểm đó. Trước v2.1.314, Claude Code cũng phải lấy feature flags từ Anthropic, nên subscriber đã tắt telemetry sẽ không nhận được tính năng này. Từ v2.1.314, tính năng này cũng chạy cho các subscriber đó, đồng thời hoạt động trong chat panel của VS Code extension và tab Code của desktop app. Không có dialog nào hỏi trước. Khi quay lại, conversation sẽ hiển thị một dòng bắt đầu bằng Compacted while idle, before the prompt cache expired, và message tiếp theo của bạn sẽ gửi summary thay vì toàn bộ lịch sử.
- Bật tính năng này giúp các request sau rẻ hơn, nhưng phần nào bị loại khỏi summary sẽ không còn sẵn để sử dụng. Bạn có thể hạ ngưỡng bằng
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS, nhưng các giá trị dưới 100,000 sẽ được nâng lên 100,000. - Tắt tính năng này bằng cách đặt
idleCompactionthànhfalsetrongsettings.json, hoặc từ dòng Idle compaction trong/configtrên v2.1.302 trở lên. Khi đó conversation vẫn giữ nguyên, nhưng chi phí mỗi request sẽ tăng theo kích thước conversation. Nếu cache đã hết hạn trước khi bạn gửi message tiếp theo, request đó sẽ xử lý lại toàn bộ lịch sử một lần.
Trên các plan Pro và Max, v2.1.304 bổ sung thêm một lần kiểm tra. Tài liệu hiện tại cũng liệt kê các plan Ultra. Khi việc tiếp tục một conversation dài sau một khoảng nghỉ dài, hoặc trên một model khác, có thể dùng một phần đáng kể trong giới hạn sử dụng 5 giờ của bạn, dialog Resume this conversation? sẽ hiển thị phần ước tính đó và cho phép bạn tiếp tục hoặc bắt đầu conversation mới. Khi tùy chọn conversation mới cho biết có hỗ trợ, Claude có thể tra cứu conversation trước nếu bạn tham chiếu đến nó.
Quyết định này đơn giản hơn bạn nghĩ. Hãy tiếp tục conversation khi việc bạn sắp nhập phụ thuộc vào những gì đã được nói trước đó. Hãy bắt đầu mới khi không phụ thuộc. Bạn sẽ dễ nhận ra context cũ nếu chú ý: Claude nhắc đến một file bạn đã xóa từ 1 giờ trước, hoặc tranh luận lại một quyết định bạn đã chốt ở đầu session. Đó là stale context, và việc mang nó sang session mới vừa tốn token vừa làm giảm độ chính xác.
Nếu phần hữu ích của một conversation cũ là một quyết định hoặc thông tin bạn sẽ cần lại, đừng dựa vào việc tiếp tục conversation để lưu giữ nó. Hãy ghi lại ở nơi mọi session đều có thể xem, đó là mục đích của các file memory của Claude Code.
/branch cũng đáng biết trong trường hợp này. Tính năng này sao chép conversation đến điểm hiện tại rồi chuyển bạn sang bản sao, giữ nguyên bản gốc và vẫn để bản gốc trong picker. Dùng tính năng này để thử một cách tiếp cận thứ hai mà không mất cách tiếp cận đầu tiên.
Resume khác gì compaction và memory
Ba khái niệm này thường xuyên bị nhầm lẫn, nhưng chúng giải quyết các vấn đề khác nhau.
Resume là việc mở lại một cuộc trò chuyện sau khi bạn đã thoát, reboot hoặc chuyển sang tác vụ khác. Compaction liên quan đến context window trong một cuộc trò chuyện đang chạy: /compact thay thế phần context mà Claude đang giữ bằng một bản tóm tắt, nên các request sau đó gửi ít token hơn. Nếu vấn đề là context window đã đầy, hãy dùng compaction. Quản lý context window của Claude Code giải thích đầy đủ cách này.
Memory lại khác. Các file CLAUDE.md và auto memory chứa instruction và fact được load khi bắt đầu mỗi session, nên chúng không phải là một cuộc trò chuyện để bạn quay lại. Đó là những thông tin bạn ghi lại để không bao giờ cần quay lại một cuộc trò chuyện.
Nếu bạn muốn hai cuộc trò chuyện chạy đồng thời và phối hợp với nhau, đó là một cơ chế riêng. Các session Claude Code có thể nhắn tin cho nhau khi cả hai vẫn đang chạy. Đây là một vấn đề khác với việc lấy session của ngày hôm qua từ disk và mở lại.
FAQ
Claude Code lưu lịch sử session ở đâu?
Mặc định, Claude Code lưu dưới thư mục cấu hình tại ~/.claude/projects/<project>/<session-id>.jsonl. Trong đó, <project> là đường dẫn thư mục làm việc, với các ký tự không phải chữ và số được thay bằng dấu gạch ngang. Mỗi file dùng định dạng JSONL: mỗi dòng chứa một đối tượng JSON cho một message, một lần sử dụng tool hoặc kết quả của lần sử dụng đó, một bản ghi về request gửi đến model hoặc một mục metadata. CLAUDE_CONFIG_DIR chuyển thư mục cấu hình sang vị trí khác. cleanupPeriodDays trong settings.json đặt thời gian lưu transcript, mặc định là 30 ngày và tối thiểu là 1.
Vì sao tôi không thấy session VPS trong picker trên laptop?
Vì transcript được ghi vào ổ đĩa của máy chạy agent và không có cơ chế đồng bộ giữa các máy. Một cuộc trò chuyện bạn thực hiện trong tmux trên VPS chỉ tồn tại trên VPS đó. Hãy resume session trên VPS qua SSH, hoặc chạy /export bên trong session rồi copy file văn bản sang máy local nếu bạn muốn lưu một bản.
Tôi có thể resume session đã bắt đầu trong thư mục khác không?
Có, nếu bạn có session ID. claude --resume <session-id> trước tiên tìm trong thư mục project hiện tại và các git worktree của project đó, sau đó tìm trong mọi project khác trên cùng máy. Trong picker, Ctrl+A mở rộng danh sách đến mọi project trên máy, còn Ctrl+W mở rộng danh sách đến mọi worktree của repository hiện tại. Nếu không có kết quả phù hợp, Claude Code báo No conversation found with session ID: <session-id>.
Tôi nên resume session cũ hay bắt đầu session mới?
Hãy resume khi message tiếp theo phụ thuộc vào những gì đã được nói trong cuộc trò chuyện đó. Hãy bắt đầu session mới khi không phụ thuộc, vì resume sẽ load toàn bộ history và mọi request sau đó đều mang theo history này. Hãy chú ý hiện tượng trôi ngữ cảnh: nếu session liên tục nhắc đến các file bạn đã xóa, session đang giữ context cũ. Context đó tiêu tốn token và làm giảm độ chính xác trong mỗi lượt trao đổi.
Tôi có thể ngăn Claude Code ghi transcript vào disk không?
Có. CLAUDE_CODE_SKIP_PROMPT_HISTORY tắt việc ghi transcript. --no-session-persistence tắt việc ghi transcript cho một lần chạy claude -p non-interactive. Trước tiên hãy hiểu đánh đổi này, vì resume đọc dữ liệu từ transcript. Khi tắt transcript, --continue và --resume sẽ không có dữ liệu để load. Nếu bạn chỉ lo về vị trí lưu file chứ không muốn xóa việc lưu transcript hoàn toàn, hãy trỏ CLAUDE_CONFIG_DIR đến một encrypted volume và giảm cleanupPeriodDays.