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，也不要手动追加 /v1/messages。

安装

• 建议准备 Node.js 22 或更高版本。
• 终端用户安装或更新 Claude Code CLI，确认 claude 命令可用。
• VS Code 或基于 VS Code 的 IDE 用户，可在扩展市场搜索并安装 Claude Code for VS Code 插件。
• CLI 与 IDE 插件任选其一即可；建议先完成下面的 settings.json 配置，再启动 Claude Code。

npm install -g @anthropic-ai/claude-code@latest
claude --version

准备

• 确认用户级配置目录存在：macOS / Linux 为 ~/.claude，Windows 通常为 C:\Users\你的用户名\.claude。
• 请求 GET https://api.lingyuncx.com/v1/models，记录可用于 Claude / Anthropic Messages 的模型 ID。
• 准备编辑或新建 ~/.claude/settings.json，不要把 API Key 写进项目目录。
• 如果使用 CC Switch，先安装并启动 CC Switch 桌面端。

直接配置

1. 打开用户级配置。 编辑 ~/.claude/settings.json。Windows 路径通常是 C:\Users\你的用户名\.claude\settings.json。
2. 写入 API Key。 在 env 中设置 ANTHROPIC_AUTH_TOKEN，值为 Ling.AI API Key。
3. 写入 Base URL。 设置 ANTHROPIC_BASE_URL=https://api.lingyuncx.com/anthropic，后面不要加 /v1。
4. 保留可选增强项。 可按示例保留工具搜索、上下文窗口、输出 token 和非必要流量开关；最小可用配置只需要前两个环境变量。
5. 重启 Claude Code。 保存后重启 IDE/CLI，再执行 /status 或短 prompt 验证。

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://api.lingyuncx.com/anthropic",
    "ENABLE_TOOL_SEARCH": "true",
    "CLAUDE_CODE_EFFORT_LEVEL": "max",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "128000",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1000000",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "900000"
  },
  "effortLevel": "max",
  "alwaysThinkingEnabled": true
}

# 如果 CLI 读取不到 settings.json，可临时手动加载环境变量再验证。
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxx"
export ANTHROPIC_BASE_URL="https://api.lingyuncx.com/anthropic"

claude
/status

CC Switch 配置

CC Switch 支持 Claude Code 的 app-specific provider，可以把 Ling.AI 作为 Claude Code 的 Anthropic 兼容供应商保存和切换。使用 CC Switch 时，Base URL 仍然填 https://api.lingyuncx.com/anthropic，不要使用 OAuth reverse proxy 方案替代 Ling.AI API Key。

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，重启 Claude Code CLI 或 IDE 插件，再运行一个短 prompt 验证。

验证

1. 重启 Claude Code 后运行 claude。
2. 进入后输入 /status，确认 BASE URL 为 https://api.lingyuncx.com/anthropic。
3. 执行短 prompt，或使用 claude --model your-model-id-from-v1-models "用一句话说明当前项目"。
4. 回到 Ling.AI 控制台，核对请求记录中的模型 ID、状态、usage 和钱包扣费。
5. IDE 插件中如果仍出现登录提示，可在 Claude Code 对话框输入 /config，勾选 Disable Login Prompt 后再验证。

排障

参考资料

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