通过 KiroaaS + CC Switch 玩转 Claude Code 与 OpenClaw

一、教程概述

本教程将手把手教你利用 KiroaaS 和 CC Switch 配置管理工具，低成本甚至免费使用 Claude Sonnet 4.6、Opus 4.6、DeepSeek-V3.2 等模型，打通 Claude Code（命令行 AI 工具）和 OpenClaw（开源 AI 助手）的使用链路，全程零部署门槛，新手也能轻松上手。

二、核心原理与工具说明

1. 核心思路

Anthropic 官方 API 成本较高，而 Kiro IDE（AWS 出品）的免费/付费套餐包含多款优质模型的访问权限。我们通过「CC Switch 管理配置 → KiroaaS 反向代理」的方式，让 Claude Code/OpenClaw 调用 Kiro 套餐内的模型，链路如下：

css 复制代码

Claude Code / OpenClaw → CC Switch（配置管理）→ KiroaaS（反向代理）→ Kiro

2. 核心工具说明

工具	核心角色	项目地址
KiroaaS	Kiro Gateway 托管版，零部署，带 Web 可视化	kiroaas.hnew.city
CC Switch	桌面端配置管理器，支持切换服务商、管理模型	github.com/farion1231/cc-switch
OpenClaw	开源个人 AI 助手，与 CC Switch 原生兼容	github.com/openclaw/openclaw

三、操作步骤

第一步：获取 KiroaaS 配置信息（零部署）

KiroaaS 是 Kiro Gateway 的 SaaS 版本，无需本地部署，直接使用即可：

访问 KiroaaS 官网：kiroaas.hnew.city/；
在网页端登录/绑定你的 Kiro 账户凭证；
完成绑定后，复制平台分配的「API Base URL」和「API Key」（后续配置会用到）；
可选：直接在 KiroaaS 中一键导出配置（方便后续导入 CC Switch）。

KiroaaS 优势

零部署、零运维，打开网页就能用；
兼容 OpenAI 和 Anthropic 双 API 格式，可对接 Cursor、Continue 等工具；
可视化管理凭据，无需命令行操作。

第二步：安装并配置 CC Switch

2.1 安装 CC Switch

macOS（推荐） ：通过 Homebrew 安装

bash 复制代码

brew tap farion1231/ccswitch
brew install --cask cc-switch

Windows ：从 GitHub Releases 下载 .msi 安装包，双击安装；
Linux ：选择对应系统的 .deb/.rpm/.AppImage 包安装。

2.2 配置 Claude Code 对接 KiroaaS

打开 CC Switch，顶部切换到「Claude Code」标签页；
点击「Add Provider」→ 选择「Custom」（自定义）；

填写配置信息（二选一）：

字段	自建 Gateway 值	KiroaaS 值（推荐）
Name	KiroaaS	KiroaaS
Base URL	http://localhost:8000	KiroaaS 分配的 API Base URL
API Key	.env 中的 PROXY_API_KEY	KiroaaS 分配的 API Key

保存后，点击该 Provider 旁的「Enable」按钮激活；说明：CC Switch 会自动修改 ~/.claude/settings.json，将 Claude Code 的请求指向 KiroaaS。

2.3 配置 OpenClaw 对接 KiroaaS（CC Switch v3.11.0+ 支持）

切换到「OpenClaw」标签页；
点击「Add Provider」→「Custom」；
填写上述相同的 Base URL 和 API Key；
配置模型（二选一）：
- 自动填充：在 OpenClaw 的 AgentsDefaults 面板点击「Default Model」；
- 手动指定：选择 claude-sonnet-4-6/claude-haiku-4-5/deepseek-v3-2（Kiro 免费套餐可用）；
点击「Enable」启用该 Provider。

2.4 启用 CC Switch 本地代理（推荐）

本地代理可实现日志监控、故障自动转移等功能，配置步骤：

进入 CC Switch 的「Settings → Proxy」面板；
开启「Local Proxy」（本地代理）；
勾选需要接管的应用（Claude Code / OpenClaw）；
启用后，CC Switch 会启动本地 Axum 代理，新增能力：
- 查看请求日志、Token 用量统计；
- 网关不可用时自动切换到备用服务商（Auto Failover）；
- 熔断器保护，防止频繁报错。
此时请求链路变为：Claude Code → CC Switch → KiroaaS → Kiro API。

第三步：验证链路是否正常

3.1 测试 Claude Code

重启终端（CC Switch 修改配置后需重启，若版本支持热切换则无需重启）；
在终端输入 claude 启动工具；
输入任意问题（如「解释 Python 装饰器」），确认能正常收到响应。

3.2 测试 OpenClaw

按照 OpenClaw 官方说明启动应用；
发起任意对话，确认模型能正常回复；可在 CC Switch 的 Session Manager 中查看会话历史。

3.3 查看用量与监控（启用本地代理后）

进入 CC Switch 的「Usage」面板，可查看：

每次请求的 Token 消耗、费用统计；
按天/按服务商的用量汇总；
请求成功率、响应延迟等指标。

四、常见问题

配置后 Claude Code 无响应？
- 检查 KiroaaS 的 API Base URL 和 Key 是否填写正确；
- 确认 CC Switch 中 Claude Code 的 Provider 已启用；
- 重启终端和 CC Switch 重试。
OpenClaw 模型选择失败？
- 确认 CC Switch 版本 ≥ v3.11.0；
本地代理无法启动？
- 检查端口是否被占用（默认端口可在 Proxy 面板修改）；
- 重启 CC Switch 并以管理员权限运行。

五、总结

通过 KiroaaS + CC Switch 的组合，你可以低成本使用优质 AI 模型，同时借助 CC Switch 的可视化管理、故障转移等功能，提升 Claude Code 和 OpenClaw 的使用稳定性。全程无需复杂部署，新手也能快速上手，还能通过用量面板清晰掌握资源消耗，是个人高效使用 AI 工具的优选方案。