Monoize
工具接入

CC Switch

用 CC Switch 把 LynShen 添加为 Claude Code、Codex、opencode 等工具的服务商,并一键切换。

CC Switch 是一个桌面应用,用来管理多个编程工具的服务商配置。它把你填写的服务商写入各工具的配置文件。本页按 CC Switch v4.0.8(2026-10-10 发布)编写。

  • 平台:Windows 10 及以上、macOS 12 及以上、Linux(deb、rpm、AppImage,另有 AUR 包)。
  • 支持的工具:Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code。

LynShen 没有 Gemini 原生端点。不要在 CC Switch 中为 Gemini CLI 添加 LynShen。

各工具填写什么

目标工具端点(Endpoint)其他字段CC Switch 写入的文件
Claude Codehttps://api.lynshen.org默认模型;Haiku、Sonnet、Opus 模型映射~/.claude/settings.json 的 env
Codexhttps://api.lynshen.org/v1上游格式选 “Responses (native)”;模型~/.codex/config.toml
OpenCodehttps://api.lynshen.org/v1npm 包(OpenAI Compatible、OpenAI Responses 或 Anthropic);模型列表~/.config/opencode/opencode.json

API Key 一律填写你的 sk-... 密钥。

添加服务商

  1. 在 CC Switch 侧栏选择目标工具,例如 Claude Code。
  2. 点击 + Add Provider。
  3. 选择 Custom Configuration(OpenCode 也可以选 OpenAI Compatible 预设)。
  4. 名称填 LynShen。
  5. 按上表填写端点和 API Key。
  6. 点击 Auto-Fetch Models,从 /v1/models 获取模型列表。也可以手动填写模型 ID。
  7. 保存。
  8. 点击 LynShen 卡片,切换为当前服务商。切换后,重新启动目标工具。

CC Switch 为 Claude Code 写入 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN(以 Authorization: Bearer 发送)和模型变量。为 Codex 写入 [model_providers.custom],wire_api = "responses",密钥放在 experimental_bearer_token 中。

用深度链接导入

CC Switch 支持 ccswitch:// 链接。在浏览器中打开链接,CC Switch 会弹出确认框。导入后不会自动切换,需要手动点击卡片。

把下面链接中的 sk-... 和模型 ID 换成你的值。端点必须经过 URL 编码。

Claude Code:

ccswitch://v1/import?resource=provider&app=claude&name=LynShen&endpoint=https%3A%2F%2Fapi.lynshen.org&apiKey=sk-...&model=claude-sonnet-5

Codex:

ccswitch://v1/import?resource=provider&app=codex&name=LynShen&endpoint=https%3A%2F%2Fapi.lynshen.org%2Fv1&apiKey=sk-...&model=gpt-5.5

OpenCode:

ccswitch://v1/import?resource=provider&app=opencode&name=LynShen&endpoint=https%3A%2F%2Fapi.lynshen.org%2Fv1&apiKey=sk-...&model=deepseek-v4-pro
  • Claude 链接还可以带 haikuModel、sonnetModel、opusModel 参数。
  • Codex 链接不带 model 时,CC Switch 默认填 gpt-5-codex,这个模型可能不在你的列表中。请始终带上 model。
  • OpenCode 链接固定使用 @ai-sdk/openai-compatible,也就是 Chat Completions。
  • Claude Desktop、Pi、MiniMax Code 不支持用深度链接导入服务商。

深度链接中包含密钥。不要把它发到公开的群聊或网页。

选择模型和显示推理

CC Switch 只写配置文件。模型选择和推理显示由目标工具决定:

常见问题

现象原因和处理
切换后工具仍使用旧配置重新启动目标工具。
手动改过的配置被覆盖切换服务商时,CC Switch 会覆盖端点、密钥和模型等字段。在 CC Switch 中修改,不要直接改配置文件。
Codex 桌面版看不到自定义模型Codex 桌面版在没有官方登录时可能隐藏自定义模型。CC Switch 的指南建议打开 “Keep official login for direct switches”。
Claude Code 返回 404Claude Code 的端点不能带 /v1。

CC Switch 自己的数据保存在 ~/.cc-switch/,主要是 cc-switch.db。

来源

2026-10-11 查阅:

本页目录