使用邀测 API Key,将评测模型接入 Qoder、Claude Desktop、Codex 或 Claude Code,并验证对话、文件工具和辅助模型调用。
本文介绍如何将 Qwen4-Max 预览版评测模型接入本地 Agent 客户端。Qoder 可直接配置自定义模型;Claude Desktop、Codex 和 Claude Code 需要通过 CC Switch 的本地路由完成模型映射和协议转换。
在评测活动页阅读规则、选择评测类型并报名,审核通过后按页面指引获取 API Key。
截至 2026 年 11 月 13 日,参考指南展示的模型名称为 Qwen4-Max-Preview,实际请求使用的模型 ID 为
API Key 仅填写到客户端或 CC Switch 的密钥字段。分享配置、截图或评测材料时隐藏真实 Key。
根据使用的客户端安装工具:
从 CC Switch 发布页安装包含对应应用入口、模型映射和本地路由功能的版本。客户端界面可能随版本变化,以配置字段为准。
遇到 404 / 405 时,检查客户端实际发出的 URL,最终路径应为
以下截图对应 Claude Desktop。在 CC Switch 中选择带桌面角标的 Claude Desktop 入口。
打开 CC Switch → Claude Desktop → 添加供应商 → 自定义配置,填写:
将各角色的实际请求模型统一映射到邀测模型,减少主会话可用而辅助请求失败的情况:
部分版本只显示 Sonnet、Opus 和 Haiku,按实际存在的角色配置即可。勾选 1M 是客户端能力声明,长上下文仍需实际验收。
本节适用于本机 Codex Agent,包括相应桌面端的 Codex 模式、Codex CLI 或 IDE 扩展。
打开 CC Switch → Codex → 添加供应商 → 自定义配置,填写:
“自动审批模型”仅指定该功能调用的模型。填入模型 ID 不会自动开启该功能或授予额外工具权限。
活动标注模型上下文能力为 1M,但截图中的 Codex 客户端窗口为
终端版 Claude Code 使用 CC Switch 中的 Claude / Claude Code 独立入口。上文 Claude Desktop 截图对应桌面客户端,终端版请按其独立入口配置。
在新会话中依次完成以下检查:
可使用测试任务:“在当前测试目录创建 agent-check.txt,写入 hello qwen,再读取它并报告内容。”按任务需要选择客户端权限。模型的自我介绍不能证明实际调用模型,请以请求记录为准。
以下 Python 3 示例仅使用标准库,通过环境变量或隐藏输入读取 Key。执行会消耗少量额度,仅验证文本 API 连通性,客户端工具兼容性仍需按上文验收。
截至 2026 年 11 月 13 日,参考指南标注模型支持图片 / 视频输入及思考模式开关,上下文为 1M,最高并发为 5,默认 TPM 为 300 万,活动结束日期为 2026 年 11 月 18 日。具体权限和额度以账号开通结果及活动后续调整为准。
上述激励均需通过评测报告审核。
接入验证通过后,按评测活动页的当前规则开展真实工作任务评测,并通过页面当前的评测结果表单提交材料。建议记录客户端与 CC Switch 版本、测试时间、实际模型 ID、任务输入、过程轨迹、最终产物、预期结果及可复现问题。评测期间尽量保持同一指定模型;提交前移除 Key 等密钥信息。
模型支持图片或视频输入,不代表各 Agent 客户端及协议转换链路都支持全部多模态任务,需分别验证。实际连通性、工具调用和长上下文能力需使用本人的邀测 Key 完成验收。
本文配置适用于本次外部邀测,需使用审核通过后获得的邀测 API Key、专用接口地址和模型 ID。活动资格、有效期、额度及模型能力以评测活动页当前说明为准。
开始之前
在评测活动页阅读规则、选择评测类型并报名,审核通过后按页面指引获取 API Key。
截至 2026 年 11 月 13 日,参考指南展示的模型名称为 Qwen4-Max-Preview,实际请求使用的模型 ID 为 qwen-latest-series-invite-1102。模型菜单显示名可自定义,实际请求模型必须填写完整 ID。
| 配置项 | 本次邀测填写值 |
|---|---|
| API Key | 本人获得的本次邀测 API Key |
| API Base URL | https://qweneval.aliyuncs.com/v1 |
| 实际请求模型 / Model ID | qwen-latest-series-invite-1102 |
| 上游接口类型 | OpenAI Chat Completions |
| 完整请求地址 | https://qweneval.aliyuncs.com/v1/chat/completions |
| 客户端 | 接入方式 | 是否需要 CC Switch |
|---|---|---|
| Qoder | 内置自定义模型,选择 Chat Completions | 否 |
| Codex CLI、IDE 扩展或相应桌面端的 Codex 模式 | 本地路由将 Responses 转为 Chat Completions | 是,使用期间保持路由运行 |
| Claude Desktop 的 Code 模式 | 模型映射与协议转换 | 是,使用期间保持路由运行 |
| Claude Code 终端版 | Claude Code 独立入口与协议转换 | 是,使用期间保持路由运行 |
Qoder
添加自定义模型
- 打开 Qoder,进入设置 → 模型 → 添加模型。
- 在供应商列表选择自定义 → OpenAI Compatible。
Qoder:选择 OpenAI Compatible 供应商

