星空 API 使用指南

Appearance

Claude Code：用 CC Switch 一键导入 ​

本页适用于 Mac 上的 Claude Code。只需要完成这一页，不用再填写 Codex 的配置表单。

开始前，先登录并核对已有卡或套餐，再创建自己的 Key。所用卡或套餐应明确支持 Claude Code；不要直接照抄 DeepSeek 体验卡示例。

第一步：安装 CC Switch 和 Claude Code ​

已经安装好两个软件，可以跳到第二步。

安装 CC Switch ​

  1. 打开 CC Switch 官方下载页。
  2. 在 Assets 中下载名称带 macOS 的 .dmg 文件。
  3. 在 Finder → 下载中双击该文件，按安装窗口指引将 CC Switch 放进 应用程序。
  4. 打开 CC Switch，确认左侧能看到 Claude Code。

安装 Claude Code ​

  1. 按 Command + 空格，输入“终端”，按回车打开。
  2. 复制下面的安装命令，粘贴到终端并按回车。命令来自 Claude Code 官方安装说明。
sh
# 安装官方 Claude Code；等待安装结束，终端重新出现可输入命令的提示。
curl -fsSL https://claude.ai/install.sh | bash
  1. 安装完成后，关闭这个终端窗口，重新打开终端。
  2. 输入下面的命令并按回车，看到版本号就安装成功。
sh
# 检查 Claude Code 是否已安装成功。
claude --version

如果提示 command not found，先看安装命令最后的提示以及 官方安装排查说明，不要继续填写 API 配置。

✅ 本节完成检查点：CC Switch 能打开，终端能显示 Claude Code 版本号。

第二步：从星空网页导入 ​

确认 Claude Code 与 CC Switch 都已安装后，回到网页操作。

  1. 先安装并打开 CC Switch。
  2. 登录 星空控制台，进入 API 密钥。
  3. 找到用于 Claude Code 的密钥，确认它的分组支持 Claude Code 所需的协议和模型。
  4. 在这一行的操作区点击 ① 导入到 CCS。
  5. 如果网页弹出目标工具选择，选择 Claude Code；浏览器询问是否打开 CC Switch 时，点击允许。
  6. 在 CCS 的导入预览中，逐项检查：目标应用是 Claude Code，供应商来自星空，API 地址与网页提供的端点一致，密钥不是空的。核对后确认导入；完整 Key 不要截图展示。
  7. 回到 CCS 左侧的 Claude Code，找到刚导入的星空供应商，点击该供应商的启用操作。
  8. 确认刚导入的供应商显示 使用中，再继续下面第三步。
Claude Code：在星空 API 密钥页面，点击对应密钥行的①导入到 CCS。
截图与操作标注

文字看不清？点“放大细节”。按 Esc 或点击“关闭”返回。

💡 认准“导入到 CCS”

“导入到 CCS”是唤起 CC Switch 的入口；旁边的“一键配置”是另一项功能。本节使用导入入口，不需要再执行 Codex 的配置脚本。截图只展示按钮位置，操作时要选择你自己用于 Claude Code 的那把 Key。

✅ 本节完成检查点：已从网页导入到 CCS 的 Claude Code 分类，星空供应商显示“使用中”。

第三步：启动 Claude Code，发送问候 ​

  1. 如果终端里已开着旧 Claude Code 会话，先退出旧会话。
  2. 新开一个终端窗口，复制下面三行命令并执行：
sh
# 新建一个专门用于测试的空文件夹。
mkdir -p ~/xkapi-claude-test
# 进入该文件夹。
cd ~/xkapi-claude-test
# 启动 Claude Code。
claude
  1. 首次启动可能询问主题、目录信任等设置。确认当前目录是自己刚建的 xkapi-claude-test，再根据显示内容选择；不要给不认识的目录授权。
  2. 出现可以输入对话的界面后，输入 你好，请只回复一句问候，不要读取或修改文件。 并发送。
  3. 收到回复后，按 完成检查核对星空使用记录。

✅ 本节完成检查点：Claude Code 已回复，星空有对应请求记录。

卡住了，先检查这几项 ​

卡在哪一步怎么做
点击网页导入没有反应先打开 CC Switch，再点击一次“导入到 CCS”；检查浏览器是否在等你允许打开应用
已导入，但不生效在 CCS 左侧选 Claude Code，确认星空供应商显示“使用中”，再退出旧会话重新启动
仍要求官方账号登录先核对 CCS 是否导入到 Claude Code 分类并已启用；保留界面提示，按工单步骤求助，不要反复重复导入
密钥或模型错误核对导入的是自己的 Claude Code Key，以及卡或套餐对应分组
其他报错查看 常见问题与工单步骤

不要分享含完整 Key 的配置、截图或导入链接。

✅ 本节完成检查点：知道是安装、导入、启用还是请求阶段出了问题。

收到回复了？完成最后的检查 →

仍然失败？查看排查与工单步骤 →

使用 VitePress 构建