字
字节笔记本
2026年2月22日
Claude Code + Cloudsway MaaS 接入指南
本文介绍如何通过 Cloudsway MaaS 平台接入 Claude Code，支持直接使用 Claude 系列模型，或通过 LiteLLM 代理接入更多 OpenAI 格式的模型。
一、Claude Code + MaaS（直接接入）
仅支持 Claude 系列模型。
安装与配置
bash
# 拉取镜像 Node.js 18 或更高版本
npm install -g @anthropic-ai/claude-code
# 环境变量
export ANTHROPIC_AUTH_TOKEN="{YOUR_API_KEY}"
export ANTHROPIC_BASE_URL="https://genaiapi.cloudsway.net/{YOUR_ENDPOINT}"
export ANTHROPIC_MODEL="claude-sonnet-4@20250514"
# 启动 claude code
claude
# 任意目录执行 claude二、Claude Code + LiteLLM + MaaS（推荐）
支持 MaaS 平台接入 OpenAI 格式的模型，灵活性更高。
1. Postgres 数据库
LiteLLM 需要数据库来存储配置和日志信息。
bash
docker pull postgres
docker run --name my-postgres -e POSTGRES_PASSWORD=123456 -p 5432:5432 -d postgres
docker exec -it my-postgres bash
psql -U postgres
CREATE DATABASE mydatabase;2. LiteLLM
2.1 配置 config.yaml
将以下配置保存到自定义文件夹中（第 2 步需用到该地址）：
yaml
model_list:
- model_name: claude-3-7-sonnet-20250219 # 模型名称，调用 LLM 接口需要传入的参数
litellm_params:
model: claude-3-7-sonnet-20250219 # 实际调用的模型名称
api_base: https://genaiapi.cloudsway.net/{endpoint}/v1/messages
api_key: xxx # 自动转为 x-api-key: Bearer xxx
- model_name: gemini-2.5-flash
litellm_params:
model: gpt-3.5-turbo
api_base: https://genaiapi.cloudsway.net/v1/ai/{endpoint}
api_key: xxx
headers:
Authorization: Bearer xxx # api_base 接口的认证方式
general_settings:
master_key: sk-1234
database_url: postgresql://postgres:123456@{db_url}:5432/my_database # 第一步配置的数据库2.2 启动 LiteLLM
bash
docker pull ghcr.io/berriai/litellm:main-latest
docker run \
-v $(pwd)/config.yaml:/app/config.yaml \
-p 4000:4000 \
ghcr.io/berriai/litellm:main-latest \
--config /app/config.yaml --detailed_debug2.3 模型调用测试
bash
# 查看 config.yaml 中配置了哪些模型
curl http://127.0.0.1:4000/v1/models
# 给模型 gemini-2.5-flash 生成认证 key
curl 'http://0.0.0.0:4000/key/generate' \
--header 'Authorization: Bearer sk-1234' \
--header 'Content-Type: application/json' \
--data-raw '{"models": ["gemini-2.5-flash"], "metadata": {"user": "ishaan@berri.ai"}}'
# 得到 {"key": "sk-wnm6JQ-f1U2Sixpa8L-0xg"}
# 调用模型接口
curl --location --request POST 'http://127.0.0.1:4000/chat/completions' \
--header 'Authorization: Bearer sk-wnm6JQ-f1U2Sixpa8L-0xg' \
--header 'Content-Type: application/json' \
--data-raw '{
"model": "gemini-2.5-flash",
"max_tokens": 2000,
"stream": false,
"messages": [
{
"role": "user",
"content": "What is the weather like in San Francisco?"
}
]
}'3. Claude Code 配置
3.1 Claude Code 使用
bash
# 拉取镜像 Node.js 18 或更高版本
npm install -g @anthropic-ai/claude-code
# 环境变量
export ANTHROPIC_BASE_URL=http://127.0.0.1:4000 # LiteLLM 的 IP 和端口
export ANTHROPIC_MODEL=gemini-2.5-flash # 调用哪个模型
export ANTHROPIC_AUTH_TOKEN=sk-1234 # 认证 key
# 启动 claude code
claude
# 任意目录执行 claude3.2 Claude Code UI
启动后可以通过 Web UI 访问：
text
http://{claude code ip}:{claude code port}/ui/
用户名：admin
密码：sk-1234总结
通过 Cloudsway MaaS 平台接入 Claude Code 有两种方式：
- 直接接入：配置简单，但仅支持 Claude 系列模型
- LiteLLM 代理：支持更多模型类型，适合需要灵活切换模型的场景
推荐使用第二种方案，通过 LiteLLM 可以统一管理多个模型提供商，并通过统一的 OpenAI 格式接口调用。
分享: