docs: 更新Droid 使用教程

This commit is contained in:
shaw
2025-10-10 17:34:53 +08:00
parent 66fe3cf74a
commit 14e54c0473
2 changed files with 280 additions and 0 deletions

View File

@@ -389,11 +389,20 @@ docker-compose.yml 已包含:
**Claude Code 设置环境变量:**
默认使用标准 Claude 账号池:
```bash
export ANTHROPIC_BASE_URL="http://127.0.0.1:3000/api/" # 根据实际填写你服务器的ip地址或者域名
export ANTHROPIC_AUTH_TOKEN="后台创建的API密钥"
```
如果后台添加了 Droid 类型账号池,请将基础地址改为:
```bash
export ANTHROPIC_BASE_URL="http://127.0.0.1:3000/droid/claude" # 根据实际情况替换域名/IP
export ANTHROPIC_AUTH_TOKEN="后台创建的API密钥"
```
**VSCode Claude 插件配置:**
如果使用 VSCode 的 Claude 插件,需要在 `~/.claude/config.json` 文件中配置:
@@ -445,6 +454,8 @@ requires_openai_auth = true
env_key = "CRS_OAI_KEY"
```
如需通过 Droid 类型账号池访问 Codex CLI只需将 `base_url` 改为 `http://127.0.0.1:3000/droid/openai`(其余配置保持不变)。
在 `~/.codex/auth.json` 文件中配置API密钥为 null
```json
@@ -461,6 +472,35 @@ export CRS_OAI_KEY="后台创建的API密钥"
> ⚠️ 在通过 Nginx 反向代理 CRS 服务并使用 Codex CLI 时,需要在 http 块中添加 underscores_in_headers on;。因为 Nginx 默认会移除带下划线的请求头(如 session_id一旦该头被丢弃多账号环境下的粘性会话功能将失效。
**Droid CLI 配置:**
Droid CLI 读取 `~/.factory/config.json`。可以在该文件中添加自定义模型以指向本服务的新端点:
```json
{
"custom_models": [
{
"model_display_name": "Sonnet 4.5 [Custom]",
"model": "claude-sonnet-4-5-20250929",
"base_url": "http://127.0.0.1:3000/droid/claude",
"api_key": "后台创建的API密钥",
"provider": "anthropic",
"max_tokens": 8192
},
{
"model_display_name": "GPT5-Codex [Custom]",
"model": "gpt-5-codex",
"base_url": "http://127.0.0.1:3000/droid/openai",
"api_key": "后台创建的API密钥",
"provider": "openai",
"max_tokens": 16384
}
]
}
```
> 💡 将示例中的 `http://127.0.0.1:3000` 替换为你的服务域名或公网地址,并写入后台生成的 API 密钥cr_ 开头)。
### 5. 第三方工具API接入
本服务支持多种API端点格式方便接入不同的第三方工具如Cherry Studio等
@@ -515,6 +555,23 @@ gpt-5 # Codex使用固定模型ID
- API地址填入`http://你的服务器:3000/openai`
- API Key填入后台创建的API密钥cr_开头
- **重要**Codex只支持Openai-Response标准
- 💡 如果希望在 Cherry Studio 中使用 Droid 类型账号,请改填 `http://你的服务器:3000/droid/openai`,并保持其他设置不变。
**4. Droid账号接入**
```
# Claude Code / Droid CLI 使用的 API 地址
http://你的服务器:3000/droid/claude
# Codex CLI 使用的 API 地址
http://你的服务器:3000/droid/openai
```
配置步骤:
- 供应商类型选择"Anthropic"或"Openai-Response"(根据模型类型)
- API地址填入`http://你的服务器:3000/droid/claude` 或 `http://你的服务器:3000/droid/openai`
- API Key填入后台创建的API密钥cr_开头
- 建议自定义模型名称以区分 Droid 账号池
**Cherry Studio 地址格式重要说明:**
@@ -530,8 +587,10 @@ gpt-5 # Codex使用固定模型ID
- 所有账号类型都使用相同的API密钥在后台统一创建
- 根据不同的路由前缀自动识别账号类型
- `/claude/` - 使用Claude账号池
- `/droid/claude/` - 使用Droid类型Claude账号池服务于 Claude Code / Droid CLI
- `/gemini/` - 使用Gemini账号池
- `/openai/` - 使用Codex账号只支持Openai-Response格式
- `/droid/openai/` - 使用Droid类型OpenAI兼容账号池服务于 Codex CLI
- 支持所有标准API端点messages、models等
**重要说明:**