跳转到主要内容
接入AI工具

Claude Code

在 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
  • 按量计费
将 YOUR_API_KEY 替换为 Token Plan API Key:
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_BASE_URL="https://token-plan.maas.qianwenaiapi.com/apps/anthropic"
export ANTHROPIC_MODEL="auto"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen3.6-flash"
export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen3.8-flash"
export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen4-max-preview"
export CLAUDE_CODE_SUBAGENT_MODEL="auto"
export CLAUDE_CODE_MAX_CONTEXT_TOKENS="983616"
以上环境变量只对当前终端生效。需要持久化配置时,使用通过配置文件接入。
2

验证

运行以下命令验证:
claude -p "你好"

通过配置文件接入

除了上述方式,也可以通过配置文件接入。
1

打开或新建配置文件

  • macOS / Linux:~/.claude/settings.json
  • Windows:C:\Users\<用户名>\.claude\settings.json
2

写入配置

  • Token Plan
  • 按量计费
将 YOUR_API_KEY 替换为 Token Plan API Key:
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://token-plan.maas.qianwenaiapi.com/apps/anthropic",
        "ANTHROPIC_MODEL": "auto",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.8-flash",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen4-max-preview",
        "CLAUDE_CODE_SUBAGENT_MODEL": "auto",
        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "983616"
    }
}
3

验证

保存后运行以下命令验证:
claude -p "你好"

配置上下文窗口大小

Claude Code 默认 200K 上下文窗口。模型支持 1M 时,可扩展至 1M(1,000,000 tokens)。 方式一:通过环境变量设置 在 ~/.claude/settings.json 的 env 字段中添加 CLAUDE_CODE_MAX_CONTEXT_TOKENS:
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://maas.qianwenaiapi.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus",
        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1000000"
    }
}
方式二:通过模型名称后缀 在模型名称后添加 [1m] 后缀,适用于千问AI平台支持 1M 上下文的模型:
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://maas.qianwenaiapi.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus[1m]",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-plus[1m]",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-plus[1m]",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-plus[1m]"
    }
}
修改配置后,需新开终端窗口重新启动 Claude Code 使配置生效。

权限模式配置

Claude Code 提供 6 种权限模式:
  • default:每次操作询问用户确认。
  • acceptEdits:自动批准文件编辑,其他操作仍询问。
  • plan:只读规划模式,不执行修改。
  • dontAsk:不询问,需要询问的操作直接拒绝。
  • bypassPermissions:绕过所有权限检查。
  • delegate:委托模式。
方式一:命令行参数 使用 --permission-mode 指定本次会话的默认权限模式:
claude --permission-mode plan
claude --permission-mode acceptEdits
方式二:交互命令 在会话中输入 /permissions 管理工具的预批准和预拒绝规则,支持 bash、edit 和 MCP 工具。 方式三:settings.json 配置 在 ~/.claude/settings.json 的 permissions 字段中配置:
{
    "permissions": {
        "allow": ["Bash(git:*)", "Read", "Edit"],
        "deny": ["Bash(rm:*)"],
        "defaultMode": "default"
    }
}

接入 CLI 工具

1

安装 CLI 工具

请帮我全局安装千问AI平台 CLI 命令行工具:npm install -g @qianwenai/qianwen-cli
2

配置 API Key

前往千问AI平台控制台获取 API Key,然后告诉 Claude Code:
配置我的 API Key 是:sk-xxxxxxxxxxxxx
3

开始使用

直接用自然语言描述需求,例如:
帮我生成 6 张亚马逊电商主图,产品是白色无线蓝牙耳机。
帮我生成一段 30 秒的白色无线蓝牙耳机产品演示视频。

错误码

配置过程中遇到报错,参考对应套餐的常见问题文档:

常见问题

如何跳过 Anthropic 官方登录验证?

编辑或新建 ~/.claude.json(Windows 路径:C:\Users\<用户名>\.claude.json),将 hasCompletedOnboarding 设为 true,跳过 Anthropic 官方登录验证。
{
  "hasCompletedOnboarding": true
}
此错误表示 API Key 类型与 ANTHROPIC_BASE_URL 不匹配。千问AI平台提供多种接入方式,每种方式使用不同的 base_url 和专属 API Key,两者必须配套使用:
接入方式base_urlAPI Key
Token Planhttps://token-plan.maas.qianwenaiapi.com/apps/anthropicToken Plan API Key
按量计费https://maas.qianwenaiapi.com/apps/anthropic千问AI平台 API Key(sk- 开头)
排查步骤如下:
  1. 检查请求地址。查看 ~/.claude/settings.json 中 ANTHROPIC_BASE_URL 的取值。
  2. 确认 API Key 类型。对照上表,确认所用 API Key 的类型与 base_url 匹配。
  3. 修正配置。使用千问AI平台按量计费 API Key 时,将 ANTHROPIC_BASE_URL 设为 https://maas.qianwenaiapi.com/apps/anthropic。
此错误表示 Claude Code 正在尝试连接 Anthropic 官方服务而非千问AI平台。通常是环境变量未正确配置或未生效。按以下步骤排查:
  1. 检查配置。启动 Claude Code 后执行 /status 命令,确认 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 是否正确指向千问AI平台地址。输出为空或指向非千问AI平台地址时,检查 settings.json 配置是否正确。
  2. 确认 hasCompletedOnboarding。检查 ~/.claude.json 文件中 hasCompletedOnboarding 是否设置为 true。未设置时,Claude Code 启动后会尝试连接 Anthropic 官方服务进行登录验证。
  3. 重新打开终端。修改配置文件后,需要新开一个终端窗口再执行 claude,配置才会生效。
  4. 更新 Claude Code。若以上步骤均无效,可能是 Claude Code 版本过旧导致。执行 npm install -g @anthropic-ai/claude-code@latest 更新到最新版本后重试。
旧版兼容接口 https://maas.qianwenaiapi.com/api/v2/apps/claude-code-proxy 仅支持已下架的模型,指定其他模型不会生效。如需调用可用模型,按本文配置迁移至新版接口。
该提示来自 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,并已在高级选项的模型映射中填入对应套餐支持的模型。
模型映射配置后在 Claude Code 中无法调用、返回 AccessDenied(HTTP 403,错误码 access_denied)错误时,检查该模型是否在千问AI平台控制台的模型广场中被标记为“即将下线”。标记为“即将下线”的模型仍会显示在列表中,但 API 调用会返回 403 AccessDenied。排查步骤如下:
  1. 检查模型是否标记“即将下线”。在千问AI平台控制台的模型广场搜索所用模型,查看其状态标签。
  2. 更换为最新可用模型。将模型映射中的旧版模型(如 qwen-coder-turbo-0919)替换为最新版本的可用模型(如 qwen3.8-max)。
  3. 重新配置模型映射并测试。在 CC Switch 的高级选项中更新模型映射,点击启用并新开一个 Claude Code 会话验证。
千问AI平台控制台的模型广场中标记“即将下线”的模型可能随时不可用,请关注模型生命周期,并在模型广场查看模型的可用状态。