在 Claude Code 中使用千问AI平台模型
使用 qwen4-max-preview 时,长输出被截断可设置
CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000。如需使用 qwen4-max,将
ANTHROPIC_DEFAULT_OPUS_MODEL 设为 qwen4-max,并将 CLAUDE_CODE_MAX_CONTEXT_TOKENS 保持为 983616。长输出被截断可设置 CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000。qwen4-max 的上下文长度为 1M Token;非思考模式最大输出 131,072 Token,思考与最终回答合计最大 262,144 Token;默认 reasoning_effort=high,thinking_budget=131072。快速接入
选择你使用的客户端,完成配置。
- CLI
- CC Switch
- IDE 插件
- 桌面版
1
配置模型
- Token Plan
- 按量计费
以上环境变量只对当前终端生效。需要持久化配置时,使用通过配置文件接入。
2
验证
运行以下命令验证:
通过配置文件接入
除了上述方式,也可以通过配置文件接入。
1
打开或新建配置文件
- macOS / Linux:
~/.claude/settings.json - Windows:
C:\Users\<用户名>\.claude\settings.json
2
写入配置
- Token Plan
- 按量计费
3
验证
保存后运行以下命令验证:
配置上下文窗口大小
Claude Code 默认 200K 上下文窗口。模型支持 1M 时,可扩展至 1M(1,000,000 tokens)。
方式一:通过环境变量设置
在 ~/.claude/settings.json 的 env 字段中添加 CLAUDE_CODE_MAX_CONTEXT_TOKENS:
[1m] 后缀,适用于千问AI平台支持 1M 上下文的模型:
权限模式配置
Claude Code 提供 6 种权限模式:
default:每次操作询问用户确认。acceptEdits:自动批准文件编辑,其他操作仍询问。plan:只读规划模式,不执行修改。dontAsk:不询问,需要询问的操作直接拒绝。bypassPermissions:绕过所有权限检查。delegate:委托模式。
--permission-mode 指定本次会话的默认权限模式:
/permissions 管理工具的预批准和预拒绝规则,支持 bash、edit 和 MCP 工具。
方式三:settings.json 配置
在 ~/.claude/settings.json 的 permissions 字段中配置:
接入 CLI 工具
错误码
配置过程中遇到报错,参考对应套餐的常见问题文档:
- Token Plan:Token Plan 常见问题
- 按量计费:错误码
常见问题
如何跳过 Anthropic 官方登录验证?
如何跳过 Anthropic 官方登录验证?
编辑或新建
~/.claude.json(Windows 路径:C:\Users\<用户名>\.claude.json),将 hasCompletedOnboarding 设为 true,跳过 Anthropic 官方登录验证。调用时返回 401 invalid_api_key
调用时返回 401 invalid_api_key
此错误表示 API Key 类型与
排查步骤如下:
ANTHROPIC_BASE_URL 不匹配。千问AI平台提供多种接入方式,每种方式使用不同的 base_url 和专属 API Key,两者必须配套使用:| 接入方式 | base_url | API Key |
|---|---|---|
| Token Plan | https://token-plan.maas.qianwenaiapi.com/apps/anthropic | Token Plan API Key |
| 按量计费 | https://maas.qianwenaiapi.com/apps/anthropic | 千问AI平台 API Key(sk- 开头) |
- 检查请求地址。查看
~/.claude/settings.json中ANTHROPIC_BASE_URL的取值。 - 确认 API Key 类型。对照上表,确认所用 API Key 的类型与
base_url匹配。 - 修正配置。使用千问AI平台按量计费 API Key 时,将
ANTHROPIC_BASE_URL设为https://maas.qianwenaiapi.com/apps/anthropic。
启动 Claude Code 后,界面显示"Unable to connect to Anthropic services. Failed to connect to api.anthropic.com: ERR_BAD_REQUEST"
启动 Claude Code 后,界面显示"Unable to connect to Anthropic services. Failed to connect to api.anthropic.com: ERR_BAD_REQUEST"
此错误表示 Claude Code 正在尝试连接 Anthropic 官方服务而非千问AI平台。通常是环境变量未正确配置或未生效。按以下步骤排查:
- 检查配置。启动 Claude Code 后执行
/status命令,确认ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN是否正确指向千问AI平台地址。输出为空或指向非千问AI平台地址时,检查settings.json配置是否正确。 - 确认 hasCompletedOnboarding。检查
~/.claude.json文件中hasCompletedOnboarding是否设置为true。未设置时,Claude Code 启动后会尝试连接 Anthropic 官方服务进行登录验证。 - 重新打开终端。修改配置文件后,需要新开一个终端窗口再执行
claude,配置才会生效。 - 更新 Claude Code。若以上步骤均无效,可能是 Claude Code 版本过旧导致。执行
npm install -g @anthropic-ai/claude-code@latest更新到最新版本后重试。
使用旧版接口,切换模型不生效
使用旧版接口,切换模型不生效
旧版兼容接口
https://maas.qianwenaiapi.com/api/v2/apps/claude-code-proxy 仅支持已下架的模型,指定其他模型不会生效。如需调用可用模型,按本文配置迁移至新版接口。使用 CC Switch 添加供应商时提示"未找到可用的模型列表端点,请检查 Base URL 或确认供应商是否开放端口"
使用 CC Switch 添加供应商时提示"未找到可用的模型列表端点,请检查 Base URL 或确认供应商是否开放端口"
该提示来自 CC Switch 保存供应商时的连通性检查——它会向配置的请求地址探测模型列表端点(如
/v1/models)。千问AI平台的 Anthropic 兼容接入端点(以 /apps/anthropic 结尾)仅提供对话端点 /v1/messages,不提供模型列表端点,该探测因此返回 404,CC Switch 据此提示"未找到可用的模型列表端点"。该提示不影响 Claude Code 正常使用,可忽略。Claude Code 通过 /v1/messages 发起对话,所用模型由 CC Switch 高级选项中的模型映射直接指定,不依赖模型列表端点的自动发现。请求地址与 API Key 配置正确时,直接点击启用并新开一个 Claude Code 会话即可正常对话。若确实无法对话,请确认:请求地址以 /apps/anthropic 结尾、勿额外添加 /v1,并已在高级选项的模型映射中填入对应套餐支持的模型。CC Switch 中模型映射后无法调用
CC Switch 中模型映射后无法调用
模型映射配置后在 Claude Code 中无法调用、返回
AccessDenied(HTTP 403,错误码 access_denied)错误时,检查该模型是否在千问AI平台控制台的模型广场中被标记为“即将下线”。标记为“即将下线”的模型仍会显示在列表中,但 API 调用会返回 403 AccessDenied。排查步骤如下:- 检查模型是否标记“即将下线”。在千问AI平台控制台的模型广场搜索所用模型,查看其状态标签。
- 更换为最新可用模型。将模型映射中的旧版模型(如
qwen-coder-turbo-0919)替换为最新版本的可用模型(如qwen3.8-max)。 - 重新配置模型映射并测试。在 CC Switch 的高级选项中更新模型映射,点击启用并新开一个 Claude Code 会话验证。