_{纯自然语言的翻译示例，实际措辞由你选择的翻译模型决定。}

• 用中文交流：中文提示词和提问对话框中自行输入的中文回答会先译成英文；Claude 的英文回答可显示中文译文。
• 译好再发送：需要翻译的输入，译文通过检查才提交；失败时不会自动改发中文原文。
• 随时对照原文：查看提示词实际发送的版本，或切回 Claude 的原始回答。
• 自选翻译服务：使用兼容 OpenAI Chat Completions 接口的服务，不改变 Claude 会话使用的模型。

命令、思考过程和普通工具输出不翻译；代码、路径等内容保持原样。详见翻译范围。

为什么需要它

1 · 你懂的

2 · 更省 token

_{点击图片查看原图。}

上图比较了同一内容的不同语言版本，经各模型的 tokenizer 分词后，token 数相对英文版本的倍数（英文为 1×）。在这组测试中，Anthropic（Claude）的中文 token 数约为英文的 1.65×，也就是多约 65%。

图表来源：Aran Komatsuzaki 的原帖。

把中文提示词译成英文再发送，就是为了降低这部分输入的 token 开销，同时保留中文输入和阅读体验。实际节省量取决于文本和模型，翻译服务本身也会产生用量。

快速开始

你需要一个支持 Mods 的 Claude Code 交互式终端或 Desktop 会话，以及可用的翻译服务、模型和 API 密钥（如需）。无需单独安装 Node.js、执行构建或启动辅助服务。

1 · 安装插件

在系统终端运行：

claude plugin marketplace add againest1/bilingual-view
claude plugin install bilingual-view@bilingual-view

启动新的 Claude Code 会话；已打开的终端会话也可以运行 /reload-plugins。输入框上方出现 Bilingual View 设置栏，即可继续配置。

也可以手动安装。

2 · 开启自动更新（推荐）

建议通过 Marketplace 安装后开启自动更新，以便及时获得本 Mod 的修复和改进。 第三方市场默认不会自动更新，需要手动开启：

1. 在 Claude Code 会话中运行 /plugin，打开插件管理器。
2. 切换到 Marketplaces 页面，选择 bilingual-view。
3. 选择 Enable auto-update（启用自动更新）。

开启后，Claude Code 会在会话启动后检查并更新该市场中已安装的插件。收到更新提示后，启动新会话，或在已打开的终端会话中运行 /reload-plugins，即可加载新版。手动更新方式见更新与卸载。

3 · 配置翻译服务

点击 Settings（设置），或运行 /bilingual-view settings：

需要翻译的文本会发送到这个服务。模型列表不可用时，可直接填写 Model ID。

设置栏会显示当前翻译模型和思考强度，例如 Bilingual View · my-model(low)。

默认使用 low 思考强度。若服务不支持此参数，可在 Effort 中选择 Provider default（服务默认）。

API key 由 Claude 保存；输入时可见，保存后只显示是否已设置。更多说明见配置指南。

4 · 开始使用

点击 Test connection（测试连接），确认示例翻译成功。该请求发送到你配置的翻译服务，不会成为 Claude 会话中的消息。

翻译默认开启。确认设置栏为 On 后，像平常一样输入中文提示词：翻译成功并通过检查后，英文译文会提交给 Claude，界面保留你的中文原文供你阅读。若翻译失败，本次输入不会提交，修正设置或重试即可。

日常使用

关闭翻译后，输入会按原样提交，消息也会显示原文。 重新开启不会补译已经发送给 Claude 的中文。查看已发送文本是在提交之后，提交前没有译文预览。

翻译范围

例如，/statusline 加入 sessionID 会原样提交；将按钮文字改为“提交” 会翻译指令，但保留 “提交”。

「译好再发送」依靠发送前的翻译检查：未配置服务、翻译失败或译文中仍残留本应翻译的中文，都会阻止提交。这项检查只适用于需要翻译的输入。上表中原样提交的内容不受限制。显示译文不会改写会话历史，也不强制 Claude 用英文回答。

完整的输入来源、文本保留和显示规则见输入翻译范围与中文显示范围。

常见问题

先确认 Claude 宿主支持 Mods。在 /plugin → Installed 中确认 bilingual-view@bilingual-view 已安装并启用，再启动新会话，或在终端会话中运行 /reload-plugins。手动安装请核对安装目录。

用 /bilingual-view check 检查 URL、密钥和模型。Provider URL 应包含服务要求的 API 路径前缀；服务没有模型列表接口时，直接填写 Model ID。

翻译超时也是失败原因之一：单次翻译请求的超时时间为 30 秒（30s）。 /bilingual-view check 只翻译一条简短示例，即使检查正常，实际翻译仍可能超时。可用 /bilingual-view speed 测试长文本翻译速度；遇到超时可重试或换用响应更快的翻译模型。

输入翻译失败时不会提交。显示翻译失败时仍可阅读原文，并点击 Retry translation（重试翻译）。详见失败处理。

翻译覆盖的是特定输入和显示内容。命令、保留文本及其他上下文可能含中文；中英混合的自然语言消息、思考过程和普通工具结果不会自动翻译。可用 View sent text 核对已翻译提示词实际提交的版本，再对照翻译范围。

保存在本机的 ~/.claude/bilingual-view/cache/，与 Claude 会话历史分开。每个会话最多 4 MiB，达到上限时较早的记录可能被移除。更新和卸载插件都不会主动清除缓存。

删除缓存会丢失已保存的中文原文；重新翻译无法还原最初的准确措辞。同一会话请勿同时在多个 Claude Code 实例中使用。详见数据与翻译缓存。

更多说明

完整使用指南 · 问题反馈与诊断 · 更新与卸载 · 清理翻译缓存 · 全部命令

许可证

本项目采用 MIT License。