Claude Code VS Code 简体中文补丁辅助工具

简体中文 | English

一键汉化 Claude Code VS Code，支持修改预览、自动备份、安全恢复、WSL、SSH 和 Windows。

这是一个非官方、安全可恢复的 Claude Code VS Code 扩展中文 UI 补丁工具。

本项目不包含、不分发 Claude Code 插件本体、修改后的 VSIX 或 Anthropic 源码。用户需要自行安装官方 Claude Code 扩展；工具只替换本地扩展中的可见 UI 文案，并保留经过哈希校验的原始备份。

安装与首次使用

1. 先安装官方 Claude Code for VS Code 扩展。
2. 从 VS Code Marketplace 安装本扩展，或在扩展面板搜索 Claude Code Zh-CN Patch Helper。
3. 打开命令面板（Ctrl+Shift+P），执行 Claude Code Zh-CN Patch: Apply Patch。
4. 核对目标目录和替换数量，确认应用补丁。
5. 执行 Developer: Reload Window 重新加载窗口。

也可以通过命令行安装：

code --install-extension shanjiancaofu.claude-code-zh-cn-patch-helper

默认会在 VS Code 启动后检查并补齐汉化，并在 Claude Code 安装或升级后重新应用。可在设置中关闭自动应用，也可以随时手动恢复原始文件。

效果预览

汉化前后对比

应用补丁效果

功能

• CLI 与 VS Code 命令共用同一套 TypeScript core
• 自动检测 VS Code、Remote SSH、WSL、Dev Container、Cursor、Windsurf、VSCodium 和 code-server
• 修改前 dry-run 预览
• 在扩展目录外创建带时间戳、SHA-256 校验的备份
• 恢复时校验路径、版本和文件哈希，避免误覆盖
• 提供状态检查和 JSON 补丁报告
• 默认在 VS Code 启动时、Claude Code 更新后自动补齐翻译（可在设置中关闭）
• 支持前置/内置/后置三阶段规则，以及自定义字符串和正则规则
• 保护 sendRequest / postMessage 的 IPC 协议标识符，避免误翻译破坏通信
• 从可信英文备份完整重新应用规则，删除旧规则后不会遗留旧译文
• 动态状态栏与自动失败提醒，可直接查看日志或打开设置
• 按稳定配置键翻译设置说明，降低上游英文调整造成的失配
• 提供参考翻译差异工具，区分缺失、冲突和疑似协议条目
• 不收集遥测，不上传文件，不读取用户项目代码

其他安装方式

源码直跑

git clone https://github.com/shanjiancaofu/claude-code-vscode-zh-cn.git
cd claude-code-vscode-zh-cn
npm install
npm run status
npm run dry-run
npm run apply

恢复英文原版：

npm run restore

查看最近报告：

npm run report

完整重新应用当前规则：

npm run reapply

审计参考翻译：

npm run compare:translations -- /path/to/reference/translations/built-in.json

指定非标准扩展目录：

npm run apply -- --target /path/to/anthropic.claude-code-version

安装 VSIX

普通用户可从 Releases 下载最新 .vsix，然后在 VS Code 中执行 Extensions: Install from VSIX...。

开发者构建：

npm install
npm run compile
npm run package

安装生成的 VSIX：

code --install-extension claude-code-zh-cn-patch-helper-0.2.1.vsix

随后打开 VS Code 命令面板，执行：

• Claude Code Zh-CN Patch: Apply Patch
• Claude Code Zh-CN Patch: Restore Original Files
• Claude Code Zh-CN Patch: Restore Before Uninstall
• Claude Code Zh-CN Patch: Check Status
• Claude Code Zh-CN Patch: Show Patch Report
• Claude Code Zh-CN Patch: Open Settings
• Claude Code Zh-CN Patch: Reapply Translation Rules

配置项

• claudeCodeZhCnPatch.customClaudeCodePath：手动指定 Claude Code 扩展目录
• claudeCodeZhCnPatch.showReportAfterPatch：操作完成后显示报告
• claudeCodeZhCnPatch.dryRunBeforeApply：应用前显示预览
• claudeCodeZhCnPatch.autoApplyOnStartup：启动后自动补齐翻译，默认开启
• claudeCodeZhCnPatch.autoApplyOnUpdate：Claude Code 安装或更新后自动补齐翻译，默认开启
• claudeCodeZhCnPatch.showNotifications：自动修改成功后显示通知
• claudeCodeZhCnPatch.claudeCodeExtensionId：通过 VS Code API 定位的扩展 ID
• claudeCodeZhCnPatch.preTranslationRules：内置翻译前执行的自定义规则
• claudeCodeZhCnPatch.postTranslationRules：内置翻译后执行的自定义覆盖规则

