8848AI 工具指南
Claude Code 主力推荐方案
主力推荐：CC Switch
通过 CC Switch 配置 Claude Code
推荐使用 CC Switch 图形化接入 8848API。只需添加一次供应商配置并启用，CC Switch 会自动应用到 Claude Code，无需手动查找或修改配置文件。
推荐按此教程配置8848API 配置信息
应用
Claude Code
供应商名称
8848API
Base URL
https://api.884819.xyz/v1
API Key
8848API 控制台 → 令牌管理 → 添加令牌
验证方式
在 Claude Code 输入 /status
1. 创建 8848API 密钥
- 登录 8848API 控制台。
- 进入左侧“令牌管理”。
- 点击“添加令牌”，创建一个
sk-开头的 API Key。 - 复制并妥善保存，稍后填写到 CC Switch。
不要把完整 API Key 截图发给别人，也不要写入公开仓库。
2. 安装 CC Switch 和 Claude Code
- 从上方官方发布页下载并安装最新版 CC Switch。
- 安装 Claude Code；已经安装的用户可跳过。
- 至少启动一次 Claude Code，让本地配置目录完成初始化。
macOS 首次打开若提示无法验证，请进入“系统设置 → 隐私与安全性”，确认来源可信后选择“仍要打开”。
3. 在 CC Switch 添加 8848API
- 打开 CC Switch。
- 在顶部应用切换区选择 Claude Code。
- 点击右上角加号，新增自定义供应商。
- 名称填写
8848API。 - Base URL 填写
https://api.884819.xyz/v1。 - API Key 填写刚才创建的完整
sk-密钥。 - 保存后，在供应商列表中启用 8848API。
CC Switch 会自动把对应地址和密钥应用到 Claude Code，一般不需要用户手动编辑配置文件。
4. 重启并验证
- 完全退出当前 Claude Code 和终端窗口。
- 重新打开终端并启动 Claude Code。
- 输入
/status。 - 确认 Base URL 显示为
https://api.884819.xyz/v1。 - 发送一个简单代码任务测试；能正常回复即配置成功。
为什么主力推荐 CC Switch
- 图形界面操作，新手更容易配置。
- 不用手动寻找和编辑 Claude Code 配置文件。
- 方便管理、切换和更新多个供应商。
- 配置异常时可直接重新启用，排查更直观。
常见问题
- /status 仍是旧地址：回到 CC Switch 重新启用 8848API，再重启终端。
- 提示鉴权失败：检查 API Key 是否完整，前后不要带空格。
- 没有 Claude Code 面板：升级 CC Switch，并确认 Claude Code 已至少启动过一次。
- 无法正常调用：确认 Base URL 末尾包含
/v1。
手动配置仅作为备用
如果 CC Switch 无法使用，再手动检查 Claude Code 配置中的以下字段：
ANTHROPIC_BASE_URL=https://api.884819.xyz/v1
ANTHROPIC_AUTH_TOKEN=你的8848API密钥正常情况下优先使用 CC Switch，不建议新手直接修改配置文件。