claude-code-vietnamese-fix

Fix Vietnamese input (Telex/VNI) for Claude Code CLI — supports npm and native binary (WinGet/direct download).

The Problem

Vietnamese users cannot type in Claude Code CLI. Characters get duplicated or garbled.

Expected: tôi → Actual: toôooi

Vietnamese IME (Unikey, OpenKey, EVKey) embeds \x7f (DEL) chars in input strings. Claude Code's input handler inserts the entire string as-is, causing duplicate/garbled output.

Quick Start

npx claude-code-vietnamese-fix

Then restart Claude Code.

Other install options

# Install globally
npm install -g claude-code-vietnamese-fix
claude-code-vietnamese-fix

# Clone and run
git clone https://github.com/tvtdev94/claude-code-vietnamese-fix.git
cd claude-code-vietnamese-fix
node patch-vietnamese-ime.js

How it works

The patch intercepts the existing \x7f detection point in Claude Code's input handler. It strips \x7f chars, inserts remaining chars one-by-one into the cursor state, then applies the final state atomically.

Works for both:

• npm install — patches cli.js directly
• Native binary (WinGet, direct download) — patches the embedded JS inside the Bun binary

Commands

Auto-patch After Updates

Claude Code updates overwrite the patch. Add a SessionStart hook to auto-patch on every session:

~/.claude/settings.json:

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup|resume|clear|compact",
        "hooks": [
          {
            "type": "command",
            "command": "npx claude-code-vietnamese-fix --silent"
          }
        ]
      }
    ]
  }
}

The script is idempotent — safe to run on every session start.

Restore

npx claude-code-vietnamese-fix --restore

Compatibility

Related

• Issue #3961 — Unicode Input Handling Fails for Vietnamese Characters
• Issue #7989 — Error typing Vietnamese Telex
• Issue #10429 — Vietnamese Input Not Working

License

MIT