docs: update Cherry Studio integration guide

Update Claude Sonnet model ID to claude-sonnet-4-5-20250929 (v4.5) and
fix API endpoint formats for Cherry Studio compatibility. Remove
trailing slashes from all endpoint URLs to allow Cherry Studio to
automatically append v1 version parameter.

Add important notes about Cherry Studio URL format requirements,
explaining that URLs without trailing slashes and URLs with /v1/
suffix are equivalent, while URLs with single trailing slash will
ignore the v1 version.

Changes:
- Update Claude Sonnet model from claude-sonnet-4-20250514 to
  claude-sonnet-4-5-20250929
- Fix Claude endpoint: /claude/ → /claude
- Fix Gemini endpoint: /gemini/ → /gemini
- Fix Codex endpoint: /openai/ → /openai
- Add URL format explanation and best practices section

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
rxchi1d
2025-10-04 15:22:00 +08:00
parent 1fdfce1e4f
commit 4d380e03f1

View File

@@ -473,23 +473,23 @@ Cherry Studio支持多种AI服务的接入下面是不同账号类型的详
``` ```
# API地址 # API地址
http://你的服务器:3000/claude/ http://你的服务器:3000/claude
# 模型ID示例 # 模型ID示例
claude-sonnet-4-20250514 # Claude Sonnet 4 claude-sonnet-4-5-20250929 # Claude Sonnet 4.5
claude-opus-4-20250514 # Claude Opus 4 claude-opus-4-20250514 # Claude Opus 4
``` ```
配置步骤: 配置步骤:
- 供应商类型选择"Anthropic" - 供应商类型选择"Anthropic"
- API地址填入`http://你的服务器:3000/claude/` - API地址填入`http://你的服务器:3000/claude`
- API Key填入后台创建的API密钥cr_开头 - API Key填入后台创建的API密钥cr_开头
**2. Gemini账号接入** **2. Gemini账号接入**
``` ```
# API地址 # API地址
http://你的服务器:3000/gemini/ http://你的服务器:3000/gemini
# 模型ID示例 # 模型ID示例
gemini-2.5-pro # Gemini 2.5 Pro gemini-2.5-pro # Gemini 2.5 Pro
@@ -497,14 +497,14 @@ gemini-2.5-pro # Gemini 2.5 Pro
配置步骤: 配置步骤:
- 供应商类型选择"Gemini" - 供应商类型选择"Gemini"
- API地址填入`http://你的服务器:3000/gemini/` - API地址填入`http://你的服务器:3000/gemini`
- API Key填入后台创建的API密钥cr_开头 - API Key填入后台创建的API密钥cr_开头
**3. Codex接入** **3. Codex接入**
``` ```
# API地址 # API地址
http://你的服务器:3000/openai/ http://你的服务器:3000/openai
# 模型ID固定 # 模型ID固定
gpt-5 # Codex使用固定模型ID gpt-5 # Codex使用固定模型ID
@@ -512,10 +512,17 @@ gpt-5 # Codex使用固定模型ID
配置步骤: 配置步骤:
- 供应商类型选择"Openai-Response" - 供应商类型选择"Openai-Response"
- API地址填入`http://你的服务器:3000/openai/` - API地址填入`http://你的服务器:3000/openai`
- API Key填入后台创建的API密钥cr_开头 - API Key填入后台创建的API密钥cr_开头
- **重要**Codex只支持Openai-Response标准 - **重要**Codex只支持Openai-Response标准
**Cherry Studio 地址格式重要说明:**
- ✅ **推荐格式**`http://你的服务器:3000/claude`(不加结尾 `/`,让 Cherry Studio 自动加上 v1
- ✅ **等效格式**`http://你的服务器:3000/claude/v1/`(手动指定 v1 并加结尾 `/`
- 💡 **说明**:这两种格式在 Cherry Studio 中是完全等效的
- ❌ **错误格式**`http://你的服务器:3000/claude/`(单独的 `/` 结尾会被 Cherry Studio 忽略 v1 版本)
#### 其他第三方工具接入 #### 其他第三方工具接入
**接入要点:** **接入要点:**