CC Switch

CC Switch 是一款开源的跨平台（macOS、Windows、Linux）桌面应用程序，用于通过单一图形界面管理 Claude Code、Codex CLI 和 OpenCode 的配置，通过单一图形界面进行管理。无需手动编辑 ~/.claude/settings.json 或 ~/.codex/config.toml，你可以保存 Hostlinku 提供商的配置文件，从 /v1/models 自动获取模型列表，并只需单击一下（或通过 系统托盘图标）即可切换模型/密钥。

安装 CC Switch

请根据您的操作系统选择安装方法： macOS (Homebrew)：

brew tap farion1231/ccswitch
brew install --cask cc-switch

或者从 GitHub Releases 下载 .dmg / .tar.gz 文件。 Windows： 从 GitHub Releases 下载安装程序 CC-Switch-v*-Windows.msi 或便携版 .zip。 Linux：

# Arch Linux (AUR)
paru -S cc-switch-bin

对于 Ubuntu/Debian/Fedora 及其他发行版，请从 GitHub 发布页面下载 .deb、.rpm 或 .AppImage 包。

一键快速导入（深度链接）

CC Switch 支持 ccswitch://v1/import 协议。安装 CC Switch 后，在终端中执行以下命令（或在浏览器中打开该 URL），即可自动填写 Hostlinku 提供商的表单 ——您只需在确认对话框中粘贴 API 密钥 sk-… 即可。 导入 Hostlinku 的预设以供 Claude Code 使用：

# macOS: open "ccswitch://..." | Linux: xdg-open "ccswitch://..." | Windows: start "" "ccswitch://..."
open "ccswitch://v1/import?resource=provider&app=claude&name=Hostlinku&homepage=https%3A%2F%2Fhostlinku.com&endpoint=https%3A%2F%2Fapi.hostlinku.com&model=claude-sonnet-4-6&haikuModel=deepseek-v4-1-flash&sonnetModel=claude-sonnet-4-6&opusModel=claude-opus-4-6"

导入 Hostlinku 的 Codex CLI 预设：

open "ccswitch://v1/import?resource=provider&app=codex&name=Hostlinku&homepage=https%3A%2F%2Fhostlinku.com&endpoint=https%3A%2F%2Fapi.hostlinku.com%2Fv1&model=gpt-5-5"

通过 CC Switch 连接 Claude Code

通过 CC Switch 连接 Codex CLI

故障排除

症状	原因与解决方案
CC Switch 设置对 Claude Code 无效	`~/.zshrc` 中仍存在 Anthropic OAuth 登录会话或 `ANTHROPIC_*` 变量。在 `claude` 中运行 `/logout`，并清除 shell 中的旧导出变量。
自动获取模型按钮失败	请确保请求 URL 填写为 `https://api.hostlinku.com`（不带双斜杠），且 API 密钥已正确填写。
Codex 在启用后会拒绝 shell 工具	在 Codex 选项卡中选择的模型必须是 Responses-native 的 `gpt-*` 模型（例如 `gpt-5-5`、`gpt-6-astra`、`gpt-6-sol`）。请勿为 Codex 选择非 OpenAI 模型或 `gpt-5-6-terra`。
`400 not available in Service Mode`	所选模型在该服务模式 API 密钥下处于非活动状态。请使用自动获取模型按钮，以便仅显示与该密钥匹配的模型。

相关指南：Claude Code · Codex · DeepSeek Harness · OpenCode。

开始

模型与功能

API

账户

帮助

安装 CC Switch

一键快速导入（深度链接）

通过 CC Switch 连接 Claude Code

通过 CC Switch 连接 Codex CLI

故障排除