沉浸式翻译(Immersive Translate)接入 QCode 图文教程(Windows 11 一步一图)

跟着 11 步、11 张截图,在 Windows 11 的 Edge 或 Chrome 浏览器中装好沉浸式翻译 1.35.4,接入 QCode 并配置 gpt-6.2-sol,打开英文网页一键获得中英对照译文。

更新于 2026-11-23

需要 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 会员。

  • 适用系统:Windows 10 / 11(64 位),搭配 Microsoft Edge、Chrome 或 Firefox 浏览器
  • 软件版本:Immersive Translate 1.35.4(实拍浏览器:Microsoft Edge 158)
  • 截图更新于:2026-11
  • 预计用时:10 分钟
  • 需要准备:一个 cr_ 开头的 QCode API 密钥
  • 电脑是 Windows 10 / 11(64 位),装有 Microsoft Edge、Chrome 或 Firefox 浏览器(沉浸式翻译是浏览器扩展,无需管理员权限)
  • 已经注册 QCode.cc,并在控制台复制好 cr_ 开头的 API 密钥。还没有账号?先注册 QCode,在定价页选一个方案,再到控制台创建密钥。
  • 无需注册沉浸式翻译账号,也无需开通 Pro 会员,直接填自己的 QCode 密钥即可翻译
  • 电脑能正常打开扩展商店(如 Edge 扩展商店或 Chrome 应用店),并能访问 api.qcode.cc 与 probe.qcode.cc

下载与安装

沉浸式翻译是浏览器扩展,没有独立的 .exe 安装包,也不在 winget 或 Windows 应用商店中分发。在浏览器扩展商店直接安装不会触发 Windows SmartScreen 拦截,也不需要管理员权限。

官方安装入口:

不同地区的网络环境略有差异,先选你所在的地区:

  • 推荐方式(最省事):直接用 Windows 11 自带的 Microsoft Edge 打开 Edge 扩展商店,点击「获取」→「添加扩展」即可完成,无需额外配置网络。
  • Chrome 用户离线安装:如果 Chrome 应用店打不开,先到 GitHub Releases 下载对应浏览器的压缩包并解压到一个固定文件夹(请勿从第三方网站下载 .crx 文件)。接着在 Chrome 地址栏输入 chrome://extensions,打开右上角「开发者模式」,点「加载已解压的扩展程序」并选中刚解压的文件夹。加载时页面出现的「开发者模式」提示属于正常现象。

跟着截图做:Windows 一步一图

下面 11 步以 Windows 11 自带的 Microsoft Edge(简体中文界面)为例,Chrome 的后续配置界面完全一致。每步只做一件事,截图上的橙色编号和正文里的 ①②③ 一一对应。

打开扩展商店并点击「获取」

用 Microsoft Edge 打开 Edge 扩展商店的「沉浸式翻译」页面,核对页面标题和版本后,点击 ① 指向的蓝色「获取」按钮(如果使用 Chrome 应用店,这个按钮叫「添加至 Chrome」)。

打开 Microsoft Edge 扩展商店的「沉浸式翻译」页面,确认版本号后点击右侧蓝色「获取」按钮。

做对了你会看到:浏览器顶部弹出一个确认小窗口,询问是否将沉浸式翻译添加到 Microsoft Edge。

卡住了?页面顶部出现 Cookie 提示条,或用的是 Chrome

首次访问微软扩展商店时,顶部可能出现「接受 / 拒绝 / 管理 Cookie」提示条,点「拒绝」或「接受」关掉即可,不影响安装。如果你习惯用 Chrome 且打不开 Chrome 应用店,可先按上面 下载与安装 的「中国大陆」选项卡操作,或直接换用 Edge。

在确认弹窗里点击「添加扩展」

在浏览器顶部弹出的权限确认框中,点击 ① 指向的「添加扩展」按钮(Chrome 浏览器里叫「添加扩展程序」)。浏览器会自动在后台下载并完成安装,无需弹出 Windows 安装向导。

在浏览器顶部弹出的确认框里点击「添加扩展」,等待扩展自动下载安装。

做对了你会看到:等待几秒后,浏览器自动新开一个「探索沉浸式翻译更多功能」欢迎标签页,同时右上角出现安装完成提示。

把沉浸式翻译固定到工具栏

安装完成后会自动打开欢迎页;如果右上角弹出「现已安装」提示气泡,点它的关闭按钮关掉即可。接着点击地址栏右侧 ① 指向的拼图「扩展」图标展开列表,再点击「沉浸式翻译」右侧 ② 指向的显示/固定图标,把它固定到浏览器工具栏上(Chrome 里这个按钮是图钉样式)。

安装完成后会自动打开欢迎页;点击地址栏右侧的拼图「扩展」图标,再点击「沉浸式翻译」右侧的显示/固定图标,将其固定到工具栏。

做对了你会看到:地址栏右侧常驻出现「沉浸式翻译」的图标,以后不用每次再点拼图图标去找它。

打开扩展面板并进入「设置」

点击刚刚固定在工具栏上 ① 指向的「沉浸式翻译」图标,会弹出快捷面板。面板顶部显示「未登录」没有关系,不需要注册或登录沉浸式翻译账号;直接点击面板左下角 ② 指向的「设置」。

点击固定到工具栏的「沉浸式翻译」图标展开面板(无需登录账号),点击左下角的「设置」。

做对了你会看到:浏览器打开一个新的设置标签页,左侧是导航菜单,右侧是配置项。

找到「OpenAI 1」并点击「配置」

