跳转到主要内容
常见问题

评测模型本地 Agent 客户端接入

使用邀测 API Key,将评测模型接入 Qoder、Claude Desktop、Codex 或 Claude Code,并验证对话、文件工具和辅助模型调用。

本文介绍如何将 Qwen4-Max 预览版评测模型接入本地 Agent 客户端。Qoder 可直接配置自定义模型;Claude Desktop、Codex 和 Claude Code 需要通过 CC Switch 的本地路由完成模型映射和协议转换。
本文配置适用于本次外部邀测,需使用审核通过后获得的邀测 API Key、专用接口地址和模型 ID。活动资格、有效期、额度及模型能力以评测活动页当前说明为准。

开始之前

在评测活动页阅读规则、选择评测类型并报名,审核通过后按页面指引获取 API Key。 截至 2026 年 11 月 13 日,参考指南展示的模型名称为 Qwen4-Max-Preview,实际请求使用的模型 ID 为 qwen-latest-series-invite-1102。模型菜单显示名可自定义,实际请求模型必须填写完整 ID。
配置项本次邀测填写值
API Key本人获得的本次邀测 API Key
API Base URLhttps://qweneval.aliyuncs.com/v1
实际请求模型 / Model IDqwen-latest-series-invite-1102
上游接口类型OpenAI Chat Completions
完整请求地址https://qweneval.aliyuncs.com/v1/chat/completions
API Key 仅填写到客户端或 CC Switch 的密钥字段。分享配置、截图或评测材料时隐藏真实 Key。 根据使用的客户端安装工具:
客户端接入方式是否需要 CC Switch
Qoder内置自定义模型,选择 Chat Completions否
Codex CLI、IDE 扩展或相应桌面端的 Codex 模式本地路由将 Responses 转为 Chat Completions是,使用期间保持路由运行
Claude Desktop 的 Code 模式模型映射与协议转换是,使用期间保持路由运行
Claude Code 终端版Claude Code 独立入口与协议转换是,使用期间保持路由运行
从 CC Switch 发布页安装包含对应应用入口、模型映射和本地路由功能的版本。客户端界面可能随版本变化,以配置字段为准。

Qoder

添加自定义模型

  1. 打开 Qoder,进入设置 → 模型 → 添加模型。
  2. 在供应商列表选择自定义 → OpenAI Compatible。

Qoder:选择 OpenAI Compatible 供应商

Qoder 添加模型界面,选择自定义 OpenAI Compatible 供应商
  1. 按下表填写,点击校验并添加模型;编辑已有模型时点击校验并保存。
字段填写内容
API 类型Chat Completions API
接口地址(Base URL)https://qweneval.aliyuncs.com/v1
API Key本次邀测 API Key
Model IDqwen-latest-series-invite-1102

Qoder:填写 API 类型、接口地址和模型 ID

Qoder 模型配置界面,API 类型为 Chat Completions,Base URL 填到 v1
  1. 新建本地任务,在输入框旁的模型选择器中选择刚添加的邀测模型,先发送简单问题,再执行一次文件读写任务。

请求路径与输出限制

遇到 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 自定义供应商

CC Switch 的 Claude Desktop 供应商配置,填写邀测 Key 和请求地址

配置模型角色映射

将各角色的实际请求模型统一映射到邀测模型,减少主会话可用而辅助请求失败的情况:
模型角色菜单显示名实际请求模型声明支持 1M
Sonnetqwen-latest-series-invite-1102qwen-latest-series-invite-1102勾选
Opusqwen-latest-series-invite-1102qwen-latest-series-invite-1102勾选
Haikuqwen-latest-series-invite-1102qwen-latest-series-invite-1102勾选
Fable(如当前版本显示)qwen-latest-series-invite-1102qwen-latest-series-invite-1102勾选
部分版本只显示 Sonnet、Opus 和 Haiku,按实际存在的角色配置即可。勾选 1M 是客户端能力声明,长上下文仍需实际验收。

CC Switch:Claude Desktop 的 API 格式与模型映射

Claude Desktop 角色模型统一映射到邀测模型,并选择 OpenAI Chat Completions 格式

启用路由并验证

  1. 保存供应商,回到列表点击切换 / 启用。若出现提示,选择开始路由并使用它。
  2. 确认供应商为使用中,本地路由状态为运行中。
  3. 完全退出 Claude Desktop 后重新打开,切换到 Code 模式,新建会话,选择本机环境和用于测试的文件夹。
  4. 在模型菜单中选择映射后的显示名,先验证对话,再验证文件工具调用。
