Claude Code 接入星空 API

第一次使用，建议先看 Claude Code 与 CC Switch 的安装准备，再按网页一键导入步骤操作。

推荐方式完成后就可以开始使用，下面的其他配置方式不需要重复操作。

展开：Claude Code 命令行手动配置

安装

打开 Mac 终端。如果已经安装 Homebrew，执行下面的命令；没有 Homebrew 时，按 Claude Code 官方安装页选择适合自己的方式。
为 Claude Code 创建独立 Key，确认分组支持 Anthropic Messages 及 Claude Code 所需能力。
按本地密钥设置加载该 Key 与对应模型。不要拿另一分组的聊天 Key 直接套用。

# Mac 上已有 Homebrew 时使用此安装方式。
brew install --cask claude-code
# 查看版本，确认安装成功。
claude --version

设置地址、Key 和模型

配置项	填什么
Base URL / `ANTHROPIC_BASE_URL`	`https://cdn.api.inxk.com`；不填 `/v1/chat/completions`
API Key / `ANTHROPIC_AUTH_TOKEN`	当前 Messages 分组的完整 Key，不带 `Bearer` 前缀
Model / `ANTHROPIC_MODEL`	平台确认可用于 Claude Code 的模型 ID

# 下列变量只影响当前终端，关闭后需要重新加载。
export ANTHROPIC_BASE_URL="https://cdn.api.inxk.com"
# Key 已由本地密钥设置载入，不在命令中填写真实密钥。
export ANTHROPIC_AUTH_TOKEN="$XKAPI_API_KEY"
export ANTHROPIC_MODEL="$XKAPI_MODEL"
# 清除当前终端里可能冲突的旧认证变量；不删除配置文件。
unset ANTHROPIC_API_KEY
# 在空目录启动，先做一次简单问候测试。
mkdir -p ~/xkapi-claude-test
cd ~/xkapi-claude-test
claude

首次启动时，阅读主题、目录信任或认证确认等提示，按页面说明操作。输入“你好，请只回复一句问候，不要读取或修改文件”，然后查看星空使用记录。

💡 提示

想持久保存并切换配置，可以改用 CC Switch 网页导入。客户端生成的 ~/.claude/settings.json 等文件可能含 Key，请保留在本人电脑，不要复制进项目或分享到 GitHub。

报错或现象	排查方法
仍使用旧账号或旧服务	检查用户级/项目级 Claude 配置是否覆盖了环境变量；只调整冲突项
401 / 无效凭证	检查完整 Key 和 `ANTHROPIC_AUTH_TOKEN`；不要自行添加 `Bearer`
`/v1/messages` 404	检查 Base URL、分组是否支持 Messages；Chat Completions 不能直接替代
模型或工具不兼容	使用平台明确支持 Claude Code 的分组及模型；协议兼容不代表全部功能兼容
429 / 排队 / 超时	停止反复重试，查看并发、预算及平台状态

✅ 本节完成检查点

[ ] Claude Code 能回复测试问候。
[ ] 我知道这里使用 Messages，而不是聊天补全接口。

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

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

Claude Code 接入星空 API ​

安装 ​

设置地址、Key 和模型 ​

Claude Code 接入星空 API

安装

设置地址、Key 和模型