跳到主要内容

CC Switch

CC Switch 是一款跨平台桌面应用，用于集中管理 AI 编程 CLI 工具的 Provider 配置。 官方网站：ccswitch.co

1.1 使用方法​

潞晨云（Luchentech）不在 CC Switch 内置 preset 列表中。请为每个需要接入的应用分别添加 Custom Provider。

前提条件​

  1. 在模型控制台创建 API 密钥。
  2. 从 GitHub Releases 安装 CC Switch。

请勿对潞晨云使用 Universal Provider。Claude Code 与 OpenAI 兼容类应用需要不同的 Base URL，请分别配置。

方式一：CC Switch 界面（推荐）​

对需要接入的每个应用（Claude Code、Codex、OpenCode、OpenClaw 或 Hermes Agent）重复以下步骤：

  1. 在 CC Switch 顶部选择目标应用。
  2. 点击 + 打开 Add Provider（添加 Provider）面板。
  3. 选择 Custom（Claude Code、Codex、Hermes）或 OpenAI Compatible（OpenCode、OpenClaw）。
  4. 将 Name 设置为 Luchentech。
  5. 填入潞晨云 API 密钥。
  6. 设置 Endpoint URL：
    • Claude Code：https://api.luchentech.com/inference
    • Codex、OpenCode、OpenClaw、Hermes：https://api.luchentech.com/inference/v1
  7. 将模型设置为 zai-org/glm-5.1，或在 OpenAI 兼容类应用中点击 Fetch Models 从列表中选择。
  8. 点击 Add，然后在 Provider 卡片上点击 Enable。

方式二：各应用配置示例​

保存 Provider 时，CC Switch 会写入对应配置文件。使用 Custom preset 时，也可在 Provider 编辑器中粘贴等效 JSON。

Claude Code​

Endpoint URL：https://api.luchentech.com/inference

{
  "env": {
    "ANTHROPIC_API_KEY": "your-luchentech-key",
    "ANTHROPIC_BASE_URL": "https://api.luchentech.com/inference",
    "ANTHROPIC_MODEL": "zai-org/glm-5.1"
  }
}

保持 API Format 为 Anthropic Messages（默认）。若该端点不支持 Fetch Models，请手动输入 zai-org/glm-5.1。

Codex Desktop​

切换到 Codex 标签，选择 Custom，并设置：

  • Endpoint URL：https://api.luchentech.com/inference/v1
  • Model：zai-org/glm-5.1
  • 不要启用 Needs Local Routing（潞晨云直接支持 Responses API）。

CC Switch 会生成：

~/.codex/auth.json：

{
  "OPENAI_API_KEY": "your-luchentech-key"
}

~/.codex/config.toml：

model_provider = "custom"
model = "zai-org/glm-5.1"

[model_providers.custom]
name = "custom"
base_url = "https://api.luchentech.com/inference/v1"
wire_api = "responses"
requires_openai_auth = true

启用 Provider 后重启 Codex Desktop，在模型选择器中选择 zai-org/glm-5.1。

Codex CLI 专用配置（profile、project config、env_key）请参阅 Codex。

OpenCode​

选择 OpenAI Compatible：

  • Endpoint URL：https://api.luchentech.com/inference/v1
  • Model：zai-org/glm-5.1

OpenClaw​

选择 OpenAI Compatible：

  • Endpoint URL：https://api.luchentech.com/inference/v1
  • Model：zai-org/glm-5.1

Hermes Agent​

选择 Custom 或 OpenAI Compatible：

  • Endpoint URL：https://api.luchentech.com/inference/v1
  • Model：zai-org/glm-5.1
  • API mode：chat_completions

验证配置​

  1. 在 CC Switch 中启用 Luchentech Provider。
  2. Claude Code：运行 claude 并发送测试 prompt（无需重启终端即可生效）。
  3. Codex Desktop：重启应用，选择 zai-org/glm-5.1，发送测试消息。
  4. OpenCode / OpenClaw / Hermes：关闭并重新打开终端后再启动工具。

若 Claude Code 首次启动要求登录，请在 CC Switch Settings → General 中启用 Skip Claude Code initial setup confirmation，然后重启 Claude Code。

1.2 说明​

  1. Fetch Models：OpenCode、OpenClaw、Hermes 和 Codex 会调用已配置端点上的 GET /v1/models。需要有效的 API 密钥。若请求失败，请手动输入 zai-org/glm-5.1。
  2. 生效时机：Claude Code 支持热重载。Codex Desktop、OpenCode、OpenClaw 和 Hermes 切换 Provider 后需重启应用或终端会话。
  3. 模型 ID：请使用 List Models API 返回的准确模型 ID。

1.3 参考​