从Claude安装到使用CC Switch配置qwen3.7-max大模型的详细步骤文档

一、准备工作

1.1 环境要求

操作系统：macOS、Linux或Windows（WSL2）
Node.js环境（建议v16以上版本）
Homebrew包管理工具（macOS/Linux）
1.2 获取API Key

访问阿里云百炼平台（ https://console.bailian.console.aliyun.com/）
登录或注册账号
在控制台创建API Key
保存好您的API Key（格式为sk-ws-H.xxxxx）

二、安装Claude Code

2.1 安装Node.js

macOS使用Homebrew安装

brew install node

验证安装

node -v
npm -v
2.2 全局安装Claude Code

npm install -g @anthropic-ai/claude-code
2.3 验证安装

claude --version
三、安装CC Switch

3.1 使用Homebrew安装CC Switch

3.1.1 添加CC Switch的Homebrew Tap

brew tap farion1231/ccswitch
3.1.2 安装CC Switch

brew install --cask cc-switch
3.2 启动CC Switch

在应用程序中找到CC Switch并启动
或者在终端中输入：
open -a “CC Switch”
四、配置CC Switch连接阿里云百炼

4.1 启用配置

在CC Switch主界面找到刚添加的供应商
点击"Enable"按钮启用配置
CC Switch会自动将配置写入 ~/.claude/settings.json 文件
五、验证配置

5.1 清理环境变量

unset ANTHROPIC_API_KEY
unset ANTHROPIC_AUTH_TOKEN
5.2 启动Claude Code

claude
5.3 测试对话

在Claude Code中输入：
你好
预期输出：
你好！有什么我可以帮您的吗？
六、常见问题解决方案

6.1 模型找不到错误

错误信息： model ‘claude-opus-4-8’ not found or not supported
解决方案：
检查CC Switch中的模型名称是否设置为 qwen3.7-max
确保没有在其他地方设置了 ANTHROPIC_MODEL 环境变量
6.2 认证冲突警告

警告信息： Both ANTHROPIC_AUTH_TOKEN and ANTHROPIC_API_KEY set
解决方案：
unset ANTHROPIC_API_KEY
unset ANTHROPIC_AUTH_TOKEN
6.3 400 Bad Request错误

可能原因：
Base URL末尾有多余的斜杠
API Key格式错误
模型名称拼写错误
七、进阶配置

7.1 手动编辑配置文件

如果需要手动配置，可以编辑 ~/.claude/settings.json ：
{
“env”: {
“ANTHROPIC_AUTH_TOKEN”: “您的API Key”,
“ANTHROPIC_BASE_URL”: “https://dashscope.aliyuncs.com/apps/anthropic”,
“ANTHROPIC_MODEL”: “qwen3.7-max”
}
}
7.2 多模型切换

通过CC Switch可以轻松管理多个模型：
添加多个供应商配置
需要时点击"Enable"切换
重启Claude Code即可生效
八、安全注意事项

8.1 API Key安全

不要将API Key提交到代码仓库
不要在公开场合分享API Key
定期轮换API Key
如有泄露风险，立即在阿里云控制台禁用并重新生成
8.2 环境变量管理

建议使用专用的环境变量管理工具，避免API Key暴露。
九、总结

通过以上步骤，您已经成功：
安装了Claude Code开发环境
配置了CC Switch管理工具
连接了阿里云百炼的qwen3.7-max大模型