Claude Code gõ tiếng Việt bị lỗi dấu (Unikey, EVKey): nguyên nhân và cách xử lý

Câu trả lời ngắn: đây là lỗi của ô nhập trong Claude Code khi dùng bộ gõ tiếng Việt, không liên quan tới API key hay RocketKey. Cách xử lý nhanh nhất: bấm Ctrl+G để soạn câu trong trình soạn thảo văn bản, lưu lại rồi đóng, nội dung sẽ được đưa vào Claude Code.

Triệu chứng

Khi gõ tiếng Việt bằng Unikey, OpenKey hoặc EVKey (kiểu Telex hay VNI) trực tiếp trong terminal của Claude Code, bạn có thể gặp:

• Chữ bị mất: gõ các chỉ còn c hoặc cá.
• Chữ bị lặp: gõ xin chào thành xin chaào.
• Dấu nhảy sai chỗ hoặc xuất hiện ký tự lạ.

Claude vẫn hiểu và trả lời tiếng Việt bình thường; lỗi chỉ nằm ở bước bạn gõ vào.

Vì sao bị lỗi?

Bộ gõ tiếng Việt hoạt động bằng cách xoá ký tự vừa gõ rồi gửi ký tự có dấu thay thế (ví dụ xoá a rồi gửi á). Theo các báo cáo lỗi trên GitHub của Claude Code, ô nhập của Claude Code xử lý chuỗi "xoá rồi thay" này chưa đúng, nên chữ bị mất hoặc lặp. Lỗi được báo từ tháng 9/2025 với Unikey Telex trên Windows, sau đó cả trên macOS và Linux với OpenKey, EVKey và kiểu VNI. Tính tới ngày 25/10/2026, các issue này đã bị đóng vì lâu không có hoạt động, chưa có ghi nhận bản sửa từ Anthropic.

Cách 1: soạn bằng trình soạn thảo với Ctrl+G (khuyên dùng)

Theo tài liệu của Claude Code, Ctrl+G (hoặc Ctrl+X Ctrl+E) mở nội dung ô nhập trong trình soạn thảo văn bản mặc định:

1. Trong Claude Code, bấm Ctrl+G.
2. Gõ câu tiếng Việt trong trình soạn thảo vừa mở. Bộ gõ hoạt động bình thường ở đây.
3. Lưu file rồi đóng trình soạn thảo. Nội dung được đưa vào ô nhập của Claude Code.
4. Bấm Enter để gửi.

Trình soạn thảo mặc định trên macOS và Linux thường lấy từ biến môi trường VISUAL hoặc EDITOR. Muốn dùng VS Code, đặt EDITOR="code --wait": tham số --wait để Claude Code chờ bạn đóng file rồi mới đọc nội dung.

Cách 2: gõ ở nơi khác rồi dán vào

Soạn câu trong Notepad, ghi chú hoặc ô chat bất kỳ, rồi dán vào Claude Code. Dán không đi qua bộ gõ nên không bị lỗi. Cách này hợp khi bạn chỉ thỉnh thoảng gõ tiếng Việt.

Cách 3: dùng Claude Code trong VS Code

Extension Claude Code cho VS Code có ô nhập riêng trong cửa sổ VS Code thay vì terminal, nên thường không gặp lỗi bộ gõ như terminal. Cách cài extension với key RocketKey có trong hướng dẫn Claude Code, mục "Extension Claude Code trong VS Code".

Cách 4: gõ tiếng Việt không dấu

Tắt bộ gõ (thường là Ctrl+Shift hoặc Alt+Z tuỳ cài đặt) và gõ không dấu, ví dụ sua loi dang nhap trong auth.ts. Claude hiểu tiếng Việt không dấu khá tốt. Nếu muốn Claude trả lời có dấu, thêm câu "trả lời bằng tiếng Việt có dấu".

Về các bản vá cộng đồng

Trên GitHub có vài script do cộng đồng viết, sửa trực tiếp file cài đặt của Claude Code để chữa lỗi này. RocketKey không khuyên dùng: chúng chạy code từ bên thứ ba trên máy bạn, chỉ được thử với một số phiên bản và bộ gõ, và bị ghi đè mỗi khi Claude Code tự cập nhật. Bốn cách ở trên an toàn hơn.

Câu hỏi thường gặp

Lỗi này có làm tốn thêm hạn mức không? Không. Ký tự gõ sai chỉ nằm trong ô nhập; chỉ nội dung bạn gửi đi mới được tính token.

Đổi API key hoặc đổi model có hết lỗi không? Không. Lỗi nằm ở phần nhập liệu của Claude Code, không phụ thuộc vào key hay model.

Codex, Cline, Cursor có bị không? Cline và Cursor có ô chat trong cửa sổ trình soạn thảo, thường nhận bộ gõ như ô văn bản bình thường. Nếu một công cụ dòng lệnh khác cũng bị, các cách 1, 2 và 4 vẫn áp dụng được.

Gặp lỗi khác với Claude Code? Xem Lỗi thường gặp hoặc Hỏi đáp.