沉浸式翻译(Immersive Translate)接入 QCode 图文教程(Windows 11 一步一图)
跟着 11 步、11 张截图,在 Windows 11 的 Edge 或 Chrome 浏览器中装好沉浸式翻译 1.35.4,接入 QCode 并配置 gpt-6.2-sol,打开英文网页一键获得中英对照译文。
需要 API Key? 前往注册 →端点与 Base URL →
照着下面 11 步做,你会在 Windows 11 的浏览器里装好「沉浸式翻译」扩展并接通 QCode,打开任意英文网页一键获得中英双语对照译文。
一句话答案:在浏览器里装好「沉浸式翻译」1.35.4 扩展后,点工具栏图标进入「设置」→「翻译服务」→「其他/自定义」→「OpenAI 1」→「配置」,填入 QCode 的 cr_ 密钥,勾选「输入自定义模型名称」填 gpt-6.2-sol,把「自定义 API 接口地址」改为 https://api.qcode.cc/openai/v1/chat/completions,测试通过后设为默认即可。
| 项 | 填写 |
|---|---|
| 翻译服务 | OpenAI 1 |
| 自定义 API 接口地址 | https://api.qcode.cc/openai/v1/chat/completions |
| 自定义模型 | gpt-6.2-sol |
| APIKEY 格式 | cr_xxxxxxxx |
| 每秒最大请求数 | 5 |
核对于 2026-11-22 · Immersive Translate 1.35.4 · Windows 11
「沉浸式翻译(Immersive Translate)」是一款双语对照网页翻译浏览器扩展,支持在英文段落下方实时插入中文译文,方便对照阅读技术文档、新闻和论文。使用自己的 QCode API 密钥接入「OpenAI 1」服务时,无需登录沉浸式翻译账号,也无需开通 Pro 会员。
下载与安装¶
沉浸式翻译是浏览器扩展,没有独立的 .exe 安装包,也不在 winget 或 Windows 应用商店中分发。在浏览器扩展商店直接安装不会触发 Windows SmartScreen 拦截,也不需要管理员权限。
官方安装入口:
- 官方安装说明:immersivetranslate.com 安装指南
- Microsoft Edge 扩展商店(本教程截图所用方式):Edge Add-ons 沉浸式翻译
- Chrome 应用店:Chrome Web Store 沉浸式翻译
- Firefox 附加组件:Firefox Add-ons 沉浸式翻译
- 离线压缩包(备用):GitHub Releases
不同地区的网络环境略有差异,先选你所在的地区:
- 推荐方式(最省事):直接用 Windows 11 自带的 Microsoft Edge 打开 Edge 扩展商店,点击「获取」→「添加扩展」即可完成,无需额外配置网络。
- Chrome 用户离线安装:如果 Chrome 应用店打不开,先到 GitHub Releases 下载对应浏览器的压缩包并解压到一个固定文件夹(请勿从第三方网站下载
.crx文件)。接着在 Chrome 地址栏输入chrome://extensions,打开右上角「开发者模式」,点「加载已解压的扩展程序」并选中刚解压的文件夹。加载时页面出现的「开发者模式」提示属于正常现象。
- Microsoft Edge:打开 Edge 扩展商店,点击「获取」→「添加扩展」。
- Google Chrome:打开 Chrome 应用店,点击「添加至 Chrome」→「添加扩展程序」。
- Firefox:打开 Firefox 附加组件页 按提示添加。
跟着截图做:Windows 一步一图¶
下面 11 步以 Windows 11 自带的 Microsoft Edge(简体中文界面)为例,Chrome 的后续配置界面完全一致。每步只做一件事,截图上的橙色编号和正文里的 ①②③ 一一对应。
打开扩展商店并点击「获取」¶
用 Microsoft Edge 打开 Edge 扩展商店的「沉浸式翻译」页面,核对页面标题和版本后,点击 ① 指向的蓝色「获取」按钮(如果使用 Chrome 应用店,这个按钮叫「添加至 Chrome」)。

做对了你会看到:浏览器顶部弹出一个确认小窗口,询问是否将沉浸式翻译添加到 Microsoft Edge。
卡住了?页面顶部出现 Cookie 提示条,或用的是 Chrome
首次访问微软扩展商店时,顶部可能出现「接受 / 拒绝 / 管理 Cookie」提示条,点「拒绝」或「接受」关掉即可,不影响安装。如果你习惯用 Chrome 且打不开 Chrome 应用店,可先按上面 下载与安装 的「中国大陆」选项卡操作,或直接换用 Edge。
在确认弹窗里点击「添加扩展」¶
在浏览器顶部弹出的权限确认框中,点击 ① 指向的「添加扩展」按钮(Chrome 浏览器里叫「添加扩展程序」)。浏览器会自动在后台下载并完成安装,无需弹出 Windows 安装向导。

