Claude Code quên dự án sau mỗi phiên: Khắc phục như thế nào?

Sáng mở máy, gõ đúng lệnh quen thuộc rồi nhận ra Claude Code quên sạch quy ước dự án của hôm qua. Mỗi phiên mới đều khởi động với cửa sổ ngữ cảnh trống trơn, nên thứ ngốn thời gian của mình không phải bộ lệnh slash mà là chuyện nuôi ngữ cảnh. Nắm hai cơ chế ghi nhớ cùng cách nén hội thoại, bạn sẽ hết cảnh kể lại dự án từ đầu.

Claude Code CLI vận hành ra sao trong cửa sổ dòng lệnh terminal

Claude Code CLI chạy thẳng trong cửa sổ terminal, không dựng giao diện đồ họa riêng. Sau khi cài đặt, mọi thao tác đều gõ bằng bàn phím theo nguyên lý mô tả việc cần làm rồi để công cụ đọc mã nguồn và đề xuất chỉnh sửa. Màn hình đầu tiên dễ gây choáng vì dòng nhập lệnh nằm lẫn giữa nhật ký xử lý và các gợi ý mở đầu bằng dấu gạch chéo. Cách vận hành thực chất gọn hơn vẻ ngoài của nó khá nhiều.

Bạn điều khiển Claude Code qua ba lớp thao tác. Lớp thứ nhất là bộ lệnh slash mở đầu bằng dấu gạch chéo, chạy ngay trong phiên. Lớp thứ hai là phím tắt của chế độ tương tác, kèm lệnh /keybindings mở đúng tệp cấu hình phím để bạn tra hoặc sửa. Lớp thứ ba là tham số dòng lệnh truyền vào lúc gọi công cụ. Cách bố trí này giữ mọi thao tác trên bàn phím, hạn chế việc rời tay sang chuột giữa lúc tập trung. Xem thêm Trải nghiệm Claude Fable 5 và ngữ cảnh dài.

Có một hiểu nhầm khá phổ biến rằng tham số CLI chỉ dùng đúng lúc mở phiên. Tài liệu chính chủ của Claude Code CLI liệt kê nhiều lệnh chạy ngoài chế độ tương tác, chẳng hạn claude -p gửi một yêu cầu rồi thoát nên hợp để nhét vào script, claude -c nối tiếp phiên gần nhất, claude -r mở lại một phiên theo tên hoặc mã, claude update nạp phiên bản mới. Các cờ như –model, –effort hay –add-dir đổi mô hình, mức xử lý và thư mục khả dụng ngay từ lúc khởi chạy.

Bộ lệnh slash và kỹ năng đi kèm bạn gọi được mỗi phiên

Gõ dấu gạch chéo rồi thêm vài chữ cái, danh sách lệnh thu hẹp dần theo chuỗi bạn vừa nhập. Nhóm lệnh dựng sẵn của Claude Code lo phần quản trị phiên, gồm /help liệt kê lệnh, /context vẽ ra ngữ cảnh đang chiếm chỗ, /model đổi mô hình, /usage xem trạng thái cùng chi phí phiên, /rewind lùi lại cả mã nguồn lẫn hội thoại. Nhóm này chạy logic cố định nên phản hồi gần như tức thì, không tốn thêm lượt suy luận nào.

Bên cạnh đó là các kỹ năng đi kèm mà tài liệu Claude Code gọi là bundled skills, gồm /doctor, /code-review, /batch, /debug, /loop và /claude-api. Khác với lệnh dựng sẵn, nhóm kỹ năng này hoạt động bằng bộ hướng dẫn chi tiết, tức công cụ đọc hướng dẫn rồi tự điều phối các công cụ thành phần để hoàn thành việc được giao. Chúng khả dụng ở mọi phiên và chỉ tắt được bằng thiết lập disableBundledSkills trong tệp cấu hình.

Việc cần làm	Cách gọi	Ghi chú vận hành
Mở phiên trong dự án	claude	thêm cờ –model để chọn mô hình ngay lúc khởi chạy
Chạy một yêu cầu rồi thoát	claude -p	hợp để nhúng vào script hoặc quy trình tự động
Nối tiếp việc đang dở	claude -c	claude -r mở lại phiên cũ theo tên hoặc mã phiên
Lọc nhanh bộ lệnh slash	gõ dấu gạch chéo rồi vài chữ cái	danh sách thu hẹp theo đúng chuỗi vừa nhập
Soi ngữ cảnh đang nạp	/context	xác nhận tệp ghi nhớ nào đang nạp vào phiên
Cập nhật và rà soát cài đặt	claude update	/doctor kiểm tra cấu hình rồi gợi ý cách sửa

Danh sách lệnh Claude Code hiện ra không giống nhau giữa các máy, và tài liệu nói rõ điều đó. Lệnh /desktop chỉ có trên macOS cùng Windows bản x64. Bản Enterprise không thấy /upgrade, còn /privacy-settings chỉ xuất hiện với gói Pro và Max. Một số lệnh cũng vắng mặt khi bạn chạy qua Amazon Bedrock, Google Cloud Agent Platform hay Microsoft Foundry. Vậy nên trước khi viết quy trình chung cho cả nhóm, bạn nên xác minh danh sách khả dụng ngay trên môi trường của mình.

