本文介绍如何使用AI网关将Claude Code官方模型迁移至其它模型。
场景概览
当用户使用Claude Code进行开发辅助,但无法使用官方模型时,可通过AI网关将Claude Code使用的模型从官方模型迁移到其他模型服务。
通过AI网关,可实现:
统一接入:统一入口屏蔽各家模型协议差异。
避免锁定:避免被特定供应商锁定。
高可用性:支持供应商A失败后兜底到供应商B。
按需路由:根据模型名称智能路由到不同供应商。
前提条件
迁移步骤
步骤1.创建AI服务
步骤2.创建并调试Model API
在左侧导航栏选择Model API,单击创建Model API,以文本生成为例,单击文本生成选项框中的创建。
在创建Model API页签中,完成基本信息配置,在大模型服务中,服务模型选择单模型服务,服务名称选择已创建的AI服务,单击确定完成创建。
创建完成后,单击右上角调试,在路由调试页输入Prompt,然后单击发送请求。
模型返回正确,则验证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后,可进行以下测试验证迁移效果:
基础对话测试:输入简单问题,验证模型响应正常。
代码生成测试:要求生成特定功能的代码,测试编程能力。
工具调用测试:如果使用MCP工具,可验证工具调用功能是否正常。
多模型切换测试:通过
--model
参数切换不同模型,验证路由功能。