# 🔗 CC Switch 深链接测试

点击下方链接测试深链接导入功能

## Claude Code 供应商

### Claude 基础配置（无模型）

最简单的 Claude 配置，仅包含必需参数（API Key、端点等），不指定任何模型，使用 Claude Code 默认值。

必需 resource=provider, app=claude, name, homepage, endpoint, apiKey
可选 notes
📥 导入基础配置

### Claude 带默认模型

设置通用默认模型（ANTHROPIC_MODEL），适用于只需要一个固定模型的场景。

必需 resource=provider, app=claude, name, homepage, endpoint, apiKey
可选 model=claude-haiku-4.1, notes
📥 导入带默认模型

### Claude 完整配置（四种模型）

设置所有四种模型字段：默认模型、Haiku 模型、Sonnet 模型、Opus 模型。适用于需要精细控制不同模型系列的场景。

必需 resource=provider, app=claude, name, homepage, endpoint, apiKey
可选 model=claude-sonnet-4.5, haikuModel=claude-haiku-4.1, sonnetModel=claude-sonnet-4.5, opusModel=claude-opus-4, notes
📥 导入完整配置

### Claude 部分模型配置

仅设置特定的模型字段（例如只设置 Haiku 和 Sonnet），其他模型使用默认值。演示参数灵活性。

必需 resource=provider, app=claude, name, homepage, endpoint, apiKey
可选 haikuModel=claude-haiku-4.1, sonnetModel=claude-sonnet-4.5, notes
📥 导入部分模型配置

### Claude 第三方供应商示例

使用第三方供应商的 API 端点和自定义模型名称，演示兼容性。

必需 resource=provider, app=claude, name, homepage, endpoint, apiKey
可选 model=custom-claude-v1, notes
📥 导入第三方供应商

## Codex 供应商

### Codex 基础配置

OpenAI 官方 API 基础配置，仅包含必需参数。

必需 resource=provider, app=codex, name, homepage, endpoint, apiKey
可选 notes
📥 导入基础配置

### Codex 带默认模型

OpenAI API 配置，指定默认模型为 gpt-5.1。

必需 resource=provider, app=codex, name, homepage, endpoint, apiKey
可选 model=gpt-5.1, notes
📥 导入 OpenAI Official

### Codex Azure OpenAI

Azure 部署的 OpenAI 服务示例。适合企业用户使用 Azure 云服务。默认模型 gpt-5.1。

必需 resource=provider, app=codex, name, homepage, endpoint, apiKey
可选 model=gpt-5.1, notes
📥 导入 Azure OpenAI

### Codex 第三方兼容 API

使用兼容 OpenAI API 格式的第三方服务（如 Together AI、Groq 等）。

必需 resource=provider, app=codex, name, homepage, endpoint, apiKey
可选 model=mixtral-8x7b, notes
📥 导入第三方 API

## Gemini 供应商

### Gemini 基础配置

Google Gemini 官方 API 基础配置，仅包含必需参数。

必需 resource=provider, app=gemini, name, homepage, endpoint, apiKey
可选 notes
📥 导入基础配置

### Gemini Google Gemini Official

导入 Google Gemini 官方 API 配置。默认模型 gemini-3-pro-preview。

必需 resource=provider, app=gemini, name, homepage, endpoint, apiKey
可选 model=gemini-3-pro-preview, notes
📥 导入 Google Gemini

### Gemini Gemini 测试环境

公司内部 Gemini 测试环境配置示例。用于验证 Gemini 相关深链接导入流程。默认模型 gemini-3-pro-preview。

必需 resource=provider, app=gemini, name, homepage, endpoint, apiKey
可选 model=gemini-3-pro-preview, notes
📥 导入 Gemini 测试环境

### Gemini 第三方兼容服务

使用第三方提供的 Gemini API 兼容服务，支持自定义模型名称。

必需 resource=provider, app=gemini, name, homepage, endpoint, apiKey
可选 model=gemini-custom-v2, notes
📥 导入第三方服务

## 📦 配置文件导入示例 v3.8+

### Claude 完整 JSON 配置导入

通过 Base64 编码的 JSON 配置文件导入完整配置，包含所有四种模型和端点信息。

必需 resource=provider, app=claude, name
可选 config (Base64 JSON), configFormat=json
📥 导入完整配置
// 解码后的配置内容:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-ant-test-key123",
"ANTHROPIC_BASE_URL": "https://api.anthropic.com/v1",
"ANTHROPIC_MODEL": "claude-sonnet-4.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.1",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4"
}
}

### Claude 配置 + URL 参数覆盖

