本页把常见客户端的接入步骤集中整理。OpenAI 兼容接口基址按要求使用 https://api.claudecodes.org/v1/。各工具版本、模型权限和原生协议支持可能不同，保存前请以目标服务控制台与客户端实际字段为准。
参考指南涉及国内开发工具、Agent 工作区、CC Switch、Claude Code、Claude Desktop、Codex、OpenCode 等。参考文档列出过 deepSeek-V4-flash、bbqwen3.8-flash-next、glm-4.7-flash、nanbeige4.2 等 ID；请先核对目标平台模型列表，名称与别名不要凭记忆填写。
在你使用的目标服务管理控制台进入 API 密钥管理，创建密钥；按用途设置名称、额度、模型权限及可选 IP 限制，创建后立即复制完整密钥。可为不同客户端分别建 Key，便于区分调用记录。管理控制台网址请以服务方公布的信息为准，API 地址不一定是管理入口。
Trae、WorkBuddy / CodeBuddy、Zcode 与 DeepSeek Harness 等通常需要 API 格式、Base URL、Key、模型 ID。OpenAI 兼容 Base URL：https://api.claudecodes.org/v1/。若客户端自动添加 /chat/completions，不要把完整路径再填进 Base URL。
在对话模型菜单打开自定义模型配置，供应商选“自定义”，填入接口地址 https://api.claudecodes.org/v1/、平台 API Key 和支持的模型 ID，保存后在会话中选用并发送简短消息测试。WorkBuddy 生成较长文档时，可先定提纲、确认后再分段展开。
在模型设置中新建自定义供应商，设置名称并启用；API 格式选 Chat Completions，Base URL 填 https://api.claudecodes.org/v1/，Key 粘贴完整密钥。逐项添加平台实际提供的模型 ID，保存后从会话模型菜单选择测试。检查软件是否会自动追加请求路径。
在设置的模型提供商区域新增供应商，将协议设为 OpenAI Chat Completions，地址填上述 Base URL。模型目录分别录入真实 ID 与展示名，并把默认 Agent 模型指向所选供应商和模型。也可按应用支持的格式编辑 cordis.patch.yml：配置 provider、apiKey 环境变量、baseURL、模型目录和默认模型；修改后按应用要求重载。
参考教程以 CC Switch 管理不同客户端渠道。先确认客户端实际使用 OpenAI 兼容还是 Anthropic 原生协议；两种协议不可只靠改写 URL 推断。目标平台若仅确认 OpenAI 兼容接口可用，应优先使用 OpenAI Chat Completions 路线。
从项目官方发布渠道安装后，新建自定义渠道，填写渠道名、接口基址、API Key 和模型 ID；选择与服务端匹配的协议。保存并设为当前渠道后，检查本地代理状态和其监听地址，再由客户端使用该代理。安装页面与版本选项以 CC Switch 当前版本为准。
可经 CC Switch 本地代理接入，也可使用环境变量配置。典型变量包括 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY、ANTHROPIC_MODEL。变量名称和原生 Anthropic 路由须按当前 Claude Code 与目标服务文档核实；不要把 OpenAI 端点误当作原生协议端点。遇到 Beta Header 错误时，检查客户端版本与服务端兼容说明。
在 VS Code 用户设置 JSON 或扩展环境变量中放入与终端相同的服务地址、Key 和模型项；保存后重载窗口并检查扩展选中的模型。不要把 Key 提交到项目仓库或共享设置文件。
参考路线通过 CC Switch 管理渠道或使用客户端支持的环境变量配置。先确认客户端版本提供相应入口，再填写匹配的协议、服务地址、Key 和模型；重启应用后做简单测试。若目标 API 只公布 OpenAI 兼容接口，不要假定 Claude Desktop 的原生协议能直接使用。
在 Codex 的自定义供应商或 OpenCode 的 OpenAI-compatible provider 中填写 Base URL、Key 和真实模型 ID；按客户端版本选择流式 / 路由选项。401 通常先检查 Key 是否完整及多余空格；404 检查模型 ID、协议和最终 URL；超时可增加客户端等待时间；连接失败时检查网络、代理和服务端状态。请求地址示例：https://api.claudecodes.org/v1/chat/completions。
安全提示：不要在命令历史、截图、公开仓库或共享文档中放入真实 API Key。先用受限额度的测试密钥验证。