切换主题
酒馆用户对接指南：Claude
本文介绍如何在酒馆中接入 Claude，并配置 API 连接与推理强度。
准备工作
开始前，请确认已经准备好：
- 可以正常使用的酒馆客户端
- 服务方提供的 API Key
- 代理服务器地址：
https://ai.xxcd.top/v1
注意
API Key 属于敏感信息，请勿发送给他人，也不要在公开截图中展示完整内容。
配置 API 连接
1. 打开 API 连接设置
进入酒馆主页，打开 API 连接设置。
2. 选择 Claude
按照以下方式设置：
| 配置项 | 设置内容 |
|---|---|
| API | 聊天补全 |
| 聊天补全来源 | Claude |
3. 配置反向代理
展开 反向代理，填写以下内容：
| 配置项 | 设置内容 |
|---|---|
| 代理服务器 URL | https://ai.xxcd.top/v1 |
| 代理密码 | 填入服务方提供的 API Key |
填写时请注意：
- URL 末尾需要保留
/v1。 - 代理密码输入框会隐藏内容，这是正常现象。
- 不要在 URL 前后添加空格。
配置效果如下图所示：
4. 选择模型并测试连接
在 Claude 模型 中选择需要使用的模型，然后点击 连接。
连接成功后，可以点击 发送测试消息 验证配置。测试消息能够正常返回，即表示 Claude 已经接入成功。
TIP
可选模型由服务端提供，请以页面中实际显示的模型列表为准。
配置思考强度
API 连接完成后，返回酒馆主页，打开 AI 响应配置。此时左侧会显示 Claude 对应的配置项，在其中找到 推理强度 并按需调整。
一般可以参考以下原则：
- 日常聊天：使用较低或默认强度，响应速度更快。
- 复杂剧情、长文本分析：适当提高推理强度。
- 推理强度越高，通常等待时间越长，消耗的 Token 也可能更多。
如果不确定如何选择，建议先保持默认值；确认连接和回复均正常后，再逐步调整。
开启 Claude 缓存
开启缓存可以复用已发送的系统提示词内容。首先打开酒馆安装目录中的 config.yaml，找到 claude 配置：
yaml
claude:
enableSystemPromptCache: false
cachingAtDepth: -1
extendedTTL: false
enableAdaptiveThinking: false将 enableSystemPromptCache 修改为 true，并将 cachingAtDepth 修改为 0：
yaml
claude:
enableSystemPromptCache: true
cachingAtDepth: 0
extendedTTL: false
enableAdaptiveThinking: false缓存时长由 extendedTTL 控制：
extendedTTL | 缓存时长 |
|---|---|
false | 5 分钟 |
true | 1 小时 |
根据需要选择缓存时长即可。enableAdaptiveThinking 与缓存配置无关，无需为了开启缓存而修改。
修改后必须重启
保存 config.yaml 后，需要重启酒馆才能使配置生效。YAML 对缩进敏感，请保留示例中的层级和空格。
常见问题
无法连接服务器
依次检查：
- 聊天补全来源是否选择了
Claude。 - 代理服务器 URL 是否完整填写为
https://ai.xxcd.top/v1。 - API Key 是否填写在 代理密码 中，且前后没有多余空格。
- 当前网络是否可以访问代理服务器。
连接成功但无法回复
尝试重新选择一个服务端实际支持的 Claude 模型，然后再次发送测试消息。如果问题仍然存在，请检查 API Key 是否有效或额度是否充足。
提示 temperature 和 top_p 不能同时设置
如果请求时出现以下错误：
text
`temperature` and `top_p` cannot both be specified for this model. Please use only one.这是因为部分模型（例如 Claude Opus 4.6）只允许设置 temperature 和 top_p 中的一个参数。
请进入 AI 响应配置，将 top_p 调整为 1.0。酒馆会在请求中省略 top_p 参数，从而避免它与 temperature 同时发送。
版本要求
此处理方式需要酒馆 1.16.0 或更高版本支持。旧版本请先升级酒馆。
相关实现可查看：SillyTavern/SillyTavern#5103。
回复速度较慢
可以适当降低 推理强度。长上下文、复杂提示词和较高的推理强度都会增加等待时间。