安全与备份

工具只允许处理经过清单校验的 anthropic.claude-code-* 目录，且当前只修改：

• extension.js
• webview/index.js
• package.json

备份和报告保存在 ~/.claude-code-zh-cn-patch/，不放入 Claude Code 或本工具的扩展目录。恢复前会验证当前文件哈希；若文件被其他程序修改，工具会拒绝强制覆盖。

卸载说明

卸载本工具不会自动撤销已经写入 Claude Code 目录的补丁。卸载前必须先执行：

Claude Code Zh-CN Patch: Restore Before Uninstall

源码用户执行：

npm run restore

更新日志

2026-09-03（v0.2.1，扩展名称中文化）

• 将扩展展示名称更新为 Claude Code zh-CN（中文汉化包）

2026-09-03（v0.2.0，自动化与自定义规则）

• 新增启动自动汉化和 Claude Code 更新监听，默认开启并允许在设置中关闭
• 新增前置/内置/后置三阶段翻译和自定义正则规则
• 新增 IPC 协议字符串保护、VS Code API 定位、状态栏入口与重新应用命令
• 新增可信备份完整重建、自动失败提醒、动态状态栏和配置键翻译
• 新增参考翻译差异工具，支持缺失、冲突和疑似 IPC 条目分类
• 延续外置备份、SHA-256 校验、增量更新和外部修改保护

2026-06-20（v0.1.2，Marketplace 展示优化）

• 新增原创 Marketplace 图标和协调的浅色展示背景
• README 优先展示 Marketplace 安装、首次应用补丁和重新加载步骤
• 中英文 README 同步优化，源码与 VSIX 调整为其他安装方式

2026-06-20（v0.1.1，适配 Claude Code VS Code 2.1.183）

• translations/zh-CN.json：共 1,431 条分组映射，覆盖 519 条不重复英文文案
  • ui：454 条 Webview UI 翻译
  • host：465 条扩展主程序与命令翻译
  • rawFragments：16 条动态模板片段翻译
  • package：496 条设置、命令和扩展清单翻译
• 补齐模型设置、终端提示、CLAUDE.md 提示和输入框快捷键等可见文案
• 增量更新补丁时沿用首次原始备份，恢复操作可完整还原英文文件
• 检测到补丁之外的文件改动时停止写入，避免生成不可信备份
• 新增增量更新与完整恢复自动化测试

2026-06-20（v0.1.0，适配 Claude Code VS Code 2.1.183）

• translations/zh-CN.json：共 1,422 条分组映射，覆盖 510 条不重复英文文案
  • ui：447 条 Webview UI 翻译
  • host：465 条扩展主程序与命令翻译
  • rawFragments：14 条动态模板片段翻译
  • package：496 条设置、命令和扩展清单翻译
• 支持修改 webview/index.js、extension.js 和 package.json 中的可见 UI 文案
• 新增 TypeScript 共享 Core，CLI 与 VS Code 命令共用检测、扫描、替换和恢复逻辑
• 新增 dry-run、状态检查、JSON 报告、外置时间戳备份和 SHA-256 安全恢复
• 新增 Windows、macOS、Linux、WSL、Remote SSH、Dev Container 等环境检测
• 新增 Apply、Restore、Restore Before Uninstall、Check Status 和 Show Report 命令
• 新增 GitHub Actions CI、标签触发 Release、VSIX 构建及 SHA-256 校验文件
• 新增 Bug、遗漏翻译 Issue 模板、PR 模板、贡献指南和安全说明

完整版本记录见 CHANGELOG.md。

文档

• 使用说明
• 兼容性
• 常见问题
• 参与贡献
• 截图与 GIF 规范

如果这个项目帮你解决了英文界面问题，欢迎点一个 ⭐ Star。它能帮助更多中文用户发现这个工具。

免责声明

本项目是非官方 Claude Code VS Code 插件中文 UI 补丁辅助工具。

本项目不包含、不分发 Claude Code 插件本体。本项目仅在用户主动确认后，对本地已安装的官方 Claude Code 扩展进行 UI 文案替换。

Claude Code 及相关商标归 Anthropic 所有。本项目与 Anthropic 无关，不代表官方立场，也未获得 Anthropic 官方认可。

License

本工具代码和社区翻译采用 MIT License。此许可证不适用于 Claude Code 插件本身。