快速开始
将 Claude Desktop 接入 CChello，共四步。
- 登录：在控制台使用已有账户的邮箱验证码登录。
- 生成命令：在控制台“安装”页选择系统（Windows 或 macOS）生成命令。命令 15 分钟内有效，只能使用一次，不含长期密钥。
- 运行命令：在终端中粘贴并运行命令。脚本会配置 Claude Desktop；未安装时下载并安装，然后打开客户端。
- 开始使用：启动 Claude Desktop，直接进入主界面，无需登录 Anthropic 账号。
备用：手动配置
仅在自动配置失败时使用。
控制台“安装”页底部提供四个配置项，对应 Claude Desktop 官方文档公开的第三方推理策略：
inferenceProvider：填写gateway。inferenceGatewayBaseUrl：填写控制台显示的网关地址。inferenceGatewayApiKey：填写控制台显示的客户端连接密钥。inferenceGatewayAuthScheme：填写bearer。
在 Claude Desktop 的第三方推理配置中手动填入以上四项即可。
撤销配置
在控制台“安装”页复制对应系统的还原命令并运行。Windows 的脚本读取备份文件恢复写入前的策略项，并清理备份文件；若执行前未配置过策略项，将清除写入的键值。macOS 从备份还原四项连接策略；旧版安装没有备份时清除这四项策略。还原不删除客户端。
计费说明
扣费 = 输入 token × 输入单价 + 输出 token × 输出单价 + 缓存读写 token × 对应单价，各项向上取整到 1 micro-USD（$0.000001）。
全系模型均按官方标准费率 5 折计费，余额以整数 micro-USD 结算，没有浮点误差。以 claude-sonnet-5-5 为例（5 折后输入 $1.00 / 百万 token，输出 $5.00 / 百万 token）：单次请求输入 1,842 token、输出 536 token、缓存读 0 token，计算式为 1,842 × $1.00 + 536 × $5.00 ÷ 1,000,000，扣费结果为 $0.004522。
若用量明细中出现带有“估算”徽标的记录，表明该次请求上游没有返回完整 usage，token 按字符数估算。
常见问题排查
| 现象 | 原因 | 处理 |
|---|---|---|
| 客户端提示认证失败 (401) | 客户端连接密钥无效或已吊销 | 返回控制台“安装”页重新生成命令并重新配置；也可到“密钥”页检查凭证状态。 |
| 客户端提示额度不足 (402) | 账户可用余额已消耗完毕 | 前往控制台“充值”页充值，充值后即可继续使用。 |
| 客户端提示请求过快 (429) | 发送消息频率过高 | 稍等片刻再发送消息。 |
| 客户端提示服务不可用 (502 / 503) | 服务暂时不可用 | 稍后重试；持续出现请联系支持。 |
| 命令被安全软件拦截 | 部分安全防护软件对从网络下载执行脚本的行为实施拦截。 | 不要尝试关闭安全软件；改用控制台“安装”页提供的备用手动配置。 |
| 命令提示口令已用或过期 | 口令超过 15 分钟有效时间或已被兑换使用。 | 返回控制台“安装”页重新生成一条新的配置命令。 |
| 已加入域，普通窗口写不了策略目录 | 系统锁定了 HKCU\SOFTWARE\Policies，当前窗口只有读取权限。 | 安装命令会改写入官方本地配置目录，不需要管理员权限。只有该位置已经有策略值、会盖过本地配置时，才需要用当前登录账户的管理员窗口重试。 |
安全与边界
- 官方安装包，校验签名（仅 Windows）：优先从 Anthropic 官方地址下载并校验数字签名；官方源低于 100 KB/s 或无法连接时，改用本站托管的同一官方安装包，同样校验 Authenticode 签名与 SHA-256。
- 可审计、可撤销：命令使用 15 分钟有效的单次口令，不含长期密钥；脚本为纯文本，控制台提供全文和 SHA-256；运行前列出全部动作；Windows 写入前备份旧值，两个系统都提供还原命令；全程 HTTPS。
- 不绕过安全防护：脚本以普通用户权限运行，不提权，不修改 ExecutionPolicy，不关闭杀毒软件。被安全软件拦截时，请改用备用手动配置。策略目录被系统锁定时，脚本改写官方本地配置，仍不申请管理员权限。
- 只写官方支持的配置：优先写入 HKCU\Software\Policies\Claude 的 4 个官方策略键。该目录不可写时，把同样的 4 个键写入官方本地配置目录 %LOCALAPPDATA%\Claude-3p\configLibrary。不修改客户端程序文件，不写其他文件。