Claude Code

适用边界

Claude Code 使用 Anthropic Messages 协议。接入 Ling.AI 时必须使用 Anthropic 兼容入口 https://api.lingyuncx.com/anthropic，Claude Code 会在这个 Base URL 后继续请求 /v1/messages。不要把 Claude Code 的 Base URL 填成 https://api.lingyuncx.com/v1。

准备

• 确认本机已安装 Claude Code，终端中 claude 命令可用。
• 在 Ling.AI 控制台创建 API Key，确认 Key 启用、余额或套餐可用。
• 请求 GET https://api.lingyuncx.com/v1/models，记录可用于 Claude / Anthropic Messages 的模型 ID。
• 如果使用 CC Switch，先安装并启动 CC Switch 桌面端。

直接配置

1. 设置 API Key。 在 shell 配置文件或当前终端中设置 ANTHROPIC_API_KEY。部分 Claude Code 版本也支持 ANTHROPIC_AUTH_TOKEN，但团队文档统一建议使用 ANTHROPIC_API_KEY。
2. 设置 Base URL。 设置 ANTHROPIC_BASE_URL=https://api.lingyuncx.com/anthropic。
3. 重新加载 shell。 执行 source ~/.zshrc、重开终端，或只在当前终端里临时 export。
4. 启动 Claude Code。 运行 claude，或者用 --model 指定 /v1/models 返回的模型 ID。

export ANTHROPIC_API_KEY="<YOUR_LING_AI_API_KEY>"
export ANTHROPIC_BASE_URL="https://api.lingyuncx.com/anthropic"

claude --model your-model-id-from-v1-models "用一句话说明当前项目"

CC Switch 配置

CC Switch 支持 Claude Code 的 app-specific provider，可以把 Ling.AI 作为 Claude Code 的 Anthropic 兼容供应商保存和切换。Claude Code 通常可以热切换 provider；如果切换后仍失败，再重启终端。

1. 打开工具页。 启动 CC Switch，进入 Claude Code 工具页。
2. 新增 provider。 点击右上角加号或 Add Provider。
3. 选择类型。 使用 Custom Configuration、API Key Provider 或当前版本中等价的自定义供应商类型，不使用 OAuth reverse proxy 方案。
4. 填写名称。 Provider Name 建议填 Ling.AI Anthropic。
5. 填写 Base URL。 Base URL 填 https://api.lingyuncx.com/anthropic。
6. 填写 API Key。 API Key 填 Ling.AI API Key，或按 CC Switch 当前版本支持的方式从系统密钥、环境变量读取。
7. 填写模型。 Model 填 /v1/models 中确认可用于 Claude Code 的模型 ID。
8. 启用 provider。 保存后点击 Enable / Switch，再运行一个短 prompt 验证。

验证

1. 执行 claude --model your-model-id-from-v1-models "用一句话说明当前项目"。
2. 确认终端收到回复。
3. 回到 Ling.AI 控制台，核对请求记录中的模型 ID、状态、usage 和钱包扣费。
4. 如果失败，先检查 ANTHROPIC_BASE_URL 是否为 https://api.lingyuncx.com/anthropic，再检查模型 ID 是否适配 Anthropic Messages。

排障

参考资料

• Claude Code Environment variables
• Claude Code LLM Gateway
• CC Switch 官方仓库