Documentation Scope

先选链路,再看对应文档。

这套文档站只做一件事:把 convertmodel 的接入路径讲清楚。你不需要先读完所有页面,只需要先判断自己属于哪条工作流,再跳到对应页面完成安装、配置和排错。

Claude Code 直连
CCS / CC-Switch
CodePlan 兼容 CC
Codex 兼容 CC

只想最短路径

直接走 Claude Code 直连,最快完成安装与调用验证。

Open Claude Code

想图形化管理配置

使用 CCS / CC-Switch,在桌面端维护多 key、多环境、多客户端。

Open CC-Switch

我走 Anthropic 兼容链路

客户端保留 Claude Code,用 CodePlan 兼容层完成网关映射与账号调度。

Open CodePlan

我已经在用 Codex CLI

保留 Codex CLI 工作流,只把 provider 切到 convertmodel 网关。

Open Codex

开始前先确认三件事

  1. 你用的是哪一个客户端:Claude Code、CC-Switch 还是 Codex CLI。
  2. 你拿到的是哪一种 key:Anthropic 兼容链路还是 OpenAI 兼容链路。
  3. 你的目标是“最快开始”还是“多环境管理”或“兼容已有工作流”。
推荐顺序:如果你没有历史包袱,先完成 Claude Code 直连。只有在你已经有图形化管理需求或既有 Codex 工作流时,再额外接 CCS 或 Codex。

术语速览

API Key

客户端认证凭据。不同协议链路使用的 key 类型可能不同,不能混用。

Base URL

客户端请求入口。convertmodel 的统一入口是 https://convertmodel.net

Compatibility Layer

客户端保持原协议,网关负责模型映射、账号调度和容量控制。

CCS / CC-Switch

图形化配置管理工具,适合桌面端管理多环境,但不是必须依赖。

这套文档不讲什么

  • 不在文档里塞套餐价格、营销文案和站点理念,避免信息混杂。
  • 不把私有脚本、私有群或私有流程当成默认前提。
  • 不强迫你先装 CCS,再去接 Claude Code 或 Codex。