配置文件提供基础设置,URL 参数覆盖 API Key。URL 参数优先级最高。

必需 name, config
覆盖 apiKey (覆盖配置文件中的值)
📥 导入混合配置
// 解码后的配置内容:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.anthropic.com/v1",
"ANTHROPIC_MODEL": "claude-sonnet-4.5"
}
}
// URL 参数覆盖: apiKey=sk-ant-my-new-key
优先级规则: URL 参数 (apiKey) > 配置文件 (endpoint, model)

### Codex TOML 格式配置导入

Codex 使用 TOML 格式的配置文件,包含 auth 和 config 两部分。

必需 name, config
可选 configFormat=json (Codex 配置为 JSON 包装的 TOML)
📥 导入 Codex 配置
// 解码后的配置内容:
{
"auth": {
"OPENAI_API_KEY": "sk-proj-test-key123"
},
"config": "[model_providers.openai]\nbase_url = \"https://api.openai.com/v1\"\n\n[general]\nmodel = \"gpt-5.1\""
}
// config 字段解析 (TOML):
[model_providers.openai]
base_url = "https://api.openai.com/v1"
[general]
model = "gpt-5.1"

### Gemini Gemini 配置导入

Gemini 使用扁平的环境变量格式,简洁明了。

必需 name, config
可选 configFormat=json
📥 导入 Gemini 配置
// 解码后的配置内容:
{
"GEMINI_API_KEY": "AIzaSyDtestkey123",
"GEMINI_BASE_URL": "https://generativelanguage.googleapis.com/v1beta",
"GEMINI_MODEL": "gemini-3-pro-preview"
}

### Claude 自动填充示例

仅提供配置文件和名称,其他信息(API Key、端点、官网)自动从配置文件中提取。

必需 name, config
自动填充 apiKey, endpoint, homepage (从配置文件提取)
📥 测试自动填充
// 解码后的配置内容:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-ant-auto-filled-key",
"ANTHROPIC_BASE_URL": "https://api.anthropic.com/v1"
}
}
✓ API Key: 从配置文件提取
✓ Endpoint: 从配置文件提取
✓ Homepage: 自动推断为 https://anthropic.com
自动填充规则:
• API Key: 从配置文件中提取
• Endpoint: 从配置文件中提取
• Homepage: 根据 Endpoint 自动推断

#### ✨ 配置文件导入新特性 (v3.8+)

- 📄 支持格式: JSON 和 TOML 配置文件
- 🎯 优先级规则: URL 参数 > 配置文件内容 > 远程 URL
- 🔀 智能合并: URL 参数覆盖配置文件,保留非冲突字段
- ✨ 自动填充: 未提供的字段自动从配置文件提取
- 🌐 官网推断: 根据 API 端点自动推断供应商官网

#### ⚠️ 使用注意事项

- 首次点击：浏览器会询问是否允许打开 CC Switch，请点击"允许"或"打开"
- macOS 用户：可能需要在"系统设置" → "隐私与安全性"中允许应用
- 测试 API Key：示例中的 API Key 仅用于测试格式，无法实际使用
- 导入确认：点击链接后会弹出确认对话框，API Key 会被掩码显示（前4位+****）
- 编辑配置：导入后可以在 CC Switch 中随时编辑或删除配置

## 🔍 深链接解析器

粘贴深链接 URL，查看解析结果

深链接 URL
✅ 解析结果：

## 🛠️ 深链接生成器

填写下方表单，生成您自己的深链接

导入模式
URL 参数模式：直接在 URL 中传递参数 | 配置文件模式：使用 Base64 编码的 JSON/TOML
应用类型 *
供应商名称 * ⚠️ 唯一必填项
官网地址
API 端点
API Key
配置文件内容（JSON） 配置文件将自动进行 Base64 编码
Codex 认证信息 (JSON) 包含 API Key 的认证信息 JSON 对象
Codex 配置文件 (TOML) config.toml 的原始内容
URL 参数覆盖（可选）

💡 可以在下方填写 API Key、端点等参数来覆盖配置文件中的值。留空则完全使用配置文件。

默认模型（可选） 通用模型字段，适用于所有应用类型

#### 📋 Claude 专用模型字段（可选）

可以根据需要设置特定的模型字段，这些字段仅在 Claude 应用中生效

Haiku 模型 对应环境变量：ANTHROPIC_DEFAULT_HAIKU_MODEL
Sonnet 模型 对应环境变量：ANTHROPIC_DEFAULT_SONNET_MODEL
Opus 模型 对应环境变量：ANTHROPIC_DEFAULT_OPUS_MODEL
备注（可选）
✅ 生成的深链接：
🧪 测试链接