客户端配置自查清单

为什么先看这个

一半以上的报错，都是配置填错了。

配置错了会表现出各种奇怪的症状：有时超时、有时 401、有时 404。先按这张表逐项核对，能省很多时间。

逐项核对表

#	检查项	正确做法	常见错误
1	API 地址	`https://api.juheai.shop`	少了 `https://`
2	结尾	不加 `/v1`	加了 `/v1` 变成 `/v1/v1`
3	协议	`https://`	写成 `http://`
4	API 密钥	复制按钮复制	手动选，漏字符或带空格
5	密钥首尾	没有空格、换行	粘贴时带了换行
6	模型名	模型广场原样复制	手打拼错、大小写不符
7	接口类型	跑 Claude 选 Anthropic	选成 OpenAI
8	代理	我们的域名设为直连	全局代理绕远路
9	超时	≥60 秒	设得太短
10	并发	3-5 个	开太高被限流

最容易错的两个

错误一：地址结尾多了 /v1

大部分客户端会自动补 /v1。

如果你填了 https://api.juheai.shop/v1，客户端再补一次，变成：

text

https://api.juheai.shop/v1/v1/chat/completions   ← 错误

正确填法：

text

https://api.juheai.shop

错误二：密钥带了空格

复制密钥时，如果手动拖选，很容易带上：

前面一个空格
后面一个换行
最后一个字符漏掉

正确做法：用后台的「复制」按钮，粘贴后检查首尾。

按客户端查

Cherry Studio

text

设置 → 模型服务 → 添加
  API 地址: https://api.juheai.shop
  API 密钥: sk-xxxx（复制按钮复制）
  模型: 从模型广场复制的名字

ChatBox

text

设置 → 模型
  API 模式: OpenAI API 兼容
  API 域名: https://api.juheai.shop
  API 路径: /v1/chat/completions（默认，别改）
  API 密钥: sk-xxxx

NextChat

text

设置 → 接口
  接口地址: https://api.juheai.shop
  API Key: sk-xxxx
  自定义模型: 粘贴模型名

Cursor

text

Settings → Models → OpenAI API Key
  Override OpenAI Base URL: https://api.juheai.shop/v1

注意：Cursor 这个字段需要 /v1，因为它不会自动补。这是少数例外。

Claude Code

bash

# macOS / Linux
export ANTHROPIC_BASE_URL=https://api.juheai.shop
export ANTHROPIC_AUTH_TOKEN=sk-xxxx

# Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://api.juheai.shop"
$env:ANTHROPIC_AUTH_TOKEN="sk-xxxx"

改完还是不行

做这三件事：

完全退出客户端（不是关窗口，是退出进程）
重新打开
新建一个对话测试（旧对话可能缓存了错误配置）

还不行的，看对应的报错文档：

报错	看哪篇
超时 / 连不上	「连不上 / 请求超时」
401	「401 认证失败」
余额	「403 余额不足」
模型	「404 模型不存在」
429	「429 请求太频繁」