5分钟上手claudish-to-englishmacOS快速安装教程Ollama本地AI配置全流程【免费下载链接】claudish-to-english项目地址: https://gitcode.com/gh_mirrors/cl/claudish-to-englishclaudish-to-english 是一个Claude Code 插件它调用Ollama 本地 AI 大模型把每条 AI 回复实时改写成大白话plain English且改写过程完全在本地进行对话内容不离开你的 Mac。本文是一份面向新手的macOS 快速安装教程带你从零完成 Ollama 本地 AI 配置到插件启用的全流程。 它是什么为什么需要 claudish-to-english用 Claude Code 写代码时AI 的回复常常术语密集、句式复杂。claudish-to-english 做的事很简单只改展示不改原文Claude 的推理过程和保存的记录都保留原文只有你在屏幕上看到的会多一份纯英文改写版display-only 设计本地 Ollama 驱动默认用 Ollama 上的本地模型做改写零网络请求、零隐私泄露失败即透明fail-open模型没就绪、服务宕机或超时插件会直接显示 Claude 的原始文本永远不会吞掉或损坏任何回答可选第二钩子还能在你写入或编辑 Markdown 文件时自动在旁边生成一份大白话版本默认关闭 一句话理解它是你屏幕上的实时翻译官专门把 AI 的黑话翻成人话。 macOS 安装前检查4 个依赖一次看全默认使用 Ollama 提供方时需要下面 4 样东西就位改用 Anthropic / OpenAI 云 API 则只需jq、curl和密钥依赖作用安装方式Ollama运行中在本地执行改写brew install ollama后运行ollama serve一个已拉取的模型实际的改写者ollama pull gemma4:26b-mlx约 17 GB按内存选模型jq解析钩子 JSONmacOS 15 自带否则brew install jqcurl与 Ollama 通信macOS 自带⚠️ 如果本地模型没就绪插件会原样显示 Claude 的输出——这是设计如此不是 bug。 Ollama 本地 AI 配置全流程3 步第 1 步安装并启动 Ollama在终端执行brew install ollama ollama serveOllama 服务默认监听http://localhost:11434插件会自动找到它。第 2 步拉取改写模型默认模型是gemma4:26b-mlx——Apple 芯片MLX专属构建在 Mac 上是最合适的选择但约占 17 GB 空间。如果你的内存较小可以拉一个更小的模型后面通过CLAUDISH_MODEL指给它ollama pull gemma4:26b-mlx第 3 步预热模型关键第一次调用是缓慢的冷加载先跑一句hi把模型暖起来ollama run gemma4:26b-mlx hi✅ 到这一步本地 AI 改写引擎已完全就绪。 安装插件2 条命令完成在 Claude Code 中输入/plugin marketplace add gvzdv/claudish-to-english /plugin install claudish-to-englishgvzdv-plugins如果安装摘要提示Run /reload-plugins to activate.执行该命令即可激活。不想安装先试用一次也可以用--plugin-dir参数单次会话加载不产生任何安装痕迹git clone https://gitcode.com/gh_mirrors/cl/claudish-to-english claude --plugin-dir /path/to/claudish-to-english插件加载不上时可打开/plugin命令的Errors标签页查看原因。⚙️ 插件配置settings.json 的 env 块安装后所有行为都由CLAUDISH_*环境变量控制推荐写在 Claude Code 的settings.json的env块中不要改插件缓存里的hooks/hooks.json更新时会被覆盖{ env: { CLAUDISH_MODEL: gemma4:26b-mlx, CLAUDISH_MODE: append } }放在~/.claude/settings.json可对所有项目生效。注意两点改完env要重启 Claude Code变量在启动时捕获env块不跨作用域合并优先级为 managed → local → project → user以最高优先级文件为准临时试一个模型也可以直接在启动命令前加变量CLAUDISH_MODELllama3.2:3b claude两种显示模式怎么选CLAUDISH_MODE屏幕效果适合场景append默认原文正常流式输出末尾追加 In plain English:改写块最稳妥推荐新手replace只展示简化版实验性一次性出现喜欢极简阅读体验 常用 CLAUDISH_* 参数速查表变量默认值说明CLAUDISH_ENABLED1总开关0 全部放行CLAUDISH_MODEappend展示策略append或replaceCLAUDISH_MODEL按提供方覆盖默认模型名CLAUDISH_PROVIDERollamaollama/anthropic/openai三选一CLAUDISH_TIMEOUT45展示钩子的 LLM 超时秒CLAUDISH_MIN_CHARS200短于该字数的消息/文件直接跳过CLAUDISH_DEBUG01 输出调试日志到$TMPDIR/claudish-to-english/CLAUDISH_NOTICE1改写被跳过时显示一次性提示0 完全静默CLAUDISH_MD_DIR未设置Markdown 钩子开关只改写该目录下的*.md 隐私提示切到anthropic/openai提供方后每条被改写的消息都会发送到对应云端 API。追求隐私就保持默认的 Ollama 本地模式。✍️ 进阶让 Markdown 文件也说人话可选插件自带第二个钩子 rewrite-md.sh当 AI 写入或编辑 Markdown 文件时自动在旁边生成一份大白话版本。它默认关闭按目录选择性启用CLAUDISH_MD_MODE结果特点sibling默认在NAME.md旁写出NAME.plain.md无损绝不动原文件推荐overwrite原地替换NAME.md会写入幂等标记防重复改写慎用{ env: { CLAUDISH_MD_DIR: /ABS/PATH/docs/plain, CLAUDISH_MD_MODE: sibling } }⏱ 大文件较慢默认模型改写速度约 60 tokens/s长文档可能需要 30–120 秒可换小模型或调高CLAUDISH_MD_TIMEOUT。 常见问题与调试技巧Q为什么屏幕上没有改写块A最常见原因是 Ollama 没启动或模型未拉取。插件会每个会话提示一次跳过原因设CLAUDISH_NOTICE0可静默。设置CLAUDISH_DEBUG1后查看$TMPDIR/claudish-to-english/debug.log可以看到钩子是否被触发。Q会话中途想临时关掉改写A创建一个标志文件即可下一条消息立即生效touch ~/.claude/claudish-off # 暂停改写 rm ~/.claude/claudish-off # 恢复Q改完 settings.json 不生效Aenv变量在启动时捕获重启 Claude Code后再试。Q换过提示词后行为怪异A自定义提示词文件CLAUDISH_PROMPT_FILE/CLAUDISH_MD_PROMPT_FILE会整体替换内置提示词记得包含保留事实、不碰代码块等指令文件为空或路径错误时会自动回退到内置默认不会中断改写。 项目结构一览文件职责rewrite.sh展示改写钩子核心逻辑缓冲分块 → 末尾一次调用模型rewrite-md.shMarkdown 文件改写钩子按目录 opt-inproviders.sh提供方层Ollama / Anthropic / OpenAI 统一封装hooks/hooks.json钩子注册表MessageDisplay / PostToolUseCHANGELOG.md版本变更日志README.md完整官方文档含 Windows 配置 收尾5 分钟回顾brew install ollamaollama serveollama pull gemma4:26b-mlx并ollama run预热/plugin install claudish-to-englishgvzdv-plugins需要时在settings.json的env块里调CLAUDISH_MODEL/CLAUDISH_MODE出问题CLAUDISH_DEBUG1看日志touch ~/.claude/claudish-off一键暂停至此一个离线、本地、隐私安全的大白话改写助手就常驻你的 Claude Code 了——AI 继续高效干活你只管轻松阅读。【免费下载链接】claudish-to-english项目地址: https://gitcode.com/gh_mirrors/cl/claudish-to-english创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考