Cấu hình máy cũng ảnh hưởng tới trải nghiệm gõ lệnh trong Claude Code, nhất là khi bạn mở vài phiên song song và chạy thêm trình biên dịch tại chỗ, lúc đó dung lượng RAM trở thành yếu tố cốt lõi. Xem thêm Laptop AI/ML cho sinh viên ưu tiên GPU và RAM.

Cơ chế ghi nhớ của Claude Code thực chất nằm ở đâu

Mỗi phiên Claude Code khởi động với cửa sổ ngữ cảnh trống, nghĩa là công cụ không tự nhớ buổi làm việc hôm trước. Tài liệu mô tả hai cơ chế mang kiến thức đi xuyên phiên. Một là các tệp CLAUDE.md do chính bạn viết, hai là auto memory do Claude tự ghi lại từ những lần bạn chỉnh nó. Cả hai cùng nạp vào đầu mỗi cuộc hội thoại, nhưng chúng chỉ là ngữ cảnh chứ không phải cấu hình bắt buộc, nên cách diễn đạt ảnh hưởng tới mức tuân thủ.

Tệp CLAUDE.md có nhiều vị trí theo phạm vi áp dụng. Bản cá nhân nằm ở ~/.claude/CLAUDE.md và phủ mọi dự án, bản dự án nằm ở ./CLAUDE.md hoặc ./.claude/CLAUDE.md để chia sẻ qua kho mã, bản riêng tư dùng CLAUDE.local.md và nên đưa vào .gitignore. Lệnh /init sinh tệp khởi điểm, /memory mở tệp để sửa, còn /context xác nhận tệp nào đã nạp. Tài liệu khuyến nghị duy trì mỗi tệp dưới 200 dòng vì tệp dài làm giảm mức tuân thủ.

Auto memory lưu trong thư mục ~/.claude/projects/ theo từng kho mã, trong đó MEMORY.md làm mục lục còn các tệp chủ đề nằm cạnh. Chỉ 200 dòng đầu hoặc 25KB đầu của MEMORY.md được nạp lúc mở phiên, phần vượt ngưỡng bị bỏ qua, nên mục lục cần ngắn gọn. Bạn tắt tính năng này bằng thiết lập autoMemoryEnabled hoặc biến môi trường CLAUDE_CODE_DISABLE_AUTO_MEMORY. Chi tiết nằm trong tài liệu ghi nhớ của Claude Code.

Nén ngữ cảnh và những gì còn sót lại sau lệnh compact

Khi hội thoại dài ra, ngữ cảnh đầy dần và Claude Code CLI tự nén để phiên không đứt giữa chừng. Lệnh /compact làm đúng việc đó theo yêu cầu, bạn viết thêm mô tả phía sau để bản tóm tắt giữ lại đúng phần mình cần. Lệnh /autocompact đặt ngưỡng nén sớm hơn, ví dụ /autocompact 500k. Khi chuyển hẳn sang đầu việc khác, /clear dọn sạch còn gọn hơn nén, vì hội thoại cũ vẫn tốn token ở mọi lượt trao đổi.

Điểm mấu chốt là biết thứ gì sống sót sau lần nén. CLAUDE.md ở gốc dự án và auto memory nạp lại từ đĩa nên vẫn còn nguyên. Ngược lại, rule gắn nhãn paths và tệp CLAUDE.md nằm trong thư mục con biến mất cho tới khi Claude đọc lại một tệp khớp mẫu. Thân những skill từng gọi vẫn được nạp lại nhưng cắt theo hạn mức 5.000 token mỗi skill và 25.000 token tổng, phần cũ nhất rơi trước.

Muốn đỡ phải nén, bạn đẩy phần đọc nặng sang subagent để nội dung tệp nằm ở cửa sổ ngữ cảnh riêng, chỉ bản tóm tắt quay về phiên chính. Phương án còn lại là chọn mô hình mở rộng cửa sổ ngữ cảnh, vì tài liệu xác nhận Fable 5, Sonnet 5, Opus 4.6 trở lên và Sonnet 4.6 đáp ứng cửa sổ ngữ cảnh một triệu token, mức khả dụng tùy gói đăng ký. Cơ chế nén của Claude Code vẫn vận hành y hệt ở giới hạn lớn đó.

Cách khắc phục để Claude Code không quên quy ước dự án

Cách khắc phục nằm ở chỗ khác với điều nhiều người tưởng, bởi bộ lệnh gõ dấu gạch chéo là thấy gần hết. Nó nằm ở chỗ bạn phải chủ động nuôi ngữ cảnh, tức viết CLAUDE.md đủ gọn, kiểm tra bằng /context, nén đúng lúc và chấp nhận rằng lời dặn chỉ nói giữa phiên sẽ tan sau lần nén kế tiếp. Ai bỏ qua phần này thường thấy công cụ quên mất quy ước dự án rồi vội kết luận rằng nó kém.

Đối tượng hợp nhất vẫn là lập trình viên quen terminal và các đội duy trì kho mã lớn, nơi việc giao đọc tệp cho subagent tiết kiệm thấy rõ. Tài liệu cùng thông báo lỗi phần lớn bằng tiếng Anh nên khả năng đọc hiểu vẫn là điều kiện cần khi bạn muốn tối ưu quy trình. Claude Code đọc mã, sửa lỗi và chạy kiểm thử rất nhanh, song quyết định kiến trúc cùng trách nhiệm rà soát chất lượng vẫn thuộc về bạn.