本文记录如何使用阿里云百炼的免费 token，通过 claude-code-proxy 转换为 Claude 格式 API，通过 cc switch 管理API，在本地使用 Claude Code。

一、获取阿里云百炼免费 Token

1.1 注册阿里云百炼

1. 访问 阿里云百炼
2. 使用阿里云账号注册/登录
3. 完成实名认证（个人免费额度）

1.2 获取 API Key

1. 进入控制台 → API-KEY 管理
2. 创建新的 API Key
3. 复制保存好你的 API Key（只会显示一次）
   

1.3 免费额度

• 新用户通常一个模型有 100万 token 免费额度，注意有过期时间
• 可用于通义千问系列模型（Qwen-Turbo、Qwen-Plus 等）

二、安装配置 claude-code-proxy

2.1 什么是 claude-code-proxy

claude-code-proxy 是一个代理工具，可以将阿里云百炼的 Openai API 格式转换为 Anthropic API 格式。Claude 只能使用Anthropic API 格式。

2.2 使用

代码地址：https://github.com/fuergaosi233/claude-code-proxy

需要提前安装python 环境，参考QUICKSTART.md，进行操作

## 🚀 Get Started in 3 Steps

### Step 1: Install Dependencies

pip install -r requirements.txt

### Step 2: Configure Your Provider

#### 备份配置文件
cp .env.example .env
# 在 .env 里面编辑下面几个变量:
OPENAI_API_KEY="百炼里面拷贝"
ANTHROPIC_API_KEY="同OPENAI_API_KEY"
OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
# 这里的模型要在百炼的状态要是开启
# Optional: Model mappings (BIG and SMALL models)
BIG_MODEL="MiniMax-M2.5"
# Used for Claude opus requests
MIDDLE_MODEL="MiniMax-M2.5"
# Used for Claude sonnet requests
SMALL_MODEL="MiniMax-M2.5"    
# Used for Claude haiku requests

### Step 3: Start and Use

# Start the proxy server，它会在127.0.0.1:8082 启动代理
python start_proxy.py

可以写个小demo验证下代理有没有成功

# 先试下百炼本身能不能正常运行
import os
from openai import OpenAI

# 注意: 不同地域的base_url不通用（下方示例使用北京地域的 base_url）
# - 华北2（北京）: https://dashscope.aliyuncs.com/compatible-mode/v1
# - 美国（弗吉尼亚）: https://dashscope-us.aliyuncs.com/compatible-mode/v1
# - 新加坡: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
client = OpenAI(
    api_key="sk-填自己的",
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1/",
)
completion = client.chat.completions.create(
    model="MiniMax-M2.5",
    messages=[{'role': 'user', 'content': '你是谁？'}]
)
print(completion.choices[0].message.content)

# 再试下百炼代理成为anthropic 后能不能正常运行
from anthropic import Anthropic

# 方式一：如果已设置环境变量 ANTHROPIC_API_KEY
#client = anthropic.Anthropic()

# 方式二：临时测试（直接填入你的真实密钥）
client = Anthropic(base_url="http://127.0.0.1:8082",
                   api_key="sk-填自己的")

response = client.messages.create(
    model="MiniMax-M2.5",   # 速度快且便宜，适合测试
    max_tokens=100,
    messages=[{"role": "user", "content": "说一声你好"}]
)
print(response.content[0].text)

成功运行后应该会有两个输出

proxy会打印请求日志，看到下面就是成功了

三、安装 Claude Code

3.1 安装 Claude Code CLI

建议使用npm 安装，因为用软件包安装会在C盘安装，npm 可以自行修改安装地址
参考地址：https://github.com/anthropics/claude-code

# 安装最新版
npm install -g @anthropic-ai/claude-code
# 能看到版本就是安装成功了
claude --version

四、使用 cc switch 切换模型

4.1 安装 cc switch

cc switch 是 Claude Code 的模型切换工具，可以让你使用可视化界面在多个模型之间切换。

参考地址：https://github.com/farion1231/cc-switch/blob/main/README_ZH.md

4.2 配置模型

填写api key 和本地代理地址

五、验证

# 使用 Claude Code
claude --print "你好，请介绍一下你自己"

如果一切正常，你应该能看到 Claude 的响应。

六、注意事项

1. 免费额度用完: 阿里云百炼的免费额度用完后需要付费
2. API 限流: 注意 API 调用频率限制
3. 模型映射: claude-code-proxy 会将 Claude 模型名称映射到对应的通义千问模型
4. 网络问题: 确保可以正常访问阿里云 API

七、总结

通过以上步骤，你就可以白嫖阿里云百炼的免费 token 来使用 Claude Code 了。这种方式适合：

• 学习和测试 Claude Code
• 在免费额度内日常使用
• 作为备用 API 来源

祝你使用愉快！

---

如果有问题，欢迎在评论区留言讨论。