Claude Code output style: cách hoạt động và tự viết
Output style sửa system prompt của Claude Code, nên ảnh hưởng mọi reply. Xem 5 style tích hợp, transcript thay đổi ra sao và cách tự viết style riêng.
Output style trong Claude Code là gì
Output style trong Claude Code là một khối hướng dẫn mà Claude Code thêm vào nội dung gửi cho Claude trong mỗi request. Nó thay đổi cách Claude trả lời bạn: vai trò mà nó đảm nhận và định dạng của những gì nó in ra. Nó không dạy Claude bất cứ điều gì về codebase của bạn và không thể cấp quyền cho Claude chạy bất kỳ lệnh nào.
Claude Code đi kèm với năm style tích hợp sẵn. Lựa chọn của bạn nằm trong một khóa cài đặt, outputStyle. Trên Claude Code v2.1.251 trở lên, style bạn chuyển đổi giữa phiên làm việc sẽ áp dụng từ tin nhắn tiếp theo của bạn. Từ v2.1.73 đến v2.1.251, việc chuyển đổi được lưu lại nhưng bị bỏ qua cho đến khi bạn clear session, và thực tế này giải thích cho hầu hết các nhầm lẫn mà bạn vẫn sẽ thấy trong các hướng dẫn cũ về tính năng này.
Trên một VPS, đây không chỉ là tùy chọn về mặt thẩm mỹ. Transcript là những gì bạn đọc qua kết nối SSH (secure shell), thường là bên trong một cửa sổ tmux, vì vậy mỗi dòng Claude tường thuật là một dòng bạn phải chờ đợi và là một dòng nằm trong bộ đệm scrollback có kích thước cố định.
Nơi lưu trữ thiết lập outputStyle
Chọn một kiểu từ menu /config, trong mục Output style. Claude Code sẽ ghi lựa chọn của bạn vào .claude/settings.local.json trong dự án mà bạn đang làm việc.
Lệnh /output-style thực hiện công việc tương tự từ prompt. Chạy /output-style concise để chuyển đổi, hoặc /output-style không kèm đối số để liệt kê các kiểu và xem kiểu nào đang được áp dụng. Lệnh này lưu vào cùng một file .claude/settings.local.json, không phân biệt chữ hoa chữ thường và cũng hoạt động ở chế độ không tương tác. Lệnh được mô tả ở đây xuất hiện từ Claude Code v2.1.269. Một lệnh /output-style cũ hơn đã tồn tại từ v2.0.30 và bị đánh dấu deprecated trong v2.1.73 để thay thế bằng /config, vì vậy bản build nằm giữa hai phiên bản này có thể không hoạt động như trang này mô tả. Hãy kiểm tra phiên bản bạn đang chạy trước khi làm theo bất kỳ hướng dẫn nào, bao gồm cả hướng dẫn này. Các phiên bản trên trang này đã được kiểm tra vào tháng 10 năm 2026.
claude --versionBạn cũng có thể tự thiết lập key này bằng tay. Có bốn file cài đặt có thể chứa nó, và file có phạm vi hẹp hơn sẽ ghi đè lên file có phạm vi rộng hơn.
~/.claude/settings.jsonlà file người dùng của bạn. Nó áp dụng cho mọi dự án trên máy đó..claude/settings.jsonlà file dự án. Nó được commit vào git, vì vậy nó áp dụng cho tất cả những ai clone repository này..claude/settings.local.jsonlà file dự án cục bộ. Nó không được commit và ghi đè lên cả hai file trên. Đây là file mà menu/configvà lệnh/output-styleghi vào.- Các thiết lập được quản lý, triển khai bởi đội ngũ IT từ một đường dẫn hệ thống như
/etc/claude-code/trên Linux, sẽ ghi đè lên tất cả các thiết lập khác.
Giá trị của key là tên kiểu:
{
"outputStyle": "Concise"
}Giá trị này phân biệt chữ hoa chữ thường. Hãy viết các tên tích hợp sẵn là Proactive, Concise, Explanatory và Learning. Một giá trị không khớp chính xác với tên kiểu, ví dụ như concise, sẽ âm thầm trả về kiểu Default.
Chỉ dành cho một phiên làm việc, hãy truyền cùng một key trên dòng lệnh. Flag --settings nhận một đường dẫn hoặc một chuỗi JSON nội dòng, và các giá trị của nó sẽ ghi đè lên các key tương ứng trong các file cài đặt người dùng, dự án và cục bộ của bạn cho lần chạy đó. Các thiết lập được quản lý vẫn có quyền ưu tiên cao hơn:
claude --settings '{"outputStyle": "Concise"}'Tài liệu liệt kê bốn cách để chọn kiểu, và chỉ hai trong số đó yêu cầu phiên bản tối thiểu. Menu /config trong terminal không yêu cầu phiên bản. Lệnh /output-style ở dạng hiện tại cần v2.1.269, và menu Output styles trong extension VS Code cần v2.1.257. Trong ứng dụng Desktop, bạn thiết lập trường outputStyle trong một file cài đặt thay thế. Bản thân key outputStyle không có phiên bản tối thiểu, vì vậy đây là cách đáng tin cậy nhất. Khi ảnh chụp màn hình trong bất kỳ hướng dẫn nào không còn khớp với những gì bạn thấy, hãy thiết lập key trực tiếp và xác nhận lại bằng /status, lệnh này sẽ liệt kê các nguồn cài đặt đang có hiệu lực.
Khi style đầu ra mới có hiệu lực
Trên Claude Code v2.1.251 trở lên, style bạn chuyển giữa phiên, bằng command, menu hoặc settings file, sẽ áp dụng từ message tiếp theo. Bạn không cần clear. Từ v2.1.73 đến v2.1.251, session đang chạy giữ nguyên style lúc khởi động; style mới chỉ được nạp ở lần /clear tiếp theo hoặc khi khởi động lại.
Trong terminal, Claude Code đọc các style file khi khởi động. Vì vậy, nếu bạn tạo hoặc sửa custom style file trong lúc session đang chạy, hãy restart Claude Code trước khi chọn style đó. Trong VS Code v2.1.261 trở lên, walkthrough Build a custom style trong menu Output styles tạo file và hiển thị style mới ngay lập tức. Với build thuộc khoảng phiên bản cũ đó, hoặc sau khi restart để áp dụng thay đổi style file trong terminal, hai command sau sẽ đưa bạn về trạng thái sạch rồi hiển thị nội dung đã được nạp:
/clear
/context/context in nội dung hiện đang chiếm context window, được phân loại theo category và bao gồm system prompt. Hãy chạy command này trong một session mới với từng style; dòng system prompt là phần đầu vào để bạn so sánh. Đây cũng là cách nhanh nhất để xác nhận custom style đã được nạp. Để xem tổng quan hơn về những gì lấp đầy window đó, xem cách context đầy lên trong một session Claude Code dài.
Cache giải thích vì sao việc chuyển style hoạt động như vậy. API phục vụ các request lặp lại từ prompt cache khớp với phần đầu của từng request, còn system prompt nằm ngay ở phần đầu. Nếu viết lại system prompt giữa cuộc hội thoại, mọi nội dung phía sau nó sẽ không còn hợp lệ, nên turn tiếp theo phải xử lý lại toàn bộ lịch sử dưới dạng input mới. Các build từ v2.1.73 đến v2.1.251 tránh chi phí đó bằng cách cố định style khi session khởi động. Các build hiện tại thay vào đó gửi instruction của style mới dưới dạng message trong cuộc hội thoại. Vì vậy, request sau khi chuyển style vẫn đọc system prompt và cuộc hội thoại trước đó từ cache. Dù theo cách nào, chuyển style vẫn có chi phí thấp.
Những thay đổi của từng output style tích hợp đối với transcript
- Default là system prompt mặc định của Claude Code, được viết cho công việc software engineering.
- Concise đưa kết quả lên trước. Style này bỏ phần mở đầu và phần tường thuật từng bước, đồng thời giữ câu trả lời ngắn cho đến khi bạn yêu cầu thêm chi tiết. Phần công việc engineering phía sau không thay đổi. Style này không bao giờ rút gọn error report hoặc cảnh báo bảo mật, và vẫn hỏi đầy đủ trước khi thực hiện hành động có tính hủy dữ liệu. Style này cần Claude Code v2.1.237 trở lên.
- Explanatory thêm các "Insights" mang tính hướng dẫn giữa những bước của task, giải thích lý do chọn một cách triển khai và pattern mà codebase của bạn đang dùng. Transcript được thiết kế để dài hơn.
- Learning đi xa hơn. Claude chia sẻ các insight đó, sau đó yêu cầu bạn tự viết những phần code nhỏ, đồng thời đánh dấu từng vị trí bằng comment
TODO(human)trong file. - Proactive khiến Claude hành động thay vì hỏi. Với các quyết định thường lệ, Claude đưa ra những giả định hợp lý thay vì dừng lại để xin xác nhận.
Hãy đọc kỹ phần cuối, vì đây là điểm mọi người thường hiểu nhầm. Proactive là hướng dẫn trong system prompt. Nó thay đổi những gì Claude sẽ thử thực hiện. Permission mode của bạn vẫn quyết định thao tác nào thực sự chạy mà không cần hỏi. Đây mới là setting quan trọng trên server bạn để chạy unattended. Nội dung này được trình bày trong auto mode và các permission mode của Claude Code.
Sự khác biệt giữa output style, CLAUDE.md, hook và subagent
Các bề mặt này đều có vẻ như là cách để chỉ dẫn cho Claude cách hoạt động, nhưng chúng vận hành ở các tầng khác nhau.
- Output style là một phần trong các chỉ dẫn mà Claude Code gửi kèm mỗi request. Nó áp dụng cho mọi phản hồi trong cuộc hội thoại chính.
- CLAUDE.md được thêm vào như một tin nhắn của người dùng sau system prompt. Đây là nơi chứa các quy ước dự án và thông tin thực tế về codebase.
--append-system-promptnối thêm văn bản vào system prompt cho một lần gọi duy nhất mà không xóa bỏ bất kỳ nội dung nào. Đây là phiên bản dùng một lần của output style.- Hook là một shell command mà Claude Code tự chạy khi một sự kiện xảy ra. Nó được thực thi bởi harness, vì vậy nó luôn chạy bất kể Claude có chọn thực hiện hay không. Xem những gì một Claude Code hook có thể và không thể làm.
- Subagent chạy với system prompt và tập hợp công cụ riêng của nó.
Một bài kiểm tra ngắn sẽ giúp quyết định giữa hai lựa chọn đầu tiên. Các thông tin thực tế về dự án của bạn nên nằm trong CLAUDE.md, vì Claude cần biết chúng. Cách diễn đạt nên nằm trong output style, vì nó liên quan đến cách hiển thị câu trả lời. Bất cứ điều gì bắt buộc phải xảy ra mỗi lần, bất kể model quyết định thế nào, thì đó là một hook. Tầng mà mỗi bề mặt này nằm trong đó là thuộc tính của chương trình chạy model chứ không phải của chính model, đó là lý do tại sao một style chỉ có thể gây ảnh hưởng trong khi một hook có thể thực thi bắt buộc.
Output style chỉ áp dụng cho cuộc hội thoại chính. Một subagent không kế thừa style của bạn, vì nó bắt đầu cuộc hội thoại riêng với system prompt riêng. Một fork của cuộc hội thoại hiện tại là ngoại lệ, vì fork kế thừa chính xác system prompt của cha. Nếu một subagent viết theo cách bạn không thích, hãy chỉnh sửa file của agent đó thay vì chỉnh sửa style của bạn. Một phiên Claude Code thứ hai trên cùng máy chủ cũng tuân theo ranh giới tương tự, tự đọc các file cài đặt khi khởi động, vì vậy khi bạn chuyển công việc cho một phiên khác đang chạy song song, các phản hồi của nó sẽ trả về theo bất kỳ style nào mà phiên đó đã tải, chứ không phải style của bạn.
Cách viết style đầu ra của riêng bạn
Một style đầu ra tùy chỉnh là một file markdown có chứa frontmatter. Hãy lưu nó vào thư mục home để sử dụng cho mọi dự án, hoặc lưu bên trong repository để giữ cùng với mã nguồn. Thư mục người dùng là ~/.claude/output-styles/ và thư mục dự án là .claude/output-styles/.
mkdir -p ~/.claude/output-styles
cat > ~/.claude/output-styles/terse-ops.md <<'EOF'
---
name: Terse ops
description: Command first, explanation after, for SSH sessions
keep-coding-instructions: true
---
Lead with the command or the file change. Put the explanation after it, in two sentences or fewer.
Do not narrate what you are about to do. Report what you did.
When a command can fail, print the one check that proves it worked and say what a healthy result looks like.
EOFBắt đầu một phiên làm việc và mở /config. Style của bạn sẽ xuất hiện trong danh sách Output style cùng với mô tả bạn đã viết. Nếu nó không hiển thị, nghĩa là file không được đọc: hãy kiểm tra lại đường dẫn và khởi động lại Claude Code nếu phiên làm việc đã chạy từ trước khi bạn lưu file. Nếu nó chỉ hiển thị tên file mà không có mô tả, nghĩa là frontmatter không được phân tích cú pháp, và claude --debug sẽ hiển thị lỗi phân tích. Tên file sẽ trở thành tên style trừ khi frontmatter thiết lập name, vì vậy style này có tên là Terse ops chứ không phải terse-ops.
Hãy chọn nó, hoặc thiết lập key thành tên chính xác đó, với cùng định dạng chữ hoa:
{
"outputStyle": "Terse ops"
}Một trường sẽ quyết định file của bạn là một bản điều chỉnh hay một bản thay thế. keep-coding-instructions mặc định là false, nghĩa là một style tùy chỉnh sẽ loại bỏ các hướng dẫn kỹ thuật phần mềm tích hợp sẵn của Claude Code và chỉ chạy dựa trên văn bản của bạn. Các hướng dẫn tích hợp đó là những gì chỉ dẫn Claude cách xác định phạm vi thay đổi và cách kiểm chứng công việc của nó. Hãy bỏ qua trường này nếu bạn dùng cho trợ lý viết lách hoặc phân tích dữ liệu, nơi mà các hướng dẫn đó không áp dụng. Hãy thiết lập nó thành true cho bất kỳ thứ gì liên quan đến code, nếu không bạn sẽ thắc mắc tại sao một kỹ sư cẩn thận lại đột nhiên ngừng kiểm tra công việc của chính mình. Chỉ system prompt đầy đủ của Claude Code mới chứa phần đó, vì vậy trên system prompt ngắn hơn thì trường này không có tác dụng. Thiết lập biến môi trường CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT thành 0 sẽ chọn prompt đầy đủ trên bất kỳ model nào. Nếu điều bạn thực sự cần không phải là một giọng văn khác mà là định nghĩa chặt chẽ hơn về khối lượng công việc cho một tác vụ, thì điều đó thuộc về các hướng dẫn kỹ thuật thay vì file style: kỹ năng Ponytail là một ví dụ thực tế, một quy tắc đơn lẻ thúc đẩy agent hướng tới thay đổi nhỏ nhất mà vẫn hiệu quả.
description là dòng mà bộ chọn /config hiển thị bên cạnh tên. Hãy viết nó cho thời điểm bạn cần chọn giữa hai style của chính mình sau sáu tháng nữa.
Vì sao phong cách ngắn gọn khác biệt khi dùng SSH
Trên VPS, bạn đọc transcript qua nhiều lớp mà terminal cục bộ không có. Mỗi lớp đều khiến nội dung dài trở nên tốn kém hơn.
Scrollback là yếu tố đầu tiên. Trong tmux, mỗi pane giữ một số dòng cố định do history-limit thiết lập, mặc định là 2000. Transcript có nhiều lời giải thích sẽ lấp đầy buffer nhanh hơn. Vì vậy, phần đầu của session bị loại bỏ sớm hơn và output bạn muốn xem lại sẽ biến mất. Tăng giới hạn nếu cần thêm chỗ:
echo 'set -g history-limit 20000' >> ~/.tmux.conf
tmux source-file ~/.tmux.confCác pane được tạo sau đó sẽ giữ 20000 dòng mỗi pane, nhưng sẽ tốn thêm memory cho từng pane. Trên tmux 3.7 trở lên, thay đổi history-limit cũng cập nhật các pane đang mở; phiên bản cũ chỉ áp dụng thay đổi cho pane mới. Nếu bạn vẫn đang xây dựng layout cho session, chạy Claude Code bên trong tmux trên VPS có hướng dẫn.
Latency là yếu tố thứ hai. Response được stream vào terminal trong lúc được tạo. Với đường truyền có round-trip time cao, phần mở đầu dài khiến bạn phải chờ text hiển thị trước khi câu trả lời xuất hiện.
Output token là yếu tố thứ ba. Mỗi dòng giải thích đều được tính vào output. Explanatory và Learning vốn được thiết kế để dài hơn. Concise được thiết kế để ngắn hơn, vì nó hướng dẫn Claude mặc định giữ response ngắn.
Đừng tin phần trăm do bất kỳ ai đưa ra, kể cả trong trang này. Mức chênh lệch phụ thuộc vào prompt, model và công việc bạn yêu cầu. Vì vậy, hãy tự đo trước và sau. Chạy cùng một tác vụ thực tế trong hai session mới: một session dùng Default và một session dùng Concise, rồi so sánh. Statusline là cách đo đơn giản nhất, vì Claude Code truyền cho script của bạn một object JSON qua stdin. Object này đã có tên style, số output token của response gần nhất và ước tính chi phí lũy kế của session:
cat > ~/.claude/statusline.sh <<'EOF'
#!/bin/bash
input=$(cat)
style=$(echo "$input" | jq -r '.output_style.name // "default"')
out=$(echo "$input" | jq -r '.context_window.total_output_tokens // 0')
cost=$(echo "$input" | jq -r '.cost.total_cost_usd // 0')
echo "style=$style out=$out cost=$cost"
EOF
chmod +x ~/.claude/statusline.shTrỏ setting statusLine vào script đó:
{
"statusLine": {
"type": "command",
"command": "~/.claude/statusline.sh"
}
}Thanh ở cuối session giờ hiển thị style đang hoạt động, kích thước của response gần nhất và chi phí ước tính của session tính đến hiện tại. out chỉ tính response gần nhất, nên cho biết mỗi câu trả lời dài bao nhiêu. cost được cộng dồn, nên con số ở cuối mỗi lần chạy là số liệu trước và sau để bạn so sánh. Hãy đọc nó trước khi xóa, vì chi phí được đặt lại về $0 khi /clear bắt đầu session mới. Hãy xem đây là số ước tính, không phải hóa đơn thực tế. Script cần jq, công cụ phân tích JSON trên command line, nên hãy cài trước bằng sudo apt install -y jq. Nếu thanh vẫn trống, hãy chạy script thủ công và pipe một JSON vào đó. Statusline thoát với mã khác 0 sẽ không in hoặc báo cáo gì. Statusline tùy chỉnh cho Claude Code liệt kê các field còn lại trong object đó. Nếu quan tâm đến phần billing thay vì phần session, hãy đọc token của Claude Code thực sự được tính vào đâu và các công cụ theo dõi chi phí Claude Code.
Cách kiểm tra style output nào thực sự đang được nạp
Hãy dùng các lệnh kiểm tra này thay vì đoán.
/statusliệt kê các nguồn settings đang có hiệu lực trong session này, bao gồm việc settings được quản lý từ một tổ chức có đang được áp dụng hay không./contexthiển thị system prompt đã được nạp dưới dạng một category trong phần phân tích context window.claude doctor, chạy từ shell mà không khởi động session, in thông tin chẩn đoán về installation và settings, đồng thời báo cáo các file settings không hợp lệ.
Khi một style không được áp dụng, nguyên nhân gần như luôn là một trong hai vấn đề. Thứ nhất là timing: trên bản build từ v2.1.73 đến v2.1.251, việc chuyển style giữa session phải chờ /clear, còn trong terminal, file style bạn tạo hoặc chỉnh sửa giữa session phải chờ restart. Thứ hai là precedence: .claude/settings.local.json ghi đè .claude/settings.json, và cả hai đều ghi đè ~/.claude/settings.json. Vì picker /config và command /output-style ghi vào file local, style mà team của bạn commit trong .claude/settings.json sẽ âm thầm bị ghi đè trên mọi máy mà trước đó ai đó đã dùng một trong hai cách này. /status cho biết những file nào đã được nạp nhưng không cho biết file nào cung cấp key đó, vì vậy hãy mở từng file được liệt kê và tìm outputStyle.
Lỗi cú pháp JSON cũng có cùng triệu chứng nhưng cách sửa khác. claude doctor cho biết tên file mà nó không thể parse, vì vậy nên chạy lệnh này trước khi tìm nguyên nhân phức tạp hơn. Một value viết sai chữ hoa chữ thường, chẳng hạn explanatory, vẫn là JSON hợp lệ nhưng vẫn khiến bạn nhận style Default, nên hãy kiểm tra cả chữ hoa.
FAQ
Vì sao lệnh /output-style không còn hoạt động?
Trong bản build hiện tại, lệnh này vẫn hoạt động. /output-style liệt kê các style và /output-style concise chuyển sang một style. Lệnh này có một khoảng gián đoạn trong lịch sử: v2.1.73 đánh dấu lệnh này là deprecated và thay bằng /config, còn v2.1.269 thêm dạng /output-style [name] hiện tại. Vì vậy, trên bản build nằm giữa hai phiên bản này, lệnh có thể không hoạt động như mô tả ở đây. Chạy claude --version để xem phiên bản bạn đang dùng. Trên mọi bản build, bạn có thể chọn style trong /config, tại mục Output style, hoặc đặt key outputStyle trong file settings. Tài liệu không nêu phiên bản tối thiểu cho key này, vì vậy đặt trực tiếp key là hướng dẫn đáng ghi lại trong ghi chú của riêng bạn.
Tôi đã đổi output style nhưng không có gì xảy ra. Vì sao?
Trước tiên, hãy kiểm tra phiên bản. Trên Claude Code v2.1.251 trở lên, style được chuyển giữa session sẽ có hiệu lực từ message tiếp theo. Từ v2.1.73 đến trước v2.1.251, thay đổi được lưu nhưng chỉ có hiệu lực sau /clear hoặc khi bắt đầu session mới. Trong terminal, nếu bạn tạo hoặc sửa file custom style trong lúc session đang chạy, cần restart vì Claude Code đọc các file style khi khởi động. Nếu style vẫn chưa được áp dụng, hãy kiểm tra giá trị có khớp chính xác với tên style không, bao gồm cả chữ hoa. Sau đó chạy /status để xem những file settings nào đã được nạp, vì .claude/settings.local.json ghi đè .claude/settings.json, và cả hai đều ghi đè ~/.claude/settings.json.
Output style Concise có giúp tiết kiệm chi phí không?
Style này điều chỉnh số output token theo hướng bạn mong đợi vì nó yêu cầu Claude mặc định giữ câu trả lời ngắn. Mức tiết kiệm phụ thuộc vào prompt và model bạn dùng, vì vậy hãy xem mọi phần trăm được công bố là kết quả đo trên công việc của người khác. Hãy tự đo: chạy /context trong một session mới với từng style để đo phần input, sau đó chạy cùng một tác vụ với từng style và so sánh số output token cùng chi phí ước tính. Concise không rút ngắn error report hoặc cảnh báo bảo mật, nên những phần bạn cần đọc nhất vẫn được giữ đầy đủ.
Output style có thay đổi cách subagent viết không?
Không. Output style chỉ áp dụng cho cuộc hội thoại chính vì subagent bắt đầu một cuộc hội thoại riêng với system prompt và bộ tool riêng. Fork của cuộc hội thoại hiện tại là ngoại lệ vì fork kế thừa chính xác system prompt của conversation cha. Để thay đổi cách subagent trả lời, hãy sửa file riêng của agent đó.
Output style có cho phép Claude chạy command mà không hỏi không?
Không. Output style là văn bản trong system prompt, nên nó chỉ có thể ảnh hưởng đến những gì Claude cố gắng thực hiện. Style Proactive khiến Claude mặc định đưa ra giả định và hành động thay vì dừng lại ở các quyết định thường lệ, nhưng style này vẫn không thể phê duyệt command. Permission mode quyết định những gì được chạy mà không cần prompt. Đây là setting bạn cần kiểm tra trước khi để session chạy trên server.