
用 Claude Code 写代码时,我希望用熟悉的语言把需求说清楚,也希望能选择交给模型的语言。手动翻译当然可以,但每次都要复制、切换、再粘贴,长提示词里还夹着路径、命令和代码。
我把这一步做成了一个插件,叫 Claude Prompt Translator。输入照常写,提交前先调用你配置的翻译模型,再把译文交给 Claude Code。默认翻译成英文,也支持日文、简体中文和法文。项目仓库
目前已发布 v0.1.0,采用 MIT 许可证。接入流程是:安装插件、填翻译接口、选择目标语言。日常仍然直接运行 claude。
翻译发生在提交之前
插件处理的是你准备提交的提示词。流程可以画成一条线:
你的输入 → 保护路径和代码 → 外部模型翻译 → 还原检查 → Claude Code
例如,你输入下面这句话:
请检查 `src/auth.ts` 的登录逻辑,先列出问题,不要修改代码。
选择英文后,自然语言部分会翻译成英文,src/auth.ts 保持原样。这里的翻译模型只负责转换指令,执行任务仍由 Claude Code 完成。插件还会附带目标回复语言的指令,引导 Claude 用对应语言回答;它不会对已经生成的回答再做一次翻译。实现代码

这张手稿里也画出了失败分支。只要译文检查没有通过,本次提交就会停住。
两条命令安装
先确认 Claude Code 能正常运行。项目验证所用版本是 2.1.291;其他版本的兼容情况请以仓库说明为准。
在终端执行:
claude plugin marketplace add cfrs2005/claude-prompt-translator
claude plugin install prompt-translator@claude-prompt-translator
然后打开 claude。如果已经在会话里,执行 /reload-plugins 加载新安装的插件。安装入口和版本说明都在 README。
填好翻译接口,就能接入
在 Claude Code 中执行:
/plugin configure prompt-translator@claude-prompt-translator
配置页里主要填三项:
| 字段 | 填什么 |
|---|---|
| API URL | 完整的 OpenAI 兼容 chat/completions 接口地址 |
| Translation model | 该接口支持的模型 ID |
| API Key | 你自己的翻译服务密钥 |
API URL 要填到完整接口路径,只填域名或 /v1 不够。这里的 Key 用于翻译服务,Claude Code 继续使用原有的登录方式。通过配置页填写的 Key 会存入 Claude Code 的安全存储。
项目预填了 GLM 的地址和模型:
API URL: https://open.bigmodel.cn/api/coding/paas/v4/chat/completions
Translation model: glm-5.3-flash
Reasoning effort: low
有对应服务的可用 Key,就可以从这组配置开始。也可以换成自己的网关或其他兼容接口,同时修改地址和模型 ID。如果接口不接受 reasoning_effort,把 Reasoning effort 设为 default,插件就不发送这个字段。更多接入方式见 模型接入说明。
在配置中切换语言
在 /config 中找到插件的 Target language。当前支持四个选项:en 是英文,也是默认值;jp 是日文;cn 是简体中文;fr 是法文。
修改语言后会自动生效。输入语言会自动识别,不需要另外设置“从哪种语言翻译”。即使输入已经是目标语言,当前版本仍会调用翻译接口,并要求模型原样返回。语言配置说明
提交一句“请简要介绍这个项目”,就能检查接入是否正常。终端输入框上方会出现翻译状态,显示目标语言、模型名和已用时间。成功后会短暂显示译文预览,约 3 秒后收起;失败时会显示原因,并停止本次提交。提示框实现
一个实际踩坑:模型会改坏路径
开发时,我遇到过日文译文给文件路径加空格的问题。句子看起来翻译成功了,文件名却已经变了。对编程任务来说,这会让 Claude 查错位置,或者无法找到文件。
所以插件会先把识别到的路径、URL、行内代码和完整代码块替换成临时标记,翻译后再原样放回。还原时会检查标记是否完整;标记丢失、重复,或者译文被截断,本次提交都会停止。保护与还原逻辑
这里保护的是这些片段的原样保留。普通文字的翻译是否准确,仍取决于你选择的模型,重要需求可以先看译文预览。
多了一次调用,也多了一份数据流向
使用这个插件,每次需要翻译的提交都会增加一次模型调用,因此会多一点等待,也会消耗翻译服务的额度。提示词的自然语言正文会发给你配置的服务,选择接口时,需要确认它适合处理你的内容。接口与数据说明
以 !、/、# 开头的输入和空输入会直接放行。claude -p 也会经过翻译流程,但不会显示交互提示框。当前验证重点是 Claude Code 终端;完整 Windows 和 Claude Desktop 的视觉效果尚未验证。验证范围
我目前没有做“中文原文”和“英文译文”的任务效果对照,所以不会把它介绍成提高代码质量或节省 Claude 用量的工具。它提供的是一个明确的选择:保留自己的输入习惯,把提示词转换成希望使用的语言。
视频演示与项目入口
我录了一段实际使用演示,可以先看输入、翻译提示和回答的过程:Claude 多语言 Prompt 转换。
想试用的话,从 GitHub README 的安装步骤开始。仓库里有模型接入和故障排查说明;v0.1.0 Release 也提供安装 ZIP 和校验文件。遇到问题,可以在 Issues 里附上 Claude Code 版本、目标语言和报错信息,记得去掉 API Key。



