为了彻底解决 Claude Code 在处理中文相关工作时出现的乱码、刷屏或文件编码双重损坏（Double-encoding）问题，必须从操作系统环境、终端配置和项目自身规范三个维度强制统一为 UTF-8 格式。

以下是确保 Claude Code 始终以 UTF-8 格式读写的最有效设置方法：

第一道防线：强制终端环境为 UTF-8

Claude Code 是命令行工具，其输出和对系统环境的感知极大程度上依赖于宿主终端的编码。

1. Windows 系统（最容易出现中文乱码）

Windows 默认使用本地代码页（如 GBK / CP936），这经常导致 Node.js 应用（如 Claude Code）在处理 I/O 时发生混淆。

• 永久开启系统级 UTF-8 (推荐)

1. 按 Win + R 输入 intl.cpl 打开“区域”设置。
2. 点击“管理”选项卡，再点击“更改系统区域设置”。
3. 勾选：“Beta 版：使用 Unicode UTF-8 提供全球语言支持”。
4. 重启电脑。（注意：这可能会让某些极老的国内软件显示乱码，但对现代开发环境极其友好）。

• 或者，在终端中强制使用 UTF-8
  如果你使用 PowerShell，可以在你的 PowerShell Profile ($PROFILE) 中加入以下代码，强制控制台使用 UTF-8 编码读写：

[console]::InputEncoding = [console]::OutputEncoding = New-Object System.Text.UTF8Encoding
$OutputEncoding = [console]::OutputEncoding

如果使用 CMD，确保在运行 Claude Code 前执行 chcp 65001。

2. macOS / Linux 系统

Unix 系统的终端默认较好，但必须确保 LANG 和 LC_ALL 环境变量没有被错误配置。
在你的 ~/.zshrc 或 ~/.bashrc 文件末尾添加：

export LANG="zh_CN.UTF-8"
export LC_ALL="zh_CN.UTF-8"

保存后执行 source ~/.zshrc 即可生效。

第二道防线：配置 Node.js 强制以 UTF-8 运行

Claude Code 底层是基于 Node.js 运行的（通常通过 npx 或全局安装调用）。你可以通过设置环境变量，强制 Node.js 在读写文件和输出控制台时使用 UTF-8，彻底禁用本地编码回退。

在操作系统的环境变量中，新增一个系统级变量：

• 变量名：NODE_OPTIONS
• 变量值：--use-openssl-ca --icu-data-dir=node_modules/full-icu（其实最直接的是依赖系统环境，但如果你想强迫 Node 不猜编码，可以尝试注入类似选项，不过对于现代 Node 来说，最核心的是设置好环境变量）。

更直接有效的做法是设置系统环境变量强制 C 运行库的编码处理：

• 变量名：PYTHONIOENCODING （虽然 Claude Code 是 Node，但如果它底层调用了 Python 脚本解析某些文件，加上这个会安全很多）
• 变量值：utf-8

第三道防线：在项目中引入 .editorconfig 规范

Claude Code 会读取和修改你的项目文件。如果你的代码文件本身是 GBK 编码，Claude Code 写入时可能会用 UTF-8 覆盖，直接导致文件永久损坏。

在你的项目根目录下创建一个名为 .editorconfig 的文件，填入以下内容。绝大多数现代编辑器和部分 AI 工具都会识别该文件：

root = true

[*]
charset = utf-8
end_of_line = lf
insert_final_newline = true
trim_trailing_whitespace = true

排查警告：运行 Claude Code 之前，请务必确保项目中现有的中文文件已经是 UTF-8 (无 BOM) 格式。如果原来是 GBK，请先用 VS Code 右下角的编码选项，将其重新保存为 UTF-8。

总结检查清单：

1. 查系统：是否开启了 UTF-8 (Windows) 或设置了 LC_ALL=zh_CN.UTF-8 (Mac/Linux)？
2. 查终端字体：是否使用了支持中文和编程连字的等宽字体（如 Fira Code, JetBrains Mono）？缺失字体会导致部分字符显示为空白方块。
3. 查项目文件：项目内所有的源码、Markdown、JSON 文件是否全部已转换为 UTF-8？