Private
Public Access
1
0

docs: 更新 API 分组说明、客户端推荐及重启终端提醒
All checks were successful
Deploy to Cloudflare Pages / deploy (push) Successful in 1m4s

- 文档新增 ccmax/cc2api 分组说明:cc2api 推荐优先使用(Claude 系列,无客户端限制),ccmax 仅限 Claude Code
- 推荐 OpenCode、OpenClaw 作为 cc2api 客户端,GPT 模型推荐 v1/responses 端点
- Cherry Studio 兼容性说明更新:支持所有模型,仅 ccmax 分组 Claude 模型不可用
- 所有脚本重启终端提示改为中文
- 三个工具文档页及快速开始页添加重启终端 warning 框
This commit is contained in:
2026-02-25 17:13:22 +08:00
parent a443b11326
commit 7c4d947400
17 changed files with 283 additions and 543 deletions

View File

@@ -69,7 +69,7 @@ function copyCommand() {
</div>
</div>
<p class="tip">💡 提示:运行前请将命令中的 <code>你的密钥</code> 替换为实际 API Key</p>
<p class="tip">💡 提示:运行前请将命令中的 <code>你的密钥</code> 替换为实际 API Key。<strong>配置完成后请重启终端</strong>,否则工具可能无法读取 API 密钥。</p>
</div>
@@ -79,13 +79,9 @@ function copyCommand() {
<p class="desc">在 Cherry Studio 中使用 XCodeCLI 服务,享受可视化的对话体验。</p>
::: danger ⚠️ 重要提示:模型兼容性
**Cherry Studio 支持 Gemini 系列模型!**
-**Claude 模型**:暂不支持在 Cherry Studio 中使用(请在 Claude Code 内使用)
-**GPT 模型**:暂不支持在 Cherry Studio 中使用(请在 Codex 内使用)
-**Gemini 模型**:完美支持
:::
::: tip 💡 Cherry Studio 模型兼容性
Cherry Studio 支持所有模型,但注意 **ccmax 分组的 Claude 模型不可用**ccmax 只能用于 Claude Code。Claude 模型请使用 **cc2api** 分组。
:::
### 配置参数
@@ -105,6 +101,37 @@ function copyCommand() {
<div class="setup-section">
## 2.5 API 分组说明
<p class="desc">XCodeCLI 提供多个 API 分组,适用于不同的使用场景。</p>
::: warning 🔑 分组区别
- **cc2api 分组(推荐)**:提供 Claude 系列模型,无客户端限制,可自由搭配各种客户端
- **ccmax 分组**:提供 Claude 系列模型,但**只能用于 Claude Code**
:::
### cc2api — 推荐使用
cc2api 分组包含 **Claude 系列模型**,无客户端限制。推荐搭配以下工具:
| 客户端 | 类型 | 说明 |
| :--- | :--- | :--- |
| **[OpenCode](https://opencode.ai/)** | 终端 AI 编码代理 | 开源,支持 75+ LLM 供应商,可作为 Claude Code 的替代方案。支持终端、桌面端和 IDE 插件 |
| **[OpenClaw](https://openclaw.ai/)** | 个人 AI 助手 | 开源,连接 WhatsApp / Telegram / Slack 等消息平台,支持浏览器自动化、邮件、日历等操作 |
| **[Cherry Studio](https://www.cherry-ai.com/)** | 可视化对话客户端 | 支持多服务商集成,详见 [配置教程](/cherry-studio-nanobana) |
::: tip 💡 GPT 系列模型
GPT 系列模型推荐使用 `v1/responses` 端点以获得最佳效果。
:::
### ccmax — 仅限 Claude Code
ccmax 分组同样提供 Claude 系列模型,但**只能**用于 Claude Code不支持其他客户端。如果你使用 Claude Code 且 cc2api 遇到兼容性问题,可尝试切换到 ccmax。
</div>
<div class="setup-section">
## 3. 参考信息
### CLI 配置文件位置