docs: 更新 API 分组说明、客户端推荐及重启终端提醒

- 文档新增 ccmax/cc2api 分组说明：cc2api 推荐优先使用（Claude 系列，无客户端限制），ccmax 仅限 Claude Code
- 推荐 OpenCode、OpenClaw 作为 cc2api 客户端，GPT 模型推荐 v1/responses 端点
- Cherry Studio 兼容性说明更新：支持所有模型，仅 ccmax 分组 Claude 模型不可用
- 所有脚本重启终端提示改为中文
- 三个工具文档页及快速开始页添加重启终端 warning 框

docs/guide/claude-code.md

@@ -19,6 +19,14 @@ $key='你的密钥'; iwr -useb https://gitea.sususu.cf/sususu/xcodecli-shells/ra
 :::
 
 > 请将命令中的 `你的密钥` 替换为你的实际 API 密钥。
+::: warning ⚠️ 配置完成后请重启终端
+脚本会自动配置环境变量（`ANTHROPIC_AUTH_TOKEN` 等），但需要**重启终端**才能生效。
+
+- **macOS / Linux**：重新打开终端，或执行 `source ~/.zshrc`（或 `source ~/.bashrc`）
+- **Windows**：重新打开 PowerShell 窗口
+
+如果不重启，Claude Code 首次启动时可能无法读取 API 密钥。
+:::
 
 ## 手动配置说明
 

docs/guide/codex.md

@@ -19,6 +19,12 @@ $key='你的密钥'; iwr -useb https://gitea.sususu.cf/sususu/xcodecli-shells/ra
 :::
 
 > 请将命令中的 `你的密钥` 替换为你的实际 API 密钥。
+::: warning ⚠️ 配置完成后请重启终端
+脚本会自动配置环境变量，但需要**重启终端**才能生效。
+
+- **macOS / Linux**：重新打开终端，或执行 `source ~/.zshrc`（或 `source ~/.bashrc`）
+- **Windows**：重新打开 PowerShell 窗口
+:::
 
 ## 手动配置说明
 

docs/guide/gemini-cli.md

@@ -19,6 +19,12 @@ $key='你的密钥'; iwr -useb https://gitea.sususu.cf/sususu/xcodecli-shells/ra
 :::
 
 > 请将命令中的 `你的密钥` 替换为你的实际 API 密钥。
+::: warning ⚠️ 配置完成后请重启终端
+脚本会自动配置环境变量，但需要**重启终端**才能生效。
+
+- **macOS / Linux**：重新打开终端，或执行 `source ~/.zshrc`（或 `source ~/.bashrc`）
+- **Windows**：重新打开 PowerShell 窗口
+:::
 
 ## 手动配置说明
 

docs/guide/index.md

@@ -32,6 +32,13 @@ $key='你的密钥'; iwr -useb https://gitea.sususu.cf/sususu/xcodecli-shells/ra
 
 > 💡 **提示**：请将命令中的 `你的密钥` 替换为你的实际 API 密钥。
 
+::: warning ⚠️ 配置完成后请重启终端
+脚本会自动写入环境变量，但需要**重启终端**才能生效。否则工具首次启动时可能无法读取 API 密钥。
+
+- **macOS / Linux**：重新打开终端，或执行 `source ~/.zshrc`（或 `source ~/.bashrc`）
+- **Windows**：重新打开 PowerShell 窗口
+:::
+
 ### 脚本执行流程
 
 1. **环境检测**：检查 Node.js 等必要运行时。如果缺失，脚本会尝试引导安装（如 fnm）。
@@ -56,3 +63,35 @@ $key='你的密钥'; iwr -useb https://gitea.sususu.cf/sususu/xcodecli-shells/ra
 2. `https://api.xcodecli.com` (备用)
 
 所有的工具都会统一配置使用同一个有效的 API 端点。
+
+## API 分组说明
+
+XCodeCLI 提供两个 API 分组，适用于不同的使用场景：
+
+### cc2api — 推荐使用
+
+- **包含模型**：Claude 系列
+- **适用客户端**：无限制，所有支持 OpenAI 兼容 API 的客户端均可使用（包括 Claude Code）
+- **特点**：**所有客户端优先选择此分组**
+
+推荐搭配以下客户端使用：
+
+| 客户端 | 类型 | 说明 |
+| :--- | :--- | :--- |
+| **[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
+
+- **包含模型**：Claude 系列（与 cc2api 相同）
+- **适用客户端**：**只能**用于 Claude Code
+- **何时使用**：Claude Code 使用 cc2api 遇到兼容性问题时再切换
+
+::: danger ⚠️ 注意
+ccmax **只能**用于 Claude Code，请勿用于其他客户端。
+:::