claudish-to-english 是一个为 Claude Code 开发的插件。它的核心功能是在你与 Claude 对话时,用一个本地大语言模型(LLM)将 Claude 的回复实时“翻译”成通俗易懂的英文(plain English),同时不会修改对话的原始记录。
它的设计非常注重安全,采用了“故障开放 (fail-open)”原则:一旦本地模型出任何问题(如未启动、超时等),插件会直接跳过,让你看到 Claude 的原始回复,绝不会丢失或损坏任何内容。
特点
把 ASD-STE100(航空业通用的简化技术英语标准)作为灵感来源,是该项目的非常巧妙的切入点。ASD-STE100 本身有一套严格的词汇和语法规则,而开发者的思路很务实——既然规则变化不大,不如用 2026 年的方式,直接让本地 LLM 实时“意译”,省去了维护复杂规则库的麻烦。
作者在 Claude Code 里写了一个钩子,专门监听“消息显示”事件。Claude 每次输出内容,这个钩子就会把它发给本地 Ollama 上跑的 Gemma 4(你也可以换成别的模型),让模型用更简单的语言重写一遍,然后把改写后的内容显示在终端里。
需要注意几点:
- 这个插件不会改动任何 Claude 自己能看到的东西(比如推理过程、工具调用轨迹、它自己的回复)。它只是把改写后的版本显示给你看,完全不影响 Claude 的任何行为。
- 默认设置会把原文和改写版都显示出来,所以你随时可以对照原文。
- 还有个可选功能,你可以选择把指定文件夹里的 Markdown 文件也翻译成通俗英文。
- 只要你用的是 Ollama 跑的本地模型,所有数据都不会离开你的电脑。
- 这个插件已经提交到 Anthropic 的插件商店,正在审核中(现在暂时可以从我的 GitHub 仓库安装)。
工作原理
这个插件主要通过两个钩子(Hook)工作:
1. 消息显示钩子 (MessageDisplay Hook):这是核心功能。
* 它会监听 Claude 的回复流,等到完整的回复生成后,调用本地模型将其改写为通俗英文。
* 改写后的内容会显示在屏幕上,但原始对话记录保持不变。
* 它有两种显示模式:
* append (默认): 先显示 Claude 的原始回复,然后在末尾追加一个“通俗英语”版本。
* replace: 只显示改写后的简洁版本(实验性功能)。
2. Markdown 文件重写钩子 (PostToolUse Hook):这是一个可选功能。
* 它可以自动将 Claude 生成或编辑的 *.md 文件重写为通俗英文。
* 此功能默认关闭,需要通过设置环境变量来为指定目录开启。
* 它也有两种模式:
* sibling (默认): 生成一个 NAME.plain.md 的新文件,不修改原始文件。
* overwrite: 直接覆盖原始文件(请谨慎使用)。
如何安装
1. 前提条件:
* 安装并运行 ollama。
* 拉取一个模型(插件默认使用 gemma4:26b-mlx)。
* 确保系统有 jq 和 curl 命令。
2. 安装插件:
你可以直接从该仓库安装:
/plugin marketplace add gvzdv/claudish-to-english
/plugin install claudish-to-english@gvzdv-plugins
将来它也可能在 Anthropic 的社区市场中上架。
隐私与安全
* 完全本地运行:所有重写工作都通过本地的 ollama 进行,你的对话内容不会离开你的电脑。
* 故障开放:任何环节出错,插件都会安静地跳过,保证 Claude 的原始回复可见。
总的来说,claudish-to-english 是一个设计精巧、以安全和本地运行为首要目标的 Claude Code 插件,旨在帮助用户更好地理解 Claude 的回复。