工具接入
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 Code | https://api.lynshen.org | 默认模型;Haiku、Sonnet、Opus 模型映射 | ~/.claude/settings.json 的 env |
| Codex | https://api.lynshen.org/v1 | 上游格式选 “Responses (native)”;模型 | ~/.codex/config.toml |
| OpenCode | https://api.lynshen.org/v1 | npm 包(OpenAI Compatible、OpenAI Responses 或 Anthropic);模型列表 | ~/.config/opencode/opencode.json |
API Key 一律填写你的 sk-... 密钥。
添加服务商
- 在 CC Switch 侧栏选择目标工具,例如 Claude Code。
- 点击 + Add Provider。
- 选择 Custom Configuration(OpenCode 也可以选 OpenAI Compatible 预设)。
- 名称填
LynShen。 - 按上表填写端点和 API Key。
- 点击 Auto-Fetch Models,从
/v1/models获取模型列表。也可以手动填写模型 ID。 - 保存。
- 点击 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-5Codex:
ccswitch://v1/import?resource=provider&app=codex&name=LynShen&endpoint=https%3A%2F%2Fapi.lynshen.org%2Fv1&apiKey=sk-...&model=gpt-5.5OpenCode:
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 只写配置文件。模型选择和推理显示由目标工具决定:
- Claude Code:见 Claude Code。
- Codex:见 Codex。
- OpenCode:见 opencode。
常见问题
| 现象 | 原因和处理 |
|---|---|
| 切换后工具仍使用旧配置 | 重新启动目标工具。 |
| 手动改过的配置被覆盖 | 切换服务商时,CC Switch 会覆盖端点、密钥和模型等字段。在 CC Switch 中修改,不要直接改配置文件。 |
| Codex 桌面版看不到自定义模型 | Codex 桌面版在没有官方登录时可能隐藏自定义模型。CC Switch 的指南建议打开 “Keep official login for direct switches”。 |
| Claude Code 返回 404 | Claude Code 的端点不能带 /v1。 |
CC Switch 自己的数据保存在 ~/.cc-switch/,主要是 cc-switch.db。
来源
2026-10-11 查阅: