[DOCS] Terminal docs omit pasted Korean/CJK mojibake recovery guidance

Open 💬 0 comments Opened Jun 23, 2026 by coygeek

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/terminal-config
https://code.claude.com/docs/en/troubleshooting
https://code.claude.com/docs/en/interactive-mode

Section/Topic

Terminal paste troubleshooting for Korean/CJK text, mojibake, and terminals that deliver paste as per-byte extended-key events.

Current Documentation

The troubleshooting docs have a garbled-text section, but it is about editor integrated terminal rendering:

Garbled or corrupted text in an editor's integrated terminal

Local evidence: docs/code.claude.com/docs/en/troubleshooting.md

Terminal configuration docs include tmux extended-key guidance and paste guidance, but do not mention Korean/CJK pasted text, mojibake, or per-byte extended-key paste events.

The interactive mode docs document paste mode and image paste, but not text paste encoding issues.

What's Wrong or Missing?

Claude Code v2.1.187 fixed pasted Korean/CJK text turning into mojibake in terminals that deliver paste as per-byte extended-key events.

The likely user-facing troubleshooting pages do not mention this symptom, affected terminal behavior, or the version where the issue was fixed. Users who hit garbled Korean/CJK pasted text may not know to upgrade Claude Code.

Suggested Improvement

Add a short troubleshooting note under Terminal configuration or Troubleshooting:

If pasted Korean, Chinese, Japanese, or other CJK text appears as mojibake in Claude Code, upgrade to Claude Code v2.1.187 or later. Earlier versions could mishandle terminals that deliver paste input as per-byte extended-key events.

If there are known terminal-specific settings that influence this path, include them alongside the existing extended-key guidance.

Impact

Medium - Makes feature difficult to understand

Additional Context

v2.1.187 changelog context: Fixed pasted Korean/CJK text turning into mojibake in terminals that deliver paste as per-byte extended-key events.

Duplicate search found no open issue for paste, Korean, CJK, mojibake, Unicode, extended-key, or per-byte paste behavior.

View original on GitHub ↗