- 按下表填写,点击校验并添加模型;编辑已有模型时点击校验并保存。
| 字段 | 填写内容 |
|---|---|
| API 类型 | Chat Completions API |
| 接口地址(Base URL) | https://qweneval.aliyuncs.com/v1 |
| API Key | 本次邀测 API Key |
| Model ID | qwen-latest-series-invite-1102 |
Qoder:填写 API 类型、接口地址和模型 ID

- 新建本地任务,在输入框旁的模型选择器中选择刚添加的邀测模型,先发送简单问题,再执行一次文件读写任务。
请求路径与输出限制
遇到 404 / 405 时,检查客户端实际发出的 URL,最终路径应为 /v1/chat/completions。客户端自动追加路径时,Base URL 填到 /v1 即可;若当前版本要求完整端点,则填写 https://qweneval.aliyuncs.com/v1/chat/completions。避免重复追加 /v1 或 /chat/completions。
输出被截断时,先检查结束原因及客户端输出限制,区分输出长度限制和上下文已满。若当前 Qoder 版本在 ~/.qoder/settings.json 的 providers 中提供对应模型的输出 maxToken 字段,可备份配置文件后调整该值,保留其他供应商配置,并重启验证。最大输出 token 数以服务实际限制为准;1M 上下文不等于单次可输出 1M token。
Claude Desktop
以下截图对应 Claude Desktop。在 CC Switch 中选择带桌面角标的 Claude Desktop 入口。
创建供应商
打开 CC Switch → Claude Desktop → 添加供应商 → 自定义配置,填写:
| 字段 | 填写内容 |
|---|---|
| 供应商名称 | 自定义,例如 Qianwen AI Platform |
| API Key | 本次邀测 API Key |
| 请求地址 | https://qweneval.aliyuncs.com/v1 |
| 接入方式 / 需要模型映射 | 选择模型映射 / 开启 |
| API 格式 | OpenAI Chat Completions(需开启路由) |
CC Switch:添加 Claude Desktop 自定义供应商

配置模型角色映射
将各角色的实际请求模型统一映射到邀测模型,减少主会话可用而辅助请求失败的情况:
| 模型角色 | 菜单显示名 | 实际请求模型 | 声明支持 1M |
|---|---|---|---|
| Sonnet | qwen-latest-series-invite-1102 | qwen-latest-series-invite-1102 | 勾选 |
| Opus | qwen-latest-series-invite-1102 | qwen-latest-series-invite-1102 | 勾选 |
| Haiku | qwen-latest-series-invite-1102 | qwen-latest-series-invite-1102 | 勾选 |
| Fable(如当前版本显示) | qwen-latest-series-invite-1102 | qwen-latest-series-invite-1102 | 勾选 |
CC Switch:Claude Desktop 的 API 格式与模型映射

启用路由并验证
- 保存供应商,回到列表点击切换 / 启用。若出现提示,选择开始路由并使用它。
- 确认供应商为使用中,本地路由状态为运行中。
- 完全退出 Claude Desktop 后重新打开,切换到 Code 模式,新建会话,选择本机环境和用于测试的文件夹。
- 在模型菜单中选择映射后的显示名,先验证对话,再验证文件工具调用。
Codex
本节适用于本机 Codex Agent,包括相应桌面端的 Codex 模式、Codex CLI 或 IDE 扩展。
创建供应商和模型列表
打开 CC Switch → Codex → 添加供应商 → 自定义配置,填写:
| 字段 | 填写内容 |
|---|---|
| 名称 | 自定义,例如 Qianwen AI Platform |
| API Key | 本次邀测 API Key |
| API 请求地址 | https://qweneval.aliyuncs.com/v1 |
| 模型列表 → 菜单显示名 | qwen-latest-series-invite-1102 |
| 模型列表 → 实际请求模型 | qwen-latest-series-invite-1102 |
| 模型列表 → 上下文窗口 | 先按截图填 272000;1M 配置见下文 |
| 默认模型(如有) | qwen-latest-series-invite-1102 |
| 子代理模型 | qwen-latest-series-invite-1102 |
| 子代理思考强度 | 默认强度 |
| 子代理并发上限 | 先留空;实际任务仍需遵守服务并发限制 |
| 自动审批模型 | qwen-latest-series-invite-1102 |
| 高级选项 → 上游格式 | Chat Completions(需转换) |
| 完整 URL | 关闭 |
| 提示词缓存路由 | 自动(推荐) |
| 支持思考模式 / 支持思考等级 | 先关闭,完成基础验证后再单独评测 |
CC Switch:Codex 供应商、模型列表和上下文窗口

CC Switch:Codex 辅助模型与协议转换设置

