如何让AI说人话：claudish-to-english——Claude Code大白话改写插件完整入门指南

如何让AI说人话claudish-to-english——Claude Code大白话改写插件完整入门指南【免费下载链接】claudish-to-english项目地址: https://gitcode.com/gh_mirrors/cl/claudish-to-englishclaudish-to-english 是一个免费的 Claude Code 插件它会把屏幕上每一条 AI 回答自动改写成通俗易懂的大白话帮你彻底摆脱满屏术语的AI腔。改写由本地模型默认 ollama完成内容不离开你的电脑且只改屏幕显示、不碰原始回答是新手让 AI 说人话的稳妥选择。一、它解决什么问题用过 Claude Code 的朋友都有体会回答又长又绕幂等性fail-openbackpressure这类术语扑面而来。claudish-to-english 做的事情很简单——原文照旧流式显示显示完成后自动在下方追加一段 In plain English:大白话版本。它有三个让人安心的设计只改显示不改内容Claude 的推理过程和历史记录保持原文只有你读到的屏幕内容变了失败即放弃fail-open模型没启动、超时、缺依赖……任何出问题的情况你都只会看到原文插件绝不会吞掉或搞坏回答本地优先默认用本地 ollama 模型改写对话内容一条都不出你的机器二、工作原理两个钩子各管一摊插件通过 hooks/hooks.json 注册了两个钩子钩子脚本干什么MessageDisplayrewrite.sh把每条 AI 消息改写成大白话显示在屏幕下方PostToolUserewrite-md.sh可选把写好的 Markdown 文件也改写成通俗版显示钩子的工作方式很巧妙Claude Code 每吐出一小段文字就触发一次事件插件先把所有片段缓存起来等整条消息完整后才调用一次模型改写见 hooks/hooks.json 的 60 秒超时配置同时把你最初的问题作为上下文传给模型确保改写不跑题。改写模型的选择逻辑集中在 providers.sh 中支持 ollama / Anthropic / OpenAI 兼容三种服务商。三、最快安装步骤1. 准备依赖默认 ollama 方案需求用途安装方式macOSollama 并正在运行本地改写引擎brew install ollama后执行ollama serve一个已拉取的模型实际干活的模型ollama pull gemma4:26b-mlxjq、curl解析/调用模型macOS 自带Windows 用户注意默认模型是 Apple 芯片专用MLX 版必须通过环境变量换成普通版模型详见 README.md 的 Windows setup 章节。装完后先热身一次首次调用模型加载较慢ollama run gemma4:26b-mlx hi2. 安装插件在 Claude Code 里执行/plugin marketplace add gvzdv/claudish-to-english /plugin install claudish-to-englishgvzdv-plugins如果提示Run /reload-plugins to activate照做即可。想先体验再安装也可以临时加载claude --plugin-dir /path/to/claudish-to-english四、两种显示模式怎么选模式屏幕效果适合谁append默认原文正常流式显示之后追加 In plain English:块求稳的新手推荐 ✅replace实验性只显示简化版原文被抑制想彻底净化屏幕的高级用户通过CLAUDISH_MODE切换。append 模式最安全就算改写失败你也只是少了个附加块原文分毫不差。五、把 Markdown 文档也改成大白话可选第二个钩子会拦截 Write/Edit 操作但默认是关闭的——只有你设置了CLAUDISH_MD_DIR指向某个目录后该目录下的*.md文件才会被改写sibling模式默认安全在旁边生成NAME.plain.md原文件一个字节都不动overwrite模式原地替换文件并写入防重复标记。弱模型可能把文档改歪谨慎使用。大文件改写较慢长文档约需 30~120 秒文件钩子专门放宽了超时上限逻辑见 rewrite-md.sh。六、模型与服务商配置默认走本地 ollama什么都不用配。想换模型或服务商在settings.json的env块里设置即可{ env: { CLAUDISH_MODEL: gemma4:26b-mlx, CLAUDISH_MODE: append } }服务商CLAUDISH_PROVIDER说明ollama默认本地运行数据不出机器无需密钥anthropic走 Claude Haiku API需 API Keyopenai任意 OpenAI 兼容端点含 LM Studio、vLLM 等本地服务⚠️隐私提醒切换云服务商后每条被改写的消息都会发送到对应 API。只在明确同意的情况下切换详见 README.md 的 Privacy 章节。改完env记得重启 Claude Code才生效不想改文件时也可以一次性启动CLAUDISH_MODELllama3.2:3b claude七、会话中一键暂停/恢复改写环境变量在会话启动时就冻结了但插件每条消息都会检查一个标志文件所以可以中途秒停touch ~/.claude/claudish-off # 暂停改写下条消息生效 rm ~/.claude/claudish-off # 恢复把它绑个快捷键就能在所有运行中的会话间一键切换非常顺手 八、常用环境变量速查完整清单见 README.md这里挑最关键的几个变量默认值作用CLAUDISH_ENABLED1总开关0 全部放行CLAUDISH_MODEappend显示模式追加 or 替换CLAUDISH_MODEL按服务商覆盖默认模型名CLAUDISH_MIN_CHARS200正文短于此字数直接跳过改写CLAUDISH_DEBUG01 输出调试日志排查利器CLAUDISH_PROMPT_FILE未设置自定义改写提示词文件想调整大白话的风格把 rewrite.sh 内置的默认提示词替换成你自己的文件即可写保留术语但加一句通俗解释这类规则都没问题。九、项目文件结构一览整个插件只有几个文件结构清晰好读claudish-to-english/ ├── hooks/hooks.json # 钩子注册两个事件各指一个脚本 ├── rewrite.sh # 屏幕显示改写钩子 ├── rewrite-md.sh # Markdown 文件改写钩子默认关闭 ├── providers.sh # 服务商层ollama/anthropic/openai 统一调用 ├── CHANGELOG.md # 版本变更记录 └── README.md # 完整官方文档想了解每个版本的演进可以看看 CHANGELOG.md。十、新手常见问题 ❓Q装完插件后什么反应都没有这是fail-open设计ollama 没启动、模型没拉取、请求超时……都会静默跳过并只在当次会话提示一次原因。先用CLAUDISH_DEBUG1看调试日志基本都能定位。Q改写会篡改我的回答或文件吗不会。显示钩子只动屏幕文件钩子默认关闭开启后sibling模式也绝不碰原文件即使改写输出被截断结果也会整体丢弃绝不会出现半句大白话。Q会不会泄露隐私默认 ollama 全程本地运行零外发。换成云服务商才会外发请三思。claudish-to-english 用最克制的方式解决了一个高频痛点让 AI 的输出可读性不再依赖你自己二次消化。本地运行、失败无损、随时可关——对新手来说这套大白话改写体验非常友好值得一试。【免费下载链接】claudish-to-english项目地址: https://gitcode.com/gh_mirrors/cl/claudish-to-english创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考