Roo Code 接入 Qwen Code CLI ProviderOAuth 认证、1M 上下文与自动刷新机制全解析【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-CodeQwen Code CLI Provider 是 Roo Code 内置的阿里云 Qwen3 Coder 模型接入方案它绕过了传统的 API Key 配置改用 Qwen 官方客户端的 OAuth 登录凭据进行认证并支持 Token 自动刷新。本文基于仓库中的官方文档与源码实现完整讲解如何安装与认证 Qwen 客户端、在 Roo Code 中配置该 Provider、理解 1M 超长上下文与 65K 最大输出 Token 的能力边界以及凭据加载、Token 刷新、401 重试等底层原理帮助你直接用 Qwen3 Coder 模型驱动 Roo Code 的 Agent 工作流。概览为什么选择 Qwen Code CLI ProviderRoo Code 通过 src/api/providers/qwen-code.ts 实现了一个名为QwenCodeHandler的 Provider其核心设计目标有两个OAuth 认证免密登录凭据由官方 Qwen 客户端在本地生成默认路径~/.qwen/oauth_creds.jsonRoo Code 只负责读取并在过期前自动刷新无需手动申请和管理 DashScope API Key超大上下文承载大型代码库Qwen3 Coder 系列模型提供1M100 万Token 的上下文窗口与65K 最大输出 Token可在单轮会话中容纳整个大型仓库的关键代码。从模型元数据看见 packages/types/src/providers/qwen-code.ts当前内置的两个模型qwen3-coder-plus与qwen3-coder-flash均为contextWindow: 1_000_000、maxTokens: 65_536且定价字段input/output/cache 价格全部为 0对应文档中描述的促销期免费额度。前置要求与三步配置根据文档接入前需要完成三步准备工作安装 Qwen 客户端从 Qwen 官方网站下载并安装官方客户端认证运行客户端并登录你的账号Qwen 客户端会自动生成本地 OAuth 凭据文件默认位于~/.qwen/oauth_creds.json在 Roo Code 中配置 Provider在 Provider 列表中选择Qwen Code CLI API凭据路径默认值会自动生效仅在凭据存储位置非默认时才需要手动指定自定义路径。配置界面的实际交互在 webview-ui/src/components/settings/providers/QwenCode.tsx 中有完整体现设置页提供一个 OAuth Credentials Path 文本输入框占位符与默认值为~/.qwen/oauth_creds.json。该组件有两个值得一提的交互细节输入框失焦回填当用户在onBlur时留空该字段组件会自动将其重置为默认路径~/.qwen/oauth_creds.json引导说明界面文案明确提示 Qwen Code is an OAuth-based API that requires authentication through the official Qwen client并按步骤提示安装客户端 → 账号认证 → 凭据自动存储。官网地址Qwen Code 官方站点为 chat.qwen.ai文档原文以 Website 字段标注。可用模型与能力边界文档明确指出Qwen3 Coder 模型具备1M 上下文窗口和65K 最大输出 Token并建议在 Roo Code 中配置 Provider 时以 Provider 的模型目录为准获取完整的、最新的模型列表。结合仓库中的 packages/types/src/providers/qwen-code.ts 的qwenCodeModels定义当前仓库实际内置注册了两个模型模型 ID上下文窗口最大输出价格定位描述qwen3-coder-plus默认1,000,00065,5360高性能编码模型1M 上下文面向大型代码库qwen3-coder-flash1,000,00065,5360快速编码模型1M 上下文、面向速度优化两个模型的supportsImages与supportsPromptCache均为false即当前注册信息中该 Provider 不支持图像输入与提示词缓存默认模型 ID 为qwen3-coder-plus见qwenCodeDefaultModelId。模型的选择与回退逻辑实现在QwenCodeHandler.getModel()中若配置的apiModelId不在注册表中会自动回退到默认模型。在 Provider 注册层见 packages/types/src/provider-settings.tsqwen-code被注册为名为 Qwen Code 的 Provider其配置 Schema 为const qwenCodeSchema apiModelIdProviderModelSchema.extend({ qwenCodeOauthPath: z.string().optional(), })也就是说qwenCodeOauthPath是一个可选的字符串配置项缺省时由 Provider 内部使用默认路径。配置详解OAuth 凭据路径默认路径与自定义路径默认路径~/.qwen/oauth_creds.json由 Qwen 客户端认证时自动生成自定义路径同时支持~/前缀路径如~/custom/qwen.json与绝对路径如/home/user/.config/qwen/oauth_creds.json。路径解析逻辑位于 src/api/providers/qwen-code.ts 的getQwenCachedCredentialPath()function getQwenCachedCredentialPath(customPath?: string): string { if (customPath) { if (customPath.startsWith(~/)) { return path.join(os.homedir(), customPath.slice(2)) } return path.resolve(customPath) } return path.join(os.homedir(), QWEN_DIR, QWEN_CREDENTIAL_FILENAME) }可以看到~/会被展开为用户主目录通过os.homedir()绝对路径则直接path.resolve未提供自定义路径时拼装出$HOME/.qwen/oauth_creds.json。这也是为什么文档强调默认路径自动生效、无需额外配置。凭据文件格式loadCachedQwenCredentials()直接以 JSON 解析该文件QwenOAuthCredentials接口定义的字段如下interface QwenOAuthCredentials { access_token: string // 访问令牌用于 DashScope API 认证 refresh_token: string // 刷新令牌用于过期后换取新令牌 token_type: string // 令牌类型如 Bearer expiry_date: number // 过期时间戳毫秒 resource_url?: string // 可选的 API 资源地址 }其中expiry_date是判断 Token 是否需要刷新的关键依据。核心特性与底层实现文档列出的核心特性包括 OAuth 2.0 安全认证、1M 上下文、带 30 秒缓冲的自动刷新、促销期免费额度2,000 次/天、60 次/分钟、无 Token 上限以及完整的思考块thinking blocks推理支持。以下逐一对应源码解析其实现机制。1. OAuth 2.0 认证与自动刷新认证流程在ensureAuthenticated()中完成分为三步首次调用时从凭据文件加载缓存凭据通过isTokenValid()判断 Token 是否有效——有效判据为Date.now() expiry_date - 30_000即提前 30 秒视为过期这就是文档所说的30-second bufferToken 即将过期或已过期时调用refreshAccessToken()向 OAuth 端点发起刷新请求。刷新逻辑doRefreshAccessToken向https://chat.qwen.ai/api/v1/oauth2/token以application/x-www-form-urlencoded格式 POSTgrant_typerefresh_token、refresh_token与固定的client_id成功后用返回的access_token与expires_in换算为Date.now() expires_in * 1000的expiry_date合并进原凭据将新凭据回写至本地凭据文件格式化 JSON即便文件写入失败刷新后的 Token 也会在内存中继续生效不影响本次会话。2. 401 自动重试当请求返回 401Token 过期时callApiWithRetry()会捕获该错误重新刷新 Token、更新 client 的apiKey与baseURL然后重放一次原始 API 调用。这解释了文档常见问题中Provider should auto-refresh (check logs)的结论多数 401 会在用户无感知的情况下被自动修复。3. 并发刷新去重refreshAccessToken()通过refreshPromise字段实现单飞single-flight语义若已有刷新在途则直接复用同一个 Promise避免并发请求触发多次刷新。4. 客户端与请求地址构造ensureClient()创建的 OpenAI 兼容客户端指向 DashScope 兼容模式端点https://dashscope.aliyuncs.com/compatible-mode/v1并附带一组特定的请求头X-DashScope-CacheControl: enable、X-DashScope-AuthType: qwen-oauth与User-Agent: QwenCode/1.0.0。而getBaseUrl()则优先使用凭据中的resource_url若存在自动补全https://前缀并确保以/v1结尾。在ensureAuthenticated()成功后client.apiKey会被动态替换为access_token。5. 流式推理与思考块支持createMessage()以流式方式消费响应对输出的处理覆盖了三种内容形态思考块当内容中出现think//think标记时按标记切分标记外内容作为text输出标记内内容作为reasoning输出原生思考字段当 delta 携带reasoning_content时直接作为reasoning事件输出原生工具调用delta 中的tool_calls被逐个转换为tool_call_partial分片事件交由NativeToolCallParser见 src/core/assistant-message/NativeToolCallParser.ts聚合当finish_reason出现时通过NativeToolCallParser.processFinishReason()发出tool_call_end事件从而让 Roo Code 能够驱动完整的工具调用闭环。该行为有对应的测试用例背书src/api/providers/tests/qwen-code-native-tools.spec.ts 覆盖了携带 tools 发起请求、parallel_tool_calls透传、流式tool_call_partial分片、finish_reason触发tool_call_end、思考块与工具调用并存等场景其中流式分片测试验证了{arg1:与value}两个增量片段会被逐段转发。6. 请求参数默认值请求构造中还有两个值得注意的默认策略temperature: 0确定性优先与parallel_tool_calls: true默认允许并行工具调用可由元数据覆盖stream_options.include_usage保证流式结束时返回 Token 用量用于 Roo Code 的成本统计。常见问题排查文档给出了三类高频问题的排查路径Cannot find credentials file找不到凭据文件确认已用 Qwen 客户端完成认证认证才会生成凭据文件检查~/.qwen/oauth_creds.json是否存在若凭据存储在其他位置请在 Provider 设置中显式配置自定义路径。Token refresh failedToken 刷新失败检查网络连通性刷新请求需要访问 OAuth 端点重新用 Qwen 客户端认证以获取有效的刷新令牌。401 Unauthorized未授权Provider 通常会自动刷新并重试可先查看日志确认是否已自动恢复若持续出现删除本地凭据文件后重新认证。从源码角度补充两个深层原因凭据文件无法读取或 JSON 解析失败时loadCachedQwenCredentials()会直接抛错对应找不到凭据文件的另一形态而凭据中缺少refresh_token时刷新必然失败doRefreshAccessToken会抛出 No refresh token available。排查时优先确认凭据文件的完整性与有效性。小结Qwen Code CLI Provider 是 Roo Code 中少见的OAuth 凭据驱动型接入方案一次登录、本地存证、自动刷新、401 自愈配合 1M 上下文与 65K 输出的模型能力适合希望用免 Key 方式处理大型代码库任务的场景。若需要进一步深入可依次阅读 Provider 实现、模型元数据定义、配置 Schema、设置界面组件 与原生工具调用测试完整还原其认证、刷新与流式处理链路。【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Roo Code 接入 Qwen Code CLI Provider：OAuth 认证、1M 上下文与自动刷新机制全解析
Roo Code 接入 Qwen Code CLI ProviderOAuth 认证、1M 上下文与自动刷新机制全解析【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-CodeQwen Code CLI Provider 是 Roo Code 内置的阿里云 Qwen3 Coder 模型接入方案它绕过了传统的 API Key 配置改用 Qwen 官方客户端的 OAuth 登录凭据进行认证并支持 Token 自动刷新。本文基于仓库中的官方文档与源码实现完整讲解如何安装与认证 Qwen 客户端、在 Roo Code 中配置该 Provider、理解 1M 超长上下文与 65K 最大输出 Token 的能力边界以及凭据加载、Token 刷新、401 重试等底层原理帮助你直接用 Qwen3 Coder 模型驱动 Roo Code 的 Agent 工作流。概览为什么选择 Qwen Code CLI ProviderRoo Code 通过 src/api/providers/qwen-code.ts 实现了一个名为QwenCodeHandler的 Provider其核心设计目标有两个OAuth 认证免密登录凭据由官方 Qwen 客户端在本地生成默认路径~/.qwen/oauth_creds.jsonRoo Code 只负责读取并在过期前自动刷新无需手动申请和管理 DashScope API Key超大上下文承载大型代码库Qwen3 Coder 系列模型提供1M100 万Token 的上下文窗口与65K 最大输出 Token可在单轮会话中容纳整个大型仓库的关键代码。从模型元数据看见 packages/types/src/providers/qwen-code.ts当前内置的两个模型qwen3-coder-plus与qwen3-coder-flash均为contextWindow: 1_000_000、maxTokens: 65_536且定价字段input/output/cache 价格全部为 0对应文档中描述的促销期免费额度。前置要求与三步配置根据文档接入前需要完成三步准备工作安装 Qwen 客户端从 Qwen 官方网站下载并安装官方客户端认证运行客户端并登录你的账号Qwen 客户端会自动生成本地 OAuth 凭据文件默认位于~/.qwen/oauth_creds.json在 Roo Code 中配置 Provider在 Provider 列表中选择Qwen Code CLI API凭据路径默认值会自动生效仅在凭据存储位置非默认时才需要手动指定自定义路径。配置界面的实际交互在 webview-ui/src/components/settings/providers/QwenCode.tsx 中有完整体现设置页提供一个 OAuth Credentials Path 文本输入框占位符与默认值为~/.qwen/oauth_creds.json。该组件有两个值得一提的交互细节输入框失焦回填当用户在onBlur时留空该字段组件会自动将其重置为默认路径~/.qwen/oauth_creds.json引导说明界面文案明确提示 Qwen Code is an OAuth-based API that requires authentication through the official Qwen client并按步骤提示安装客户端 → 账号认证 → 凭据自动存储。官网地址Qwen Code 官方站点为 chat.qwen.ai文档原文以 Website 字段标注。可用模型与能力边界文档明确指出Qwen3 Coder 模型具备1M 上下文窗口和65K 最大输出 Token并建议在 Roo Code 中配置 Provider 时以 Provider 的模型目录为准获取完整的、最新的模型列表。结合仓库中的 packages/types/src/providers/qwen-code.ts 的qwenCodeModels定义当前仓库实际内置注册了两个模型模型 ID上下文窗口最大输出价格定位描述qwen3-coder-plus默认1,000,00065,5360高性能编码模型1M 上下文面向大型代码库qwen3-coder-flash1,000,00065,5360快速编码模型1M 上下文、面向速度优化两个模型的supportsImages与supportsPromptCache均为false即当前注册信息中该 Provider 不支持图像输入与提示词缓存默认模型 ID 为qwen3-coder-plus见qwenCodeDefaultModelId。模型的选择与回退逻辑实现在QwenCodeHandler.getModel()中若配置的apiModelId不在注册表中会自动回退到默认模型。在 Provider 注册层见 packages/types/src/provider-settings.tsqwen-code被注册为名为 Qwen Code 的 Provider其配置 Schema 为const qwenCodeSchema apiModelIdProviderModelSchema.extend({ qwenCodeOauthPath: z.string().optional(), })也就是说qwenCodeOauthPath是一个可选的字符串配置项缺省时由 Provider 内部使用默认路径。配置详解OAuth 凭据路径默认路径与自定义路径默认路径~/.qwen/oauth_creds.json由 Qwen 客户端认证时自动生成自定义路径同时支持~/前缀路径如~/custom/qwen.json与绝对路径如/home/user/.config/qwen/oauth_creds.json。路径解析逻辑位于 src/api/providers/qwen-code.ts 的getQwenCachedCredentialPath()function getQwenCachedCredentialPath(customPath?: string): string { if (customPath) { if (customPath.startsWith(~/)) { return path.join(os.homedir(), customPath.slice(2)) } return path.resolve(customPath) } return path.join(os.homedir(), QWEN_DIR, QWEN_CREDENTIAL_FILENAME) }可以看到~/会被展开为用户主目录通过os.homedir()绝对路径则直接path.resolve未提供自定义路径时拼装出$HOME/.qwen/oauth_creds.json。这也是为什么文档强调默认路径自动生效、无需额外配置。凭据文件格式loadCachedQwenCredentials()直接以 JSON 解析该文件QwenOAuthCredentials接口定义的字段如下interface QwenOAuthCredentials { access_token: string // 访问令牌用于 DashScope API 认证 refresh_token: string // 刷新令牌用于过期后换取新令牌 token_type: string // 令牌类型如 Bearer expiry_date: number // 过期时间戳毫秒 resource_url?: string // 可选的 API 资源地址 }其中expiry_date是判断 Token 是否需要刷新的关键依据。核心特性与底层实现文档列出的核心特性包括 OAuth 2.0 安全认证、1M 上下文、带 30 秒缓冲的自动刷新、促销期免费额度2,000 次/天、60 次/分钟、无 Token 上限以及完整的思考块thinking blocks推理支持。以下逐一对应源码解析其实现机制。1. OAuth 2.0 认证与自动刷新认证流程在ensureAuthenticated()中完成分为三步首次调用时从凭据文件加载缓存凭据通过isTokenValid()判断 Token 是否有效——有效判据为Date.now() expiry_date - 30_000即提前 30 秒视为过期这就是文档所说的30-second bufferToken 即将过期或已过期时调用refreshAccessToken()向 OAuth 端点发起刷新请求。刷新逻辑doRefreshAccessToken向https://chat.qwen.ai/api/v1/oauth2/token以application/x-www-form-urlencoded格式 POSTgrant_typerefresh_token、refresh_token与固定的client_id成功后用返回的access_token与expires_in换算为Date.now() expires_in * 1000的expiry_date合并进原凭据将新凭据回写至本地凭据文件格式化 JSON即便文件写入失败刷新后的 Token 也会在内存中继续生效不影响本次会话。2. 401 自动重试当请求返回 401Token 过期时callApiWithRetry()会捕获该错误重新刷新 Token、更新 client 的apiKey与baseURL然后重放一次原始 API 调用。这解释了文档常见问题中Provider should auto-refresh (check logs)的结论多数 401 会在用户无感知的情况下被自动修复。3. 并发刷新去重refreshAccessToken()通过refreshPromise字段实现单飞single-flight语义若已有刷新在途则直接复用同一个 Promise避免并发请求触发多次刷新。4. 客户端与请求地址构造ensureClient()创建的 OpenAI 兼容客户端指向 DashScope 兼容模式端点https://dashscope.aliyuncs.com/compatible-mode/v1并附带一组特定的请求头X-DashScope-CacheControl: enable、X-DashScope-AuthType: qwen-oauth与User-Agent: QwenCode/1.0.0。而getBaseUrl()则优先使用凭据中的resource_url若存在自动补全https://前缀并确保以/v1结尾。在ensureAuthenticated()成功后client.apiKey会被动态替换为access_token。5. 流式推理与思考块支持createMessage()以流式方式消费响应对输出的处理覆盖了三种内容形态思考块当内容中出现think//think标记时按标记切分标记外内容作为text输出标记内内容作为reasoning输出原生思考字段当 delta 携带reasoning_content时直接作为reasoning事件输出原生工具调用delta 中的tool_calls被逐个转换为tool_call_partial分片事件交由NativeToolCallParser见 src/core/assistant-message/NativeToolCallParser.ts聚合当finish_reason出现时通过NativeToolCallParser.processFinishReason()发出tool_call_end事件从而让 Roo Code 能够驱动完整的工具调用闭环。该行为有对应的测试用例背书src/api/providers/tests/qwen-code-native-tools.spec.ts 覆盖了携带 tools 发起请求、parallel_tool_calls透传、流式tool_call_partial分片、finish_reason触发tool_call_end、思考块与工具调用并存等场景其中流式分片测试验证了{arg1:与value}两个增量片段会被逐段转发。6. 请求参数默认值请求构造中还有两个值得注意的默认策略temperature: 0确定性优先与parallel_tool_calls: true默认允许并行工具调用可由元数据覆盖stream_options.include_usage保证流式结束时返回 Token 用量用于 Roo Code 的成本统计。常见问题排查文档给出了三类高频问题的排查路径Cannot find credentials file找不到凭据文件确认已用 Qwen 客户端完成认证认证才会生成凭据文件检查~/.qwen/oauth_creds.json是否存在若凭据存储在其他位置请在 Provider 设置中显式配置自定义路径。Token refresh failedToken 刷新失败检查网络连通性刷新请求需要访问 OAuth 端点重新用 Qwen 客户端认证以获取有效的刷新令牌。401 Unauthorized未授权Provider 通常会自动刷新并重试可先查看日志确认是否已自动恢复若持续出现删除本地凭据文件后重新认证。从源码角度补充两个深层原因凭据文件无法读取或 JSON 解析失败时loadCachedQwenCredentials()会直接抛错对应找不到凭据文件的另一形态而凭据中缺少refresh_token时刷新必然失败doRefreshAccessToken会抛出 No refresh token available。排查时优先确认凭据文件的完整性与有效性。小结Qwen Code CLI Provider 是 Roo Code 中少见的OAuth 凭据驱动型接入方案一次登录、本地存证、自动刷新、401 自愈配合 1M 上下文与 65K 输出的模型能力适合希望用免 Key 方式处理大型代码库任务的场景。若需要进一步深入可依次阅读 Provider 实现、模型元数据定义、配置 Schema、设置界面组件 与原生工具调用测试完整还原其认证、刷新与流式处理链路。【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考