在 Claude Desktop 中使用 Kitcoding
Claude Desktop 支持把推理端点换成第三方服务(官方称 第三方推理 / Third-Party Inference)。配好之后,Chat、Cowork、Code 全都走 Kitcoding 的额度。
开始之前
- 全程只在图形界面里点,不用改任何配置文件,约 3 分钟
- 需要一个含 Claude 模型分组的 Kitcoding 令牌,推荐
ClaudeCode特价或vip
第 1 步:启用开发者模式
在 Claude Desktop里依次点:
Help(帮助) → Troubleshooting(疑难解答) → Enable developer mode(启用开发者模式)
启用后,菜单栏会多出一个 Developer 菜单。
找不到这些菜单?
说明你的版本还不支持第三方推理。先把应用升级到最新版再试。
第 2 步:打开配置窗口
Developer(开发者) → Configure Third-Party Inference…(配置第三方推理)
这个窗口会实时校验你填的值,并提示每个供应商各自的必填项。
第 3 步:填写连接信息
在 Connection(连接) 区域,先把 Inference provider(推理供应商) 选成 Gateway,然后在 Gateway credentials 卡片里填:
| 字段 | 填什么 |
|---|---|
| Gateway base URL | https://kitcoding.com |
| Gateway API key | 你的 Kitcoding 令牌 |
| Credential kind | Static API key(默认,不用改) |
| Gateway auth scheme | Bearer(默认,不用改) |
auth scheme 两种都行
官方提供 Bearer 和 x-api-key 两个选项。实测 Kitcoding 两种都接受,所以保持默认的 Bearer 即可,不用动。
填完保存。
第 4 步:完全退出,重新打开
⚠️ 配置只在启动时读取
Claude Desktop在启动时读取这份配置,改完必须完全退出再重开,只关窗口不算。
- macOS:菜单栏 Claude → Quit,或
Cmd + Q - Windows:
Ctrl + Q,或从任务栏托盘退出
第 5 步:验证
① 启动时能跳过 Anthropic 登录
配置生效后,登录界面会多出一个选项:跳过 Anthropic 账号登录,直接用你配置的推理供应商启动。看到它就说明配置被读到了。
② 模型列表里是你的分组模型
Kitcoding 实现了 GET /v1/models,所以 Claude Desktop会自动发现你这个令牌能用的模型,不用手动填模型清单。打开模型选择器,看到的应该是你令牌分组里的 Claude 模型。
排查
| 现象 | 原因与解法 |
|---|---|
| 改了配置没反应 | 没有完全退出应用。用 Cmd/Ctrl + Q,别只关窗口 |
报 Invalid token | 令牌填错了,或已被删除/禁用 |
报 分组 X 下模型 Y 无可用渠道 | 令牌分组里没有这个模型。换成含 Claude 模型的分组,见 模型分组 |
| 模型列表是空的 | 令牌分组里没有可用模型;或 base URL 填错 |
| 请求打到了 Anthropic 官方 | base URL 没填对,或多加了 /v1 |
| 长任务跑到 5 分钟就断 | 流式响应静默超时。可在配置窗口把 Stream idle timeout(inferenceStreamIdleTimeoutSec)调大,范围 300–1800 秒 |
| 找不到 Developer 菜单 | 开发者模式没启用,或应用版本太老 |
和其他方式的区别
| 你想要的 | 用哪个 |
|---|---|
| Claude Desktop 走 Kitcoding | 就是本页 |
终端里的 claude 命令 | 配置 Claude Code |
| 图形化管理多个供应商、一键切换 | cc-switch(也支持 Claude Desktop) |