CCProxy 配置指南
CCProxy 配置指南
在开始本章节之前,请根据安装指南安装好 Chatspeed。
🧩 代理分组
代理分组可以让用户根据使用场景隔离不同的模型访问能力,也可以用于根据场景快速切换 Claude Code。
分组管理
按数字标注的顺序依次点击 Chatspeed 主窗口右上角的下拉菜单,选择“代理”。
进入代理设置页面后,按数字标注顺序点击“代理分组”切换到代理分组管理,然后点击“+”添加分组。
本例以
qwen
分组为例,按图中填写并保存。其中:
- 提示词注入:选择增强。
- 提示词文本:可以输入您需要的提示词增强(下文会提供示例)。
- 工具过滤:输入
WebFetch
和WebSearch
,一行一个。由于我们使用的是外部模型,Claude Code 的内部工具WebFetch
和WebSearch
无法使用,因此需要过滤掉。Chatspeed 内置了WebFetch
和WebSearch
两个工具,你可以将它们通过MCP
添加到Claude Code
,添加 MCP 请参考MCP 代理。 - 温度比例:请根据不同模型的最佳温度来设置。Claude 生成代码时使用的温度是
1.0
,而根据qwen3-code
的官方文档,其最佳温度是0.7
,所以比例应设为0.7
。
Claude Code 提示词增强:我们在提示词提供了一些提示词,您可以参考使用。
分组切换
您可以依据上面的步骤依次添加 kimi 组、gemini 组等。不同分组的模型访问通过 /{group_name}/
前缀即可,具体的访问规则请参考 API 文档。
🔀 代理管理
完成分组管理后,我们现在可以根据需要将不同的代理添加到相应分组中。本例以 Claude Code
使用场景为例,演示如何添加代理模型。
在开始本章节之前,您必须先添加一些模型。具体可以参考快速开始的添加模型章节。
代理设置
按数字标注的顺序依次点击 Chatspeed 主窗口右上角的下拉菜单,选择“代理”。
在代理管理页面依次按数字标注点击代理服务、+。
按下图标注分别填写并保存,其中:
分组:本例以配置 qwen3-code 作为
Claude Code
的备用模型,所以选择 qwen。代理别名:
Claude Code
目前使用claude-sonnet-4-20250514
作为编程的主模型,因此这里填写claude-sonnet-4-20250514
。模型:搜索 qwen,然后将所有 qwen3-coder 或相关的模型选中。
注:图中
Nvidia
的qwen3-235b-a22b
实际上并非代码模型,此处仅作示例。
请按步骤 3 再次添加一个
claude-3-5-haiku-20241022
代理,这个是目前Claude Code
用于生成会话标题的模型。至此,我们已经具备了
Claude Code
代理的基本条件。
截至
2025-09-21
我们发现 Claude Code 有时候会调用claude-opus-4-1-20250805
这个模型,所以建议也按上面步骤添加一个
🔑 密钥管理
代理密钥用于访问代理模型,它独立于 AI 供应商提供的密钥,可以有效保护您的数据安全。您可以配置多个密钥以用于不同的场景。
密钥管理
按数字标注的顺序依次点击 Chatspeed 主窗口右上角的下拉菜单,选择“代理”。
按数字标注,切换到密钥管理,然后点击 "+”,在 密钥名称 中输入
ClaudeCode
,然后点击保存。密钥的名称可以是您喜欢的任意字符串。您可以根据自己的使用场景添加多个密钥。例如,可以为
Claude Code
、Cline
、Roo Code
、Zed
和开发测试(dev
)分别添加密钥。文档中的一些示例密钥(如dev
)通常可以安全地用于测试环境。
✍️ 提示词工程
目前 Qwen Code
每天有 2000 次免费调用额度,Gemini CLI
也有充足的免费额度(经测试 gemini-2.5-pro
每天约有 50 次免费额度,用完后会自动切换为 gemini-2.5-flash
)。因此,在预算有限的情况下,使用它们基本能满足大部分编程场景。当您希望体验Claude Code
且预算有限时,使用各渠道的免费模型组成一个代理池,会是一个非常不错的选择。
但是,免费模型也存在一些限制,包括调用次数限制、频率限制、适配度问题等。调用次数和频率可以通过多账户、多密钥的方式解决。本文主要介绍适配性问题。
可以确定的是,Claude Code
中使用的 Claude
模型是经过专门适配的,其表现非常优秀,特别是工具调用出错的概率很低,工作流运行也十分流畅。
而要将外部未经特别训练的模型用于 Claude Code
,该模型至少需具备良好的工具调用能力和指令遵循能力。在此基础上,我们可以通过提示词增强来优化其在 Claude Code
中的表现。
下面的提示词增强是在 Claude Code
系统提示词的基础上追加的,它试图通过用法示例和引导来让模型更好地执行任务。由于提示词内容较多,您可以从这里参考提示词。
🎛️ 参数调优
从 Claude Code
发送的请求来看,目前主要通过温度参数进行调优,而 top_k
、top_p
等参数则未作设置。各模型的最佳温度建议参考其官方文档。据了解,qwen3-coder
的最佳温度是 0.7,而 kimi-k2
的最佳温度是 0.6。其他模型请参考您所使用的模型的官方文档。