Claude Code typing Vietnamese text has errors: causes and how to fix

Claude Code có dùng được tiếng Việt không?

Có, ở phần trả lời. Trang cài đặt chính thức mô tả khoá language là cách để Claude trả lời bằng ngôn ngữ khác tiếng Anh: giá trị được chuyển nguyên văn cho Claude làm chỉ dẫn, không có danh sách cố định, không kiểm tra chính tả. Đặt bằng /config trong phiên hoặc thêm "language": "vietnamese" vào tệp cài đặt ("vietnamese" là ví dụ của tôi theo mẫu "japanese" trong tài liệu; mức tuân thủ chưa đo). Hai giới hạn theo tài liệu: nhập giọng nói /voice không có tiếng Việt trong 20 ngôn ngữ hỗ trợ, và giao diện chưa có bản tiếng Việt (yêu cầu #69741 đã đóng, không lên kế hoạch).

Lỗi gõ tiếng Việt trông như thế nào?

Lỗi nằm ở ô nhập của terminal, không nằm ở mô hình. Người báo cáo đoán ô nhập tự vẽ của Claude Code chưa khớp với cơ chế ghép chữ của bộ gõ; Anthropic chưa xác nhận điều này trong các issue tôi đọc.

Triệu chứng	Nguyên nhân được nêu	Cách thử
Gõ "aa" không ra "â", dấu biến mất	Bộ gõ và ô nhập không đồng bộ (Windows Terminal, #7989, #44948)	Soạn ở nơi khác rồi dán
Chữ chỉ hiện sau khi bấm Space hoặc Enter	Chữ đang ghép không vẽ trực tiếp (Linux, #43381)	Đổi terminal, thử CLAUDE_CODE_NATIVE_CURSOR=1
Tiêu điểm nhảy sang cửa sổ khác	Người báo nghi bộ gõ toàn hệ thống khi mở 13 đến 14 phiên (Windows, #85238)	Giảm số phiên mở
Dấu lệch hoặc hiển thị sai	Chưa rõ, #34549 không nêu nguyên nhân	Chụp màn hình, báo kèm phiên bản
Lẫn chữ Hán giữa câu tiếng Việt	Hành vi mô hình, một trường hợp (#76351)	Nhắc trong CLAUDE.md, đọc lại bản trả lời

Đa số báo cáo ghi Windows. Có báo cáo trên macOS (#10429, #47269, #65250) nhưng cả ba bị đóng vì trùng lặp. Tôi không có số liệu về tỉ lệ người gặp lỗi.

Các issue công khai hiện ở trạng thái nào?

Đọc ngày 04/11/2026 trên github.com/anthropic/claude-code. Các issue riêng cho tiếng Việt (#7989, #34549, #43381, #44948) đều đã đóng từ tháng 5/2026, do không hoạt động (nhãn stale) hoặc "not planned", không phải vì đã có bản sửa. Issue #1547 về bộ gõ gây chậm và ứng viên hiện hai lần (báo bằng tiếng Nhật, macOS) còn mở.

Which order should you try?

Try from least intervention to most, stop when the error is gone.

1. Type elsewhere then paste. This is the method user #44948 used successfully. Long pastes will collapse into a "Pasted text" label but still send the full content, according to terminal documentation.
2. Open an external editor with Ctrl+G, the key that documentation says opens the prompt in the default text editor. Whether the input method runs properly in that editor, we haven't checked yet.
3. Switch terminals. The terminal table in the documentation mentions Shift+Enter, says nothing about the input method. A comment in #1547 notes that version 2.1.84 fixed cursor tracking so the input method now displays directly in Ghostty, while Zellij still has errors (personal opinion, about Japanese input).
4. Try CLAUDE_CODE_NATIVE_CURSOR=1, a variable that documentation describes as showing the true terminal cursor at the input position. The documentation doesn't say it fixes Vietnamese input; we haven't checked. Easy to remove since it only applies to one run:

CLAUDE_CODE_NATIVE_CURSOR=1 claude

1. Switch input method or input style. No guarantee: user #10429 tried both macOS built-in input method and third-party input method, both failed in iTerm2.
2. Update. claude --version shows your current version (our machine shows 2.1.317); claude update and claude doctor are in claude --help, we've only matched command names, didn't run them.
3. Open a new issue if it still fails: note the version, operating system, terminal, input method, reproduction steps, and old issue numbers.

Some comments introduced third-party patch scripts; we haven't run them and don't recommend running unread code.

How do I make Claude Code always reply in Vietnamese?

Use language as above, and add a CLAUDE.md file, the Markdown file Claude reads at the start of each session. According to documentation, ./CLAUDE.md applies to one project, ~/.claude/CLAUDE.md applies to all your projects; keep it under 200 lines, and Claude treats it as context rather than forced configuration. A sample block, ready to copy:

# Language and reply style
- Always reply in Vietnamese with diacritics, short sentences.
- Keep command names, file names, variable names and code snippets in English; don't translate them.
- When explaining errors, state the cause first, then the fix.
- If I type without diacritics, still understand and reply with diacritics.
- If unsure, say "not sure", don't guess.

The fourth line lets you type without diacritics when the input method fails, in exchange for slightly fuzzier questions. See more at What is CLAUDE.md.

OPCAIOS experience

I use Claude Code in Vietnamese on macOS to build the opcaios.org website. Real limits: we can't reproduce the error on every operating system, terminal and input method, so we don't claim any method has fixed the error. The error description above comes from documentation and public issues, not from our own testing.

Frequently asked questions

Does Claude Code understand and reply in Vietnamese?

Possibly. The most stable way is to set the language key then add a line in CLAUDE.md asking for Vietnamese replies with diacritics. We haven't measured quality and compliance, and report #76351 notes a Chinese character slipped into a Vietnamese sentence, so read the reply again. The Claude Code interface is still in English.

Why does Telex input in Claude Code lose diacritics?

The cause hasn't been confirmed by Anthropic in the issues we've read. Reporters guess the custom input box doesn't handle combining characters from the input method correctly. The error appears mainly on Windows Terminal, with reports from Linux and macOS. The simplest workaround is to type elsewhere then paste.

Can I input Vietnamese by voice into Claude Code?

Not according to documentation. /voice lists 20 languages, Vietnamese is not one; setting language outside the list makes Claude Code warn and voice input falls back to English, while the reply part doesn't change. Requests to add Vietnamese (#62185, #83743) have been closed without a fix.

Does this error happen on macOS?

There are reports (#10429, #47269, #65250) but they're all closed as duplicates, and most other reports note Windows. I use it on macOS, but that's one user, not systematic testing.

Where do I learn Claude Code in Vietnamese?

Read What is Claude Code and Claude Code for beginners, then use the CLAUDE.md block above. The original documentation is in English so you can ask Claude to explain each section in Vietnamese, then cross-check the original at important parts.

Next Steps

Copy the CLAUDE.md block "always reply in Vietnamese" from above into ~/.claude/CLAUDE.md, open a new session and ask a question to test it.

Source: Anthropic Claude Code documentation (settings, voice, terminal, interactive mode, env-vars, memory) and public issues #1547, #7989, #10429, #34549, #43381, #44948, #47269, #62185, #65250, #69741, #76351, #83743, #85238 on github.com/anthropics/claude-code, read on 04/11/2026; ran claude --version and claude --help. Not verified: root cause of the typing error, effectiveness of each workaround on your machine, model's compliance with Vietnamese, error status in newer versions. Experience is from OPCAIOS.