使用AI网关迁移Claude Code官方模型至任意模型

本文介绍如何使用AI网关将Claude Code官方模型迁移至其它模型。

场景概览

当用户使用Claude Code进行开发辅助,但无法使用官方模型时,可通过AI网关将Claude Code使用的模型从官方模型迁移到其他模型服务。

通过AI网关,可实现:

  • 统一接入:统一入口屏蔽各家模型协议差异。

  • 避免锁定:避免被特定供应商锁定。

  • 高可用性:支持供应商A失败后兜底到供应商B。

  • 按需路由:根据模型名称智能路由到不同供应商。

前提条件

迁移步骤

步骤1.创建AI服务

  1. 登录AI网关控制台

  2. 在左侧导航栏,选择实例,并在顶部菜单栏选择地域。

  3. 实例页面,单击目标实例ID

  4. 在左侧导航栏,选择服务,单击创建服务,服务来源选择AI服务

  5. 大模型供应商处选择对应模型提供商,然后在大模型配置中,填写API-KEY,单击确定完成创建。可根据实际需要创建多个不同供应商的服务,实现多模型支持和高可用保障。

    重要
    • API Key建议通过引用凭据方式存储在KMS中,以避免API Key泄露风险。具体操作参见钥引用密钥

步骤2.创建并调试Model API

  1. 在左侧导航栏选择Model API,单击创建Model API,以文本生成为例,单击文本生成选项框中的创建

  2. 创建Model API页签中,完成基本信息配置,在大模型服务中,服务模型选择单模型服务服务名称选择已创建的AI服务,单击确定完成创建。

  3. 创建完成后,单击右上角调试,在路由调试页输入Prompt,然后单击发送请求

  4. 模型返回正确,则验证Model API已正确路由至指定大模型服务。

    说明
    • 若已创建多个大模型服务,在创建Model API时可选择多模型服务,并配置多个AI服务。

    • 路由规则支持通配符匹配,如qwen*匹配所有以qwen开头的模型名称。

    • 开启Fallback后,当主要服务出错或限流时会自动切换到备用服务。

    • 可以配置多个Fallback服务,按顺序进行故障转移。

调试完成后,返回Model API列表,单击所选Model API实例访问入口列下的复制按钮,用以设置Claude Code环境变量。

步骤3.在Claude Code中使用指定模型

设置环境变量

ANTHROPIC_BASE_URL:设置为步骤2中复制的Model API实例访问入口。

ANTHROPIC_AUTH_TOKEN:如果Model API已开启认证,并配置独立的API Key,填写对应的 API Key。如果没有开启认证,需填写一个任意值,不能填空。

export ANTHROPIC_BASE_URL=http://env-xxxxxx-cn-hangzhou.alicloudapi.com

export ANTHROPIC_AUTH_TOKEN=xxxx

使用指定模型启动

qwen3模型为例。

# 使用阿里云 qwen3 模型
claude --model qwen3-coder-plus

步骤4.验证迁移效果

启动Claude Code后,可进行以下测试验证迁移效果:

  1. 基础对话测试:输入简单问题,验证模型响应正常。

  2. 代码生成测试:要求生成特定功能的代码,测试编程能力。

  3. 工具调用测试:如果使用MCP工具,可验证工具调用功能是否正常。

  4. 多模型切换测试:通过--model参数切换不同模型,验证路由功能。