做对了你会看到:等待几秒后,浏览器自动新开一个「探索沉浸式翻译更多功能」欢迎标签页,同时右上角出现安装完成提示。
把沉浸式翻译固定到工具栏¶
安装完成后会自动打开欢迎页;如果右上角弹出「现已安装」提示气泡,点它的关闭按钮关掉即可。接着点击地址栏右侧 ① 指向的拼图「扩展」图标展开列表,再点击「沉浸式翻译」右侧 ② 指向的显示/固定图标,把它固定到浏览器工具栏上(Chrome 里这个按钮是图钉样式)。

做对了你会看到:地址栏右侧常驻出现「沉浸式翻译」的图标,以后不用每次再点拼图图标去找它。
打开扩展面板并进入「设置」¶
点击刚刚固定在工具栏上 ① 指向的「沉浸式翻译」图标,会弹出快捷面板。面板顶部显示「未登录」没有关系,不需要注册或登录沉浸式翻译账号;直接点击面板左下角 ② 指向的「设置」。

做对了你会看到:浏览器打开一个新的设置标签页,左侧是导航菜单,右侧是配置项。
找到「OpenAI 1」并点击「配置」¶
在设置页左侧的「服务及能力」下,确认选中 ① 指向的「翻译服务」。把右侧「翻译服务列表」一直向下滚动到底部的「其他/自定义」分组,找到 ② 指向的「OpenAI 1」(没有 Pro 会员限制),然后点击它右侧 ③ 指向的「配置」按钮。

做对了你会看到:页面右侧滑出「翻译服务配置」抽屉,里面依次列出「APIKEY」「模型」「自定义 API 接口地址」等输入框。
卡住了?看到的设置页布局和截图略有不同
1.35.4 在新装后可能会进入旧版设置页或新版设置页,但入口都在左侧菜单的「翻译服务」里;找到 OpenAI 对应的配置项点击进入即可。新版设置页左下角也提供切换到「旧版设置页」的入口。注意不要误选「自定义接口翻译」,那是另一种独立协议的入口。
填入 QCode 密钥、自定义模型与接口地址¶
在右侧滑出的「翻译服务配置」抽屉里,所有必填项都在同一屏,不需要再展开隐藏菜单。按顺序填好下面三处:
- 在 ① 指向的「APIKEY」输入框里粘贴你的 QCode 密钥(格式为
cr_xxxxxxxx,输入框默认以圆点隐藏内容,点右侧小眼睛可核对); - 勾选 ② 指向的「输入自定义模型名称」复选框,下方下拉框会切换成文字输入框,填入
gpt-6.2-sol; - 把 ③ 指向的「自定义 API 接口地址」里的默认地址清空,改为完整地址:
https://api.qcode.cc/openai/v1/chat/completions
全部填完后,在抽屉空白处点一下让输入框失焦,配置会自动保存(本版本没有单独的「保存」按钮)。

做对了你会看到:「APIKEY」框里已显示隐藏圆点,「输入自定义模型名称」已打勾且下方为 gpt-6.2-sol,接口地址完整显示 https://api.qcode.cc/openai/v1/chat/completions。
卡住了?找不到 gpt-6.2-sol 或填了 Claude 型号
「模型」下拉框里默认只列了旧型号,必须先勾选「输入自定义模型名称」才能手填 gpt-6.2-sol。另外,「OpenAI 1」走的是 OpenAI 兼容协议,这里不能填 Claude 型号;如果想用 claude-opus-5-5,请改在「其他/自定义」分组里的「Claude 1」中配置。
点击「点此测试服务」验证连通¶
确认刚填的输入框已经失焦保存,再点击抽屉顶部右侧 ① 指向的「点此测试服务」按钮。等待 1–3 秒,看到按钮左侧 ② 指向的位置出现绿色的响应延迟数字(单位为 ms),就说明 QCode 接口已经打通。

做对了你会看到:「点此测试服务」左侧出现绿色的毫秒数(如几百到两千多 ms),页面没有任何红色报错。
卡住了?提示「错误原因:连接失败」或 401
按顺序核对三件事:1)填完接口地址后先点击抽屉空白处让输入框失焦,等 1 秒再点「点此测试服务」,避免请求仍发向默认地址;2)核对「APIKEY」是完整的 cr_ 密钥且前后没有空格;3)中国大陆网络若连接默认节点较慢,可把接口地址换成亚洲节点 https://asia.qcode.cc/openai/v1/chat/completions。
核对「每秒最大请求数」¶
在同一个「翻译服务配置」抽屉里继续向下滚动,找到 ① 指向的「每秒最大请求数」设置项,确认右侧 ② 指向的数值框里是 5(1.35.4 默认值已经是 5,无需手动修改,改动也会自动保存)。如果你之后翻译超长网页或电子书时遇到限流提示,可以回到这里把数字调低到 2 或 3。

