claudish-to-english 是一个 Claude Code 插件，用于把 Claude Assistant 的输出在屏幕上改写成更直白、易读的语言。默认使用本地 Ollama 模型进行改写，也支持 codex CLI、Anthropic API 以及 OpenAI 兼容 API。它是“仅显示层”的改写：Claude 原始回复和会话记录不会被修改，只改变用户在终端中看到的内容。插件采用 fail-open 设计，模型不可用、超时、缺少依赖或 API Key 时会自动显示原始输出，避免吞掉或破坏回答。它还提供可选的 Markdown 文件改写 Hook，可在写入或编辑 Markdown 时将内容改写为更通俗的表达。
适用领域
Claude Code 插件 / 开发者工具 / AI 辅助编程 / 本地 LLM 应用 / 文本改写 / 可读性增强 / 命令行工具 / Markdown 文档优化
配置难度
中等。普通 Claude Code 用户安装插件本身较简单，但要稳定使用默认本地 Ollama 模式，需要安装 Ollama、拉取合适模型、配置 jq/curl、处理 Windows Git Bash 和模型兼容问题。对熟悉命令行和本地 LLM 的开发者较容易，对新手需要一定调试成本。
商业价值
对个人开发者和团队的价值主要体现在提升 AI 编程助手输出的可读性和理解效率，减少阅读冗长技术解释的时间成本。对于中文开发者，可将 Claude Code 的输出改写为更清晰的中文或保持原语言简化，有助于降低语言和术语门槛。本地 Ollama 模式在隐私敏感场景有吸引力，适合企业内部研发环境试用。商业化价值偏向开发者体验增强、AI 工具链优化和知识文档可读性提升，但该项目本身是轻量插件，核心壁垒不高，更多适合作为 Claude Code 工作流中的效率组件，而非独立商业平台。
01
技术亮点
- 显示层改写，不修改 Claude 原始回复、推理内容和保存的 transcript，安全性较高。
- fail-open 设计可靠：provider 不可用、超时、模型缺失或依赖缺失时显示原始 Claude 输出，不会中断工作流。
- 默认支持本地 Ollama，适合注重隐私和离线处理的开发者。
- 同时支持 codex CLI、Anthropic API 和 OpenAI 兼容 API，部署方式灵活。
- 支持 append 和 replace 两种显示模式，既可对比原文与改写，也可只看简化结果。
- 提供 /claudish 交互命令，可在 Claude Code 会话中即时切换状态、模型、语言和风格。
- 支持语言跟随：如果 Claude 输出为非英语，改写也会保持同一语言；也可强制指定语言，例如简体中文。
- 支持 TLDR、ELI5 等简化风格，适合快速理解复杂技术解释。
- 提供 /claudish last，可在 replace 模式下重新查看上一条原始消息。
- 可选 Markdown Hook 能把 Markdown 文件内容改写为更通俗的表达，适合文档优化。
- MIT License，便于个人和商业环境使用。
- 项目 Star 数较高，说明该插件满足了 Claude Code 用户对输出可读性的实际需求。
02
目标用户
- 使用 Claude Code 的开发者
- 希望 Claude 回复更简洁、少术语的用户
- 非英语母语但经常阅读英文 AI 输出的开发者
- 希望在本地使用 Ollama 保护隐私的团队
- 需要把技术文档或 Markdown 内容改写得更易懂的工程师
- 对 Claude 输出风格不满意、希望获得 TLDR 或 ELI5 风格解释的用户
03
配置要求
- 默认 provider 为 ollama，需要本地 Ollama 服务运行在 localhost:11434，并且已拉取配置的模型。
- macOS 默认模型为 gemma4:26b-mlx，适合 Apple Silicon/MLX；Windows 不支持该默认模型，必须设置 CLAUDISH_MODEL 为普通非 MLX tag。
- 需要 jq 用于解析 Claude Code Hook JSON。
- 需要 curl 用于调用 Ollama 或 API。
- 建议在 Claude Code 的 settings.json 的 env 块中配置持久化环境变量，不要修改插件缓存目录中的 hooks/hooks.json，因为更新会覆盖。
- 常用配置文件位置包括 ~/.claude/settings.json、项目内 .claude/settings.json、项目内 .claude/settings.local.json。
- env 块不会跨 scope 合并，最高优先级 settings 文件中的 env 会作为完整 env 块生效。
- 修改 env 后需要重启 Claude Code，因为 Hook 子进程继承启动时的环境变量。
- 常用环境变量包括 CLAUDISH_MODEL、CLAUDISH_MODE、CLAUDISH_PROVIDER、CLAUDISH_LANG、CLAUDISH_STYLE、CLAUDISH_NOTICE、CLAUDISH_DEBUG 等。
- 如果使用 Anthropic provider 或 OpenAI 兼容 provider，需要配置对应 API Key、base URL 等变量，并确保 curl/jq 可用。
- 可通过 /claudish 命令在会话中动态控制 on/off、append/replace、language、model、style 等设置。
- 通过 /claudish 设置的覆盖项会写入 ~/.claude/ 下的状态文件，并且跨会话持久化，直到执行 /claudish reset 或对应 reset 操作。
- 调试时可设置 CLAUDISH_DEBUG=1，查看 $TMPDIR/claudish-to-english/debug.log。
- 可通过创建 ~/.claude/claudish-off 暂停改写，通过删除该文件恢复改写。
04
适用场景
- 将 Claude Code 的复杂、冗长、术语化输出改写成 plain language，提升阅读效率
- 在 Claude Code 中保留原始推理和 transcript，同时只修改屏幕显示内容
- 通过 /claudish append 同时查看原始回复和通俗改写版本
- 通过 /claudish replace 只显示简化后的版本，减少认知负担
- 通过 /claudish style tldr 获取更短的摘要式回复
- 通过 /claudish style 5y 获取类似“解释给五岁小孩听”的简化说明
- 将 Claude 输出固定改写为指定语言，例如简体中文、法语或其他语言
- 使用本地 Ollama 模型处理输出，降低将内容发送给第三方 API 的风险
- 使用 Anthropic 或 OpenAI 兼容 API 作为改写后端，避免本地模型部署成本
- 可选地在 Markdown 文件写入或编辑时自动改写为更通俗的文档内容
05
部署与配置
- 确保已安装 Claude Code，并具备插件安装能力。
- 如果使用默认 Ollama provider，先安装并启动 Ollama。
- macOS 示例：执行 brew install ollama，然后运行 ollama serve。
- Windows 示例：执行 winget install Ollama.Ollama，然后启动 Ollama 应用。
- 拉取可用模型。macOS Apple Silicon 默认示例为 ollama pull gemma4:26b-mlx；Windows 需要使用非 MLX 模型，例如 ollama pull gemma4:26b。
- 安装 jq。macOS 可使用 brew install jq；Windows 可使用 winget install jqlang.jq。
- 确认 curl 可用。macOS 和 Windows 通常自带。
- Windows 用户需要 Git Bash，因为 Hook 是 bash 脚本，Claude Code 会通过 Git Bash 运行。
- 预热模型，例如 macOS 执行 ollama run gemma4:26b-mlx "hi"，Windows 执行 ollama run gemma4:26b "hi"。
- 添加插件 marketplace：/plugin marketplace add gvzdv/claudish-to-english。
- 安装插件：/plugin install claudish-to-english@gvzdv-plugins。
- 如果安装摘要提示需要激活，执行 /reload-plugins。
- 也可以临时试用：claude --plugin-dir /path/to/claudish-to-english。
- 如果插件未加载，查看 Claude Code 的 /plugin Errors 标签页。
06
风险与注意事项
- 项目状态标注为 working prototype，仍属于原型阶段，可能存在兼容性和稳定性问题。
- 默认模型 gemma4:26b-mlx 体积较大，约 17GB，对内存、磁盘和 Apple Silicon 环境有要求。
- Windows 用户如果不覆盖默认模型，默认 MLX 模型无法运行，导致改写被跳过。
- 本地模型首次冷启动较慢，会影响首次响应体验。
- 改写后的内容可能改变语气、细节或技术精度；虽然 transcript 保留原文，但用户只看 replace 模式时可能漏掉关键信息。
- 如果使用云端 API provider，Claude 输出内容会被发送到第三方服务，需要考虑隐私、合规和成本。
- Hook 依赖 shell、jq、curl、Ollama/Git Bash 等外部组件，环境配置不当时容易出现跳过改写。
- 通过 /claudish 设置的覆盖会跨会话持久化，用户可能忘记当前处于某种语言、模型或 replace 模式。
- Markdown 自动改写功能如果启用，可能对文档内容造成非预期风格变化，需要谨慎用于代码仓库文档。
- 插件只改变显示层，不提升 Claude 本身推理质量；如果用户误以为改写内容就是原始精确输出，可能产生误解。
2026-08-23
第17名
新收录 · github_search
