https://kitool.ai/assets/cherry-studio-quickstart-DxTG2fkw.js

1const n=`# Kitool × Cherry Studio 快速开始指南
2
3## 适用场景
4
5这篇文档只解决一件事：把 Cherry Studio 接到 Kitool 中转站，并完成一次可用性验证。
6
7---
8
9## 一句话快速开始
10
11只需要填这 3 项就能用：
12
13- **Base URL**：\`https://kitool.ai\`
14- **API Key**：你在 Kitool 获取的 key
15- **模型 ID**：例如 \`claude-opus-4-6\`
16
17不会填？按下面的步骤一步一步来。
18
19---
20
21## 1. 准备工作
22
23在开始前，请确认：
24
25- 已安装 Cherry Studio
26- 已注册 [Kitool](https://kitool.ai) 账号
27- 已获取 API Key（形如 \`sk-xxxx\`）
28
29### 创建 API 密钥
30
31登录 Kitool 控制台，左边栏进入 **API 密钥** → 点击 **创建密钥**。
32
33- **名称**：可以随便填，比如 \`kitool\`
34- **分组**：根据你要使用的工具选择
35  - 使用 **Codex**（OpenAI 工具）→ 选 \`codex\` 分组
36  - 使用 **Claude Code**（Anthropic 工具）→ 选 Claude 对应分组
37- 其他字段可保持默认
38- 点击创建
39
40![创建密钥](/docs/images/page2_img1.png)
41
42创建完成后，在列表中点击复制按钮拿到完整的 API Key。
43
44![复制 API Key](/docs/images/page3_img1.png)
45
46### 如何确认 API Key 正确
47
48- 能在 Kitool 后台看到该 Key
49- 复制后是完整的一串字符，没有空格或截断
50
51### 常见卡点
52
53- 没有 API Key → 无法使用
54- 复制少一位 → 会报 \`401\`
55- Base URL 写错 → 会报 \`404\` / \`400\`
56
57---
58
59## 2. 打开 Cherry Studio 设置
60
611. 打开 Cherry Studio
622. 点击左下角/右上角 **设置**
63
64![Cherry Studio 设置入口](/docs/images/page4_img1.png)
65
66---
67
68## 3. 添加 Kitool 提供商
69
701. 在模型服务中点击 **+ 添加**
71
72   ![添加提供商入口](/docs/images/page5_img1.png)
73
74   提供商名称可以随便填，例如 \`kitool\`。
75
76   ![填写提供商名称](/docs/images/page5_img2.png)
77
782. 选择提供商类型
79
80   Cherry Studio 支持 **OpenAI** 和 **Anthropic** 两种类型，按你要用的模型系列选择。
81
82   ![选择提供商类型](/docs/images/page6_img1.png)
83
843. 填写 API 密钥和 API 地址（下图以 OpenAI 为例）
85
86   - **API 密钥**：你在 Kitool 创建的 API Key
87   - **API 地址**：\`https://kitool.ai\`
88
89   ![填写 API 密钥和地址](/docs/images/page7_img1.png)
90
91   > **注意**：API Key 要和分组匹配 —— OpenAI 类型只能选 \`codex\` 分组创建的 Key，Anthropic 类型只能选 Claude 分组创建的 Key。
92
934. 添加模型（OpenAI 和 Anthropic 类型要填各自支持的模型 ID）
94
95---
96
97## 支持的模型
98
99### OpenAI 兼容模型
100
101| 模型名 |
102|---|
103| \`gpt-5.4\` |
104| \`gpt-5.2\` |
105| \`gpt-5.3-codex\` |
106
107### Anthropic 兼容模型
108
109| 模型名 |
110|---|
111| \`claude-opus-4-6\` |
112| \`claude-sonnet-4-6\` |
113
114> 模型 ID 必须和 Kitool 支持的**完全一致**，大小写、连字符都不能差。
115
116### 添加模型
117
118![添加模型](/docs/images/page8_img1.png)
119
120添加完成后点击 **检测**，提示成功即可进入下一步。
121
122![检测模型](/docs/images/page9_img1.png)
123
124---
125
126## 4. 开始聊天（验证接入）
127
1281. 新建对话
1292. 选择刚刚添加的模型
130
131   ![选择模型](/docs/images/page10_img1.png)
132
1333. 输入：\`你好\`
134
135### 成功表现
136
137模型正常回复内容即表示接入成功。
138
139![成功对话](/docs/images/page11_img1.png)
140
141如果没有回复或报错，参考下面的排查表。
142
143---
144
145## 5. 报错排查
146
147看到什么报错，就对照下面这一条。
148
149### 503 Service temporarily unavailable
150
151- **含义**：当前模型通道不可用或太拥堵
152- **解决**：重试；或切换到其他模型（推荐）
153
154### 502 Bad gateway
155
156- **含义**：Kitool 连接上游 Claude / GPT 失败
157- **解决**：等 1~2 分钟再试；或切换模型
158
159### AI_RetryError
160
161- **含义**：已自动重试 3 次仍失败（本质通常是 502 / 503）
162- **解决**：同上，切换模型或稍后重试
163
164### 401 / 403
165
166- **含义**：API Key 错误或分组不匹配
167- **解决**：重新复制 Key；确认提供商类型与 Key 分组一致
168
169### 400
170
171- **含义**：模型 ID 或 URL 写错
172- **解决**：检查
173  - API 地址是否为 \`https://kitool.ai\`
174  - 模型 ID 是否在[支持的模型](#支持的模型)列表中
175
176### 一直转圈 / 卡住
177
178- **含义**：网络、流式连接或模型异常
179- **解决**：新开对话；重启 Cherry Studio；切换模型或分组
180
181---
182
183## 6. 一分钟自检
184
18590% 的问题都出在这张表里。
186
187| 项目 | 正确写法 |
188|---|---|
189| Base URL | \`https://kitool.ai\` |

190| API Key | \`sk-xxxx\`（完整、无空格） |
191| 模型 ID | 必须在支持列表中 |
192| 分组与类型 | OpenAI ↔ \`codex\` 分组；Anthropic ↔ Claude 分组 |
193`;export{n as default};