做对了你会看到:「每秒最大请求数」右侧数字为 5(或你按需调低的更小整数)。
将「OpenAI 1」设为默认翻译服务¶
点击右上角的关闭按钮关闭配置抽屉,回到「翻译服务列表」。找到底部的 ① 指向的「OpenAI 1」这一行,点击它右侧原本显示为「设为默认」的按钮;点完后 ② 指向的位置会变成「当前默认」,最右侧的启用开关也会自动打开。

做对了你会看到:「OpenAI 1」一行显示「当前默认」,以后在任意网页点击翻译都会默认通过 QCode 请求模型。
打开英文网页并点击「翻译 (Alt+A)」¶
新开一个标签页访问任意英文网页(例如 Python 官方文档或英文新闻页),如果浏览器自带「翻译英语页面?」弹窗,先关掉它。接着点击工具栏上的「沉浸式翻译」图标,确认面板中部 ① 指向的翻译服务已显示为「OpenAI 1」,然后点击 ② 指向的「翻译 (Alt+A)」按钮(以后也可以直接在网页上按快捷键 Alt+A 触发)。

做对了你会看到:扩展面板里翻译服务为「OpenAI 1」,点击「翻译 (Alt+A)」后按钮进入翻译状态。
查看中英双语对照译文¶
稍等几秒,在网页空白处点一下收起面板,就能看到完整的中英双语页面:① 指向的英文原文段落保留不动,紧跟在它下面 ② 指向的位置已经自动插入了流畅的中文译文,且页面没有任何红色报错。