使用期间保持 CC Switch 和路由服务运行。模型映射将 Desktop 的角色模型名转换为真实 Qwen 模型 ID,路由将请求转换为本次上游的 Chat Completions 格式。 首次启动停在 Preparing session 时,可能正在准备运行组件。保持网络连接并等待;若长时间无进展,再检查日志和网络。

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 供应商、模型列表和上下文窗口

Codex 供应商配置,添加邀测模型并将初始上下文窗口设为 272000

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

Codex 子代理和自动审批模型映射到邀测模型,上游格式为 Chat Completions 需转换
“自动审批模型”仅指定该功能调用的模型。填入模型 ID 不会自动开启该功能或授予额外工具权限。

开启路由并验证

  1. 保存供应商,启用本地路由,并将 Codex 路由到此供应商。不同版本可能显示“路由到此处”“开始路由”或“需要本地路由”。
  2. 确认供应商正确、路由服务运行,使用期间保持 CC Switch 开启。
  3. 完全退出并重启对应客户端:CLI 重新启动进程,IDE 扩展重新加载窗口。若提示后台 daemon 仍持有旧模型列表,待运行中的任务结束后按提示重启。
  4. 新建会话并选择邀测模型。桌面端进入对应 Codex 模式,CLI 可在 /model 中确认。
  5. 分别验证基础对话、文件工具调用、子代理调用;如使用自动审批,再检查该功能的实际请求。
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 截图对应桌面客户端,终端版请按其独立入口配置。
  1. 添加自定义供应商,填写本次邀测 API Key、Base URL https://qweneval.aliyuncs.com/v1 和模型 ID qwen-latest-series-invite-1102。
  2. 将主模型及 Sonnet、Opus、Haiku 等辅助角色统一映射到 qwen-latest-series-invite-1102。
  3. 上游格式选择 OpenAI Chat Completions(需开启路由),启用 Claude Code 的本地路由。
  4. 保持 CC Switch 和路由运行,启动新会话,验证对话和文件工具调用。
Claude Code 原生使用 Anthropic Messages,本次上游需要协议转换,仅修改 ANTHROPIC_BASE_URL 不足以替代转换步骤。

验收与排查

最小验收

在新会话中依次完成以下检查:
检查项通过标准
基础对话正常回复,没有认证或协议错误
实际模型请求或路由日志中的实际模型为 qwen-latest-series-invite-1102
文件工具在测试目录创建并读取文件,内容正确
辅助请求使用子代理、辅助角色或自动审批时,对应请求路由正确
重启后配置重启客户端后仍能选择模型并完成请求
可使用测试任务:“在当前测试目录创建 agent-check.txt,写入 hello qwen,再读取它并报告内容。”按任务需要选择客户端权限。模型的自我介绍不能证明实际调用模型,请以请求记录为准。

常见故障

现象优先检查
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 连通性,客户端工具兼容性仍需按上文验收。
import getpass
import json
import os
import urllib.request

key = os.getenv("MDATAPLUS_API_KEY") or getpass.getpass("邀测 API Key: ")
payload = {
  "model": "qwen-latest-series-invite-1102",
  "messages": [{"role": "user", "content": "请回复:连接成功"}],
}
request = urllib.request.Request(
  "https://qweneval.aliyuncs.com/v1/chat/completions",
  data=json.dumps(payload, ensure_ascii=False).encode("utf-8"),
  headers={
    "Authorization": "Bearer " + key.strip(),
    "Content-Type": "application/json",
  },
  method="POST",
)
with urllib.request.urlopen(request, timeout=120) as response:
  result = json.load(response)
print(result["choices"][0]["message"]["content"])

提交评测结果

截至 2026 年 11 月 13 日,参考指南标注模型支持图片 / 视频输入及思考模式开关,上下文为 1M,最高并发为 5,默认 TPM 为 300 万,活动结束日期为 2026 年 11 月 18 日。具体权限和额度以账号开通结果及活动后续调整为准。
评测类型页面标注额度提交要求审核通过后激励
体验评测1 亿 Token至少 1 条真实工作复杂任务案例100 元代金券
深度评测2 亿 Token至少 1 条真实工作复杂任务案例,每条附执行过程数据文件300 元代金券
专业评测5 亿 Token自建评测集、完整评测报告及执行过程文件500 元代金券
上述激励均需通过评测报告审核。 接入验证通过后,按评测活动页的当前规则开展真实工作任务评测,并通过页面当前的评测结果表单提交材料。建议记录客户端与 CC Switch 版本、测试时间、实际模型 ID、任务输入、过程轨迹、最终产物、预期结果及可复现问题。评测期间尽量保持同一指定模型;提交前移除 Key 等密钥信息。 模型支持图片或视频输入,不代表各 Agent 客户端及协议转换链路都支持全部多模态任务,需分别验证。实际连通性、工具调用和长上下文能力需使用本人的邀测 Key 完成验收。