开启路由并验证
- 保存供应商,启用本地路由,并将 Codex 路由到此供应商。不同版本可能显示“路由到此处”“开始路由”或“需要本地路由”。
- 确认供应商正确、路由服务运行,使用期间保持 CC Switch 开启。
- 完全退出并重启对应客户端:CLI 重新启动进程,IDE 扩展重新加载窗口。若提示后台 daemon 仍持有旧模型列表,待运行中的任务结束后按提示重启。
- 新建会话并选择邀测模型。桌面端进入对应 Codex 模式,CLI 可在
/model中确认。 - 分别验证基础对话、文件工具调用、子代理调用;如使用自动审批,再检查该功能的实际请求。
Codex 的原生协议为 Responses,本次邀测上游为 Chat Completions,需要由 CC Switch 路由完成转换。“Chat Completions(需转换)”是 CC Switch 的上游格式选项;Codex 原生配置中的
wire_api 应保持为 responses。上下文和思考设置
活动标注模型上下文能力为 1M,但截图中的 Codex 客户端窗口为 272000。基础接入先按截图复现;评测长上下文时,在确认服务与客户端支持后,可将窗口改为 1000000,同时核对自动压缩阈值,重启并进行长任务验收。填写数值本身不能证明转换链路已通过 1M 实测。
模型支持思考模式开关,不代表服务端支持全部 OpenAI 风格的思考等级。模型列表截图中的“none, low → max”是客户端可选等级声明,协议转换截图中的思考能力开关为关闭。基础接入先关闭这些开关;需要评测思考时,核对实际 API 参数及 CC Switch 的转换支持,再开启并验证。
Claude Code
终端版 Claude Code 使用 CC Switch 中的 Claude / Claude Code 独立入口。上文 Claude Desktop 截图对应桌面客户端,终端版请按其独立入口配置。
- 添加自定义供应商,填写本次邀测 API Key、Base URL
https://qweneval.aliyuncs.com/v1和模型 IDqwen-latest-series-invite-1102。 - 将主模型及 Sonnet、Opus、Haiku 等辅助角色统一映射到
qwen-latest-series-invite-1102。 - 上游格式选择 OpenAI Chat Completions(需开启路由),启用 Claude Code 的本地路由。
- 保持 CC Switch 和路由运行,启动新会话,验证对话和文件工具调用。
ANTHROPIC_BASE_URL 不足以替代转换步骤。
验收与排查
最小验收
在新会话中依次完成以下检查:
| 检查项 | 通过标准 |
|---|---|
| 基础对话 | 正常回复,没有认证或协议错误 |
| 实际模型 | 请求或路由日志中的实际模型为 qwen-latest-series-invite-1102 |
| 文件工具 | 在测试目录创建并读取文件,内容正确 |
| 辅助请求 | 使用子代理、辅助角色或自动审批时,对应请求路由正确 |
| 重启后配置 | 重启客户端后仍能选择模型并完成请求 |
常见故障
| 现象 | 优先检查 |
|---|---|
| 401 / 403 | 邀测资格是否开通,Key 是否对应本次活动,是否有多余空格 |
| model not found / 无权限 | 实际模型 ID 是否完整准确,辅助角色是否遗漏映射 |
| 404 / 405 | 所选协议、路由状态和最终 URL,避免重复 /v1 或重复追加端点 |
| 本地路由连接失败 | CC Switch 是否运行,路由是否启动,是否端口冲突 |
| 保存后仍是旧模型 | 重新切换供应商,完全退出客户端重开,检查 Codex daemon |
| 对话可用,工具或子代理失败 | 工具权限、协议转换和辅助模型映射,查看对应请求错误 |
| 输出被截断 | 输出 token 限制及结束原因;Qoder 可检查当前版本的 maxToken 字段 |
| 429 | 降低请求速率与总并发,检查共享同一 Key 的其他任务及额度 |
| 上下文超限 | 缩短历史或新开会话,核对客户端窗口和压缩设置 |
| reasoning 参数报错 | 核对思考参数转换,先关闭思考等级选项验证 |
可选:验证文本 API
以下 Python 3 示例仅使用标准库,通过环境变量或隐藏输入读取 Key。执行会消耗少量额度,仅验证文本 API 连通性,客户端工具兼容性仍需按上文验收。
提交评测结果
截至 2026 年 11 月 13 日,参考指南标注模型支持图片 / 视频输入及思考模式开关,上下文为 1M,最高并发为 5,默认 TPM 为 300 万,活动结束日期为 2026 年 11 月 18 日。具体权限和额度以账号开通结果及活动后续调整为准。
| 评测类型 | 页面标注额度 | 提交要求 | 审核通过后激励 |
|---|---|---|---|
| 体验评测 | 1 亿 Token | 至少 1 条真实工作复杂任务案例 | 100 元代金券 |
| 深度评测 | 2 亿 Token | 至少 1 条真实工作复杂任务案例,每条附执行过程数据文件 | 300 元代金券 |
| 专业评测 | 5 亿 Token | 自建评测集、完整评测报告及执行过程文件 | 500 元代金券 |