做对了你会看到:英文标题与正文各段落下方都成对出现中文译文;再次按 Alt+A 可以随时切换回纯原文。
验证成功¶
四件事都对上,就说明沉浸式翻译已经完整接通 QCode:
- 设置页「翻译服务列表」里,「OpenAI 1」显示为「当前默认」,抽屉内的自定义模型为
gpt-6.2-sol,自定义 API 接口地址为https://api.qcode.cc/openai/v1/chat/completions; - 在「OpenAI 1」抽屉点击「点此测试服务」,按钮左侧返回绿色
ms延迟数字; - 打开任意英文网页点击「翻译 (Alt+A)」,数秒内生成中英双语对照译文且无红色报错;
- 打开 probe.qcode.cc,输入同一把
cr_密钥并点击查询,能看到刚才对应时间、状态为200的请求记录。
全部完成¶
你已经在 Windows 11 浏览器里装好沉浸式翻译并接通了 QCode。以后遇到任何英文文档或网页,按一下 Alt+A 就能中英对照阅读。接下来可以:
常见报错¶
| 报错原文 | 原因 | 怎么办 |
|---|---|---|
错误原因:连接失败 |
填完「自定义 API 接口地址」后未失焦保存就直接点击「点此测试服务」,请求仍发往默认官方地址;或当前网络访问默认节点超时 | 填完 https://api.qcode.cc/openai/v1/chat/completions 后先点击抽屉空白处失焦并等约 1 秒,再点「点此测试服务」;大陆网络仍超时时改用 https://asia.qcode.cc/openai/v1/chat/completions |
model_not_available_on_endpoint |
在「OpenAI 1」中填写了 Claude 型号,而 QCode 的 OpenAI 兼容端点不接受 Claude 模型 | 在「OpenAI 1」中将自定义模型改为 gpt-6.2-sol(或 gpt-6.2-astra);如需使用 claude-opus-5-5,改到「其他/自定义」分组下的「Claude 1」配置并指向 https://api.qcode.cc/api |
429 / 请求过于频繁 |
长网页或电子书一次性并发翻译段落过多,触发请求频率限制 | 打开「OpenAI 1」配置抽屉,向下滚动找到「每秒最大请求数」,保持在 5 或进一步调低到 2–3 后重试 |
HTTP 403 |
部分网络环境下直接下载离线 zip 直链被拒绝访问 | 在 Windows 11 上直接通过 Microsoft Edge 扩展商店一键安装;确需离线安装时改用官方 GitHub Releases 压缩包在扩展管理页加载 |
常见问题¶
密钥到期后怎么办?¶
分两种情况处理:
- 个人套餐的密钥到期后不能续,只能重新开通、换一把新密钥;
- 按量包的密钥到期后再买一个包,同一把密钥会自动恢复。
如果更换了新密钥,打开沉浸式翻译「设置」→「翻译服务」→「OpenAI 1」→「配置」,把「APIKEY」输入框替换为新的 cr_ 密钥并点击空白处失焦自动保存即可。
需要登录沉浸式翻译账号或开通 Pro 会员吗?¶
不需要。点击工具栏图标后即使顶部显示「未登录」,也可以直接打开「设置」→「翻译服务」,在底部「其他/自定义」分组里找到「OpenAI 1」(无 Pro 限制),填入自己的 QCode 密钥和自定义接口地址就能正常翻译网页。
可以在沉浸式翻译里使用 Claude 模型吗?¶
可以。在设置页「翻译服务列表」底部的「其他/自定义」分组里,紧挨着「OpenAI 1」还有「Claude 1」服务,同样支持填写「APIKEY」和「自定义 API 接口地址」。
需要注意,Claude 必须走 QCode 的 Anthropic 端点(https://api.qcode.cc/api),不能填在「OpenAI 1」下;勾选「输入自定义模型名称」后推荐填写 claude-opus-5-5(追求更低消耗与更快响应时可选 claude-haiku-5-5)。
扩展界面的显示语言怎么切换?¶
打开沉浸式翻译设置页,在左侧点击「基本设置」,找到「界面语言」(用于调整插件面板和设置页的显示语言),即可在简体中文、English 等语言之间切换。
翻译速度慢或只翻出一部分怎么办?¶
按两步排查:
- 切换更近的 QCode 接入点:中国大陆网络可将「自定义 API 接口地址」改为亚洲节点
https://asia.qcode.cc/openai/v1/chat/completions;北美或欧洲地区可尝试https://us.qcode.cc/openai/v1/chat/completions。 - 调低请求频率:在「OpenAI 1」配置抽屉向下滚动找到「每秒最大请求数」,从默认的
5调低到2或3,减少长网页并发分段翻译时的限流概率。
接入速览¶
| 项目 | 说明 |
|---|---|
| 推荐翻译服务 | OpenAI 1(设置页「翻译服务列表」→「其他/自定义」分组,无需登录与 Pro 会员) |
| OpenAI 兼容接口地址 | https://api.qcode.cc/openai/v1/chat/completions(兼容 https://api.qcode.cc/openai/v1) |
| Anthropic 接口地址 | https://api.qcode.cc/api(供「Claude 1」使用) |
| 默认推荐模型 | OpenAI 兼容:gpt-6.2-sol · Anthropic:claude-opus-5-5 |
| 默认请求频率 | 每秒最大请求数 5(自动保存,遇 429 可调低) |
| 官方安装说明 | immersivetranslate.com 安装指南 |
注意区分入口:服务列表中另有一项「自定义接口翻译」,它面向自有私有翻译协议,与本教程使用的「OpenAI 1」「Claude 1」不是同一个入口,请勿选错。
其他接入点¶
三个接入点功能完全一致,仅网络路由不同,同一把 cr_ 密钥通用:
| 节点 | OpenAI 兼容(「OpenAI 1」完整地址) | Anthropic(「Claude 1」端点) |
|---|---|---|
| 全球 | https://api.qcode.cc/openai/v1/chat/completions |
https://api.qcode.cc/api |
| 亚洲(大陆首选) | https://asia.qcode.cc/openai/v1/chat/completions |
https://asia.qcode.cc/api |
| 北美 / 欧洲 | https://us.qcode.cc/openai/v1/chat/completions |
https://us.qcode.cc/api |
推荐模型说明¶
| 模型 ID | 适用服务 | 说明 |
|---|---|---|
gpt-6.2-sol |
OpenAI 1 |
OpenAI 兼容默认首选,网页逐段翻译响应快、译文自然 |
gpt-6.2-astra |
OpenAI 1 |
OpenAI 高阶备选,适合长难句与学术文献精翻 |
claude-opus-5-5 |
Claude 1 |
Anthropic 默认首选,中文润色与语境把握出色 |
claude-haiku-5-5 |
Claude 1 |
Anthropic 轻量备选,适合日常快速浏览英文网页 |
网页翻译每次请求通常只包含单个短段落,建议优先选用上述非深度思考型直出模型;部分推理型模型在较短输出预算下可能把额度消耗在思考过程里,导致译文不完整或速度变慢。更多可用型号见 模型选择指南 与 国产模型接入。
相关文档¶
- 接入点与 API 格式 — 协议与模型家族完整对照表
- 模型选择指南 — 各模型特点与场景推荐
- 国产模型接入 — OpenAI 兼容端点可用的国产模型清单
- 计费说明 — 个人套餐与按量包说明
- 故障排查 — 常见连接与鉴权问题排查
- 沉浸式翻译官方安装文档
开始使用 QCode
一把 API Key 同时用于 Claude Code、Codex 等工具;按 token 计费,各模型单价见 qcode.cc/models