claudish-to-english的LLM配置指南本地ollama还是云端三种提供商完整设置【免费下载链接】claudish-to-english项目地址: https://gitcode.com/gh_mirrors/cl/claudish-to-englishclaudish-to-english 是一个 Claude Code 插件它能用本地 LLM默认通过 ollama、Anthropic API或任意 OpenAI 兼容接口把 Claude 助手每条回复自动改写成通俗易懂的人话显示在终端里。它是纯展示型插件Claude 的原始推理和记录文件不变只有你屏幕上看到的内容被简化且所有环节都是失败开放——出问题时你永远能看到原文。下面用最少步骤讲清楚如何在这三种 LLM 提供商中做出选择并正确配置。配置入口都在 providers.sh 这一层两个 hook 脚本共用。三种提供商怎么选一张表看懂先用 providers.sh 里内置的默认值做个对照提供商端点API 密钥默认模型适合谁ollama默认http://localhost:11434不需要gemma4:26b-mlx重视隐私、配置了本地 AI 环境的开发者anthropichttps://api.anthropic.com/v1/messagesCLAUDISH_ANTHROPIC_KEY或ANTHROPIC_API_KEYclaude-haiku-4-5不想折腾本地模型的云端用户openaihttps://api.openai.com/v1/chat/completionsCLAUDISH_OPENAI_KEY或OPENAI_API_KEYgpt-5.6-luna有 OpenAI 密钥或跑着 LM Studio / vLLM 等本地兼容服务的用户选择口诀免费 隐私优先→ ollama内容完全不出本机无需任何密钥⚡零配置最快上手→ anthropic 或 openai只需jq、curl和一个密钥已有本地推理服务LM Studio、llama.cpp server、vLLM、OpenRouter→ 用openai提供商改一下地址即可接入。本地还是云端先弄清隐私边界这是切换前必须知道的一点对应 README 的 Privacy / egress 一节默认ollama提供商下改写完全在本地运行对话内容不会离开你的机器一旦设置为anthropic或openai每条被改写的助手消息如果开启了 Markdown 文件改写钩子还包括文件内容都会发送到对应云端 API。官方甚至专门警告如果你 shell 里本来就export了OPENAI_API_KEY或ANTHROPIC_API_KEY那么仅仅设置CLAUDISH_PROVIDERopenai或anthropic就会开始把内容发往云端——选择云端提供商本身就是同意开关请只在确认需要时切换。想避免误用公用密钥建议用插件专属的CLAUDISH_*_KEY变量。安装与配置入口settings.json 的 env 块安装方式/plugin marketplace add gvzdv/claudish-to-english /plugin install claudish-to-englishgvzdv-plugins所有配置通过CLAUDISH_*环境变量控制。不要去改插件自带的 hooks/hooks.json它位于只读插件缓存里更新即被覆盖正确做法是写进 Claude Code 的settings.json的env块{ env: { CLAUDISH_PROVIDER: ollama, CLAUDISH_MODEL: gemma4:26b-mlx, CLAUDISH_MODE: append } }几个新手容易踩的坑改完env后必须重启 Claude Code——变量在会话启动时读取运行中的会话不会生效env块不会跨作用域合并managed → local → project → user最高优先级的那个文件独占整个env想临时一次性切换直接在启动命令前加变量即可CLAUDISH_MODELllama3.2:3b claude。完整变量清单共 20 余个见 README 的 Configuration (env vars) 一节核心就是下面三种提供商配置里用到的那几个。提供商一ollama 本地模型配置适合不想付费、不想把代码对话内容传上云的用户。前提条件macOS 为例需要用途安装ollama 并运行中执行改写brew install ollama然后ollama serve一个已拉取的模型实际干活的模型ollama pull gemma4:26b-mlx约 17 GB按内存选模型jq解析 hook JSONmacOS 15 自带关键配置export CLAUDISH_PROVIDERollama export CLAUDISH_MODELgemma4:26b-mlx⚠️两个高频陷阱默认模型gemma4:26b-mlx是Apple 芯片专属MLX 构建Windows 上跑不了必须改用普通标签如gemma4:26b并通过CLAUDISH_MODEL指定否则所有改写会被静默跳过拉取后先预热一次首次调用有冷加载ollama run gemma4:26b-mlx hi。ollama 端点可用CLAUDISH_OLLAMA修改默认http://localhost:11434无需密钥。请求会带上think: false关闭隐式推理见 providers.sh因为对改写这种简单任务推理 token 只会拖慢速度。提供商二Anthropic 云端 API 配置不想维护本地模型时最省事的云端方案。前提条件仅需jq、curl和一个 API 密钥。export CLAUDISH_PROVIDERanthropic export ANTHROPIC_API_KEYsk-ant-... # 可选换模型 export CLAUDISH_MODELclaude-haiku-4-5细节说明密钥读取顺序CLAUDISH_ANTHROPIC_KEY优先回退到环境里的ANTHROPIC_API_KEY见 providers.shMessages API 要求显式指定输出上限插件用CLAUDISH_MAX_TOKENS控制默认 4096达到上限的改写会被整体丢弃而不是显示半成品并提示你调高该值端点默认https://api.anthropic.com可用CLAUDISH_ANTHROPIC_URL指向代理或网关。 注意如果你机器上的其他工具也依赖ANTHROPIC_API_KEY共用它会共享配额和速率限制建议给插件单独配一个CLAUDISH_ANTHROPIC_KEY。提供商三OpenAI 兼容端点配置最灵活这一档其实覆盖两种用法OpenAI 官方 API和任何兼容/chat/completions的服务。用法 AOpenAI 官方export CLAUDISH_PROVIDERopenai export OPENAI_API_KEYsk-... export CLAUDISH_MODELgpt-5.6-luna用法 B本地/自建兼容服务LM Studio、llama.cpp、vLLM、OpenRouter 等export CLAUDISH_PROVIDERopenai export CLAUDISH_OPENAI_URLhttp://localhost:1234/v1 export CLAUDISH_MODELqwen3-30b要点只有端点是api.openai.com时才强制要求密钥本地服务可以完全免密钥见 providers.sh对api.openai.com的请求会默认附带reasoning_effort: none避免 GPT-5.6 级别模型在简单改写上浪费推理 token自定义兼容 URL 则不带此字段部分本地服务会拒绝未知字段。如果你的模型连这个字段都不接受把CLAUDISH_OPENAI_EFFORT显式置空即可地址末尾的斜杠会被自动归一化.../v1与.../v1/等效。验证与故障排查插件永远不会吞掉回答无论选哪种提供商claudish-to-english 都遵守同一个契约fail-open模型不可达、超时、密钥缺失、模型未拉取……任何故障下你看到的都是 Claude 原文插件不会吞掉或破坏任何回答。排查时看两处会话内一次性提示某次改写被跳过时提供商挂了、超时、缺密钥屏幕会附加一行说明原因Markdown 钩子则用systemMessage每个会话提示一次设CLAUDISH_NOTICE0可彻底静默调试日志设CLAUDISH_DEBUG1然后观察$TMPDIR/claudish-to-english/debug.logWindows 下在 Git Bash 的临时目录可看到每次请求的提供商、模型、HTTP 状态与错误信息。另外还有两个实用开关会话中暂停touch ~/.claude/claudish-off创建标志文件即可即时暂停改写删除恢复不需要重启——这在 rewrite.sh 里逐条消息实时检查显示模式CLAUDISH_MODEappend默认原文流式显示后追加 In plain English: 块最安全或replace只显示改写版实验性。常见问题 FAQQ配置了提供商却一直没有改写依次检查ollama 是否在运行且模型已拉取ollama list→ 密钥变量是否真的在 Claude Code 启动环境中 →CLAUDISH_MODEL是否指向未下载的模型。设CLAUDISH_DEBUG1后日志会给出准确原因。QWindows 用户能直接用默认配置吗不能。默认模型是 MLX 构建仅限 Apple 芯片Windows 必须设置CLAUDISH_MODEL为普通标签且 hook 脚本依赖 Git Bash 运行。Q改写会影响 Claude 的实际输出吗不会。这是显示层插件rewrite.sh 只改屏幕呈现记录文件和 Claude 的推理内容保持原文。可选的 Markdown 文件改写钩子rewrite-md.sh会写文件但默认关闭需设置CLAUDISH_MD_DIR且仅限该目录内的*.md。Q输出太长被截断怎么办三种提供商下触及输出 token 上限的改写都会被整体丢弃显示原文 一次提示ollama 可提高模型num_predictAnthropic 调高CLAUDISH_MAX_TOKENSOpenAI 兼容服务则视其自身限制。总结三种配置的适用场景场景推荐提供商核心配置隐私敏感、本地已有 AI 环境ollamaCLAUDISH_MODEL选已拉取的模型想最快用起来、有现成密钥anthropic/openai对应*_KEY一个变量自托管推理服务openai加CLAUDISH_OPENAI_URL默认就是本地 ollama、零密钥、内容不出机器——先跑通默认配置再按上面的场景决定是否切换云端是最稳的上手路径。完整环境变量表超时、最小字数、调试、开关等 20 余项请查阅 README.md 的 Configuration (env vars) 章节。【免费下载链接】claudish-to-english项目地址: https://gitcode.com/gh_mirrors/cl/claudish-to-english创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考