[DOCS] Missing Documentation for CJK Character Support in Terminal Configuration Guide

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

Terminal configuration optimization for Chinese, Japanese, and Korean (CJK) languages.

Current Documentation

The "Optimize your terminal setup" guide covers themes, line break shortcuts (Shift+Enter/Option+Enter), notifications, handling large inputs, and Vim mode. However, it contains no mention of CJK character handling, IME (Input Method Editor) support, or specific terminal settings required to prevent text misalignment in these languages.

What's Wrong or Missing?

The Claude Code changelog (specifically versions 2.1.0, 2.0.68, and 1.0.29) documents several critical fixes and features for CJK users that are completely absent from the official documentation:

• v2.1.0: Fix for extra blank lines in multiline prompts containing CJK characters.
• v2.0.68: Fixed IME support by correctly positioning the composition window at the cursor.
• v2.0.68: Fixed Option+Arrow word navigation for CJK text sequences.
• v1.0.29: Initial improvements for CJK character support in cursor navigation and rendering.

A user reading the "Optimize your terminal setup" guide would not know that these features exist or how to properly configure their terminal to ensure these fixes work (e.g., ensuring UTF-8 encoding or specific font-width settings).

Suggested Improvement

Add a new section titled "CJK Character Support" to the https://code.claude.com/docs/en/terminal-config page with the following content:

---

CJK Character Support

Claude Code includes specialized support for Chinese, Japanese, and Korean (CJK) characters. To ensure the best experience:

• IME Support: Claude Code automatically attempts to position the IME (Input Method Editor) composition window at the cursor. If you experience misalignment, ensure your terminal is updated to the latest version.
• Encoding: Ensure your terminal's character encoding is set to UTF-8.
• Ambiguous-Width Characters: If text or the cursor appears misaligned, check your terminal settings for "Ambiguous-width characters" and try toggling them to "Wide."
• Navigation: Claude Code supports word-boundary navigation (Option+Arrow) for CJK text sequences.

Impact

High - Prevents users from using a feature

Additional Context

• Related Documentation: This issue impacts the utility of the "Optimize your terminal setup" guide for a significant portion of the developer community.
• Changelog Reference: The fixes are noted in the version history but not the "how-to" guides.
• Example of Good Documentation: The documentation for modern terminals like Ghostty or iTerm2 often has specific sections on CJK/Unicode rendering which Claude Code users could benefit from seeing mirrored in the context of this CLI tool.