在设置页左侧的「服务及能力」下,确认选中 ① 指向的「翻译服务」。把右侧「翻译服务列表」一直向下滚动到底部的「其他/自定义」分组,找到 ② 指向的「OpenAI 1」(没有 Pro 会员限制),然后点击它右侧 ③ 指向的「配置」按钮。

在设置页左侧点击「翻译服务」,向下滚动「翻译服务列表」找到「其他/自定义」分组下的「OpenAI 1」(无需 Pro 会员),点击右侧「配置」。

做对了你会看到:页面右侧滑出「翻译服务配置」抽屉,里面依次列出「APIKEY」「模型」「自定义 API 接口地址」等输入框。

卡住了?看到的设置页布局和截图略有不同

1.35.4 在新装后可能会进入旧版设置页或新版设置页,但入口都在左侧菜单的「翻译服务」里;找到 OpenAI 对应的配置项点击进入即可。新版设置页左下角也提供切换到「旧版设置页」的入口。注意不要误选「自定义接口翻译」,那是另一种独立协议的入口。

填入 QCode 密钥、自定义模型与接口地址

在右侧滑出的「翻译服务配置」抽屉里,所有必填项都在同一屏,不需要再展开隐藏菜单。按顺序填好下面三处:

  1. 在 ① 指向的「APIKEY」输入框里粘贴你的 QCode 密钥(格式为 cr_xxxxxxxx,输入框默认以圆点隐藏内容,点右侧小眼睛可核对);
  2. 勾选 ② 指向的「输入自定义模型名称」复选框,下方下拉框会切换成文字输入框,填入 gpt-6.2-sol;
  3. 把 ③ 指向的「自定义 API 接口地址」里的默认地址清空,改为完整地址:
https://api.qcode.cc/openai/v1/chat/completions

全部填完后,在抽屉空白处点一下让输入框失焦,配置会自动保存(本版本没有单独的「保存」按钮)。

在右侧「翻译服务配置」抽屉中依次填入 QCode APIKEY、勾选「输入自定义模型名称」并填入 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。

需要 API Key?

还没有 QCode 账号的话,先注册 QCode。想按实际用量消费,先买一个按量包,再到控制台创建密钥,把 cr_ 开头的完整字符复制粘贴到「APIKEY」框里即可。

卡住了?找不到 gpt-6.2-sol 或填了 Claude 型号

「模型」下拉框里默认只列了旧型号,必须先勾选「输入自定义模型名称」才能手填 gpt-6.2-sol。另外,「OpenAI 1」走的是 OpenAI 兼容协议,这里不能填 Claude 型号;如果想用 claude-opus-5-5,请改在「其他/自定义」分组里的「Claude 1」中配置。

点击「点此测试服务」验证连通

确认刚填的输入框已经失焦保存,再点击抽屉顶部右侧 ① 指向的「点此测试服务」按钮。等待 1–3 秒,看到按钮左侧 ② 指向的位置出现绿色的响应延迟数字(单位为 ms),就说明 QCode 接口已经打通。

点击顶部「点此测试服务」,按钮左侧出现绿色响应延迟(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);配置自动保存,若翻译长网页时遇到 429 限流可在此调低。

做对了你会看到:「每秒最大请求数」右侧数字为 5(或你按需调低的更小整数)。

将「OpenAI 1」设为默认翻译服务

点击右上角的关闭按钮关闭配置抽屉,回到「翻译服务列表」。找到底部的 ① 指向的「OpenAI 1」这一行,点击它右侧原本显示为「设为默认」的按钮;点完后 ② 指向的位置会变成「当前默认」,最右侧的启用开关也会自动打开。

关闭配置抽屉,回到「翻译服务列表」点击 OpenAI 1 右侧的「设为默认」,按钮变为「当前默认」且右侧开关自动开启。

做对了你会看到:「OpenAI 1」一行显示「当前默认」,以后在任意网页点击翻译都会默认通过 QCode 请求模型。

打开英文网页并点击「翻译 (Alt+A)」

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

打开任意英文网页(示例为 Python 官方文档),点击工具栏沉浸式翻译图标,确认翻译服务为「OpenAI 1」,点击「翻译 (Alt+A)」。

做对了你会看到:扩展面板里翻译服务为「OpenAI 1」,点击「翻译 (Alt+A)」后按钮进入翻译状态。

查看中英双语对照译文

稍等几秒,在网页空白处点一下收起面板,就能看到完整的中英双语页面:① 指向的英文原文段落保留不动,紧跟在它下面 ② 指向的位置已经自动插入了流畅的中文译文,且页面没有任何红色报错。

等待数秒后,网页各英文段落下方即刻显示流畅的中文译文,形成中英对照阅读效果且无红色报错,验证 QCode OpenAI 接口已成功接入。

做对了你会看到:英文标题与正文各段落下方都成对出现中文译文;再次按 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 等语言之间切换。

翻译速度慢或只翻出一部分怎么办?

按两步排查:

  1. 切换更近的 QCode 接入点:中国大陆网络可将「自定义 API 接口地址」改为亚洲节点 https://asia.qcode.cc/openai/v1/chat/completions;北美或欧洲地区可尝试 https://us.qcode.cc/openai/v1/chat/completions。
  2. 调低请求频率:在「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 轻量备选,适合日常快速浏览英文网页

网页翻译每次请求通常只包含单个短段落,建议优先选用上述非深度思考型直出模型;部分推理型模型在较短输出预算下可能把额度消耗在思考过程里,导致译文不完整或速度变慢。更多可用型号见 模型选择指南 与 国产模型接入。

相关文档

开始使用 QCode

一把 API Key 同时用于 Claude Code、Codex 等工具;按 token 计费,各模型单价见 qcode.cc/models

企业团队版 →