【无标题】

七牛云 Claude AI 配置指南

本指南将帮助您完成七牛云账户注册、API Key 获取，以及在 Zed 编辑器中配置 Claude AI 推理服务的全部流程。

???? 前置准备

在开始之前，请确保您已具备：

• 一个有效的电子邮箱
• 已安装的 Zed 编辑器（官网下载）
• 稳定的网络连接

???? 第一步：注册七牛云账户

访问七牛云官方注册页面：

https://s.qiniu.com/Jfeqea

按照页面提示完成邮箱注册并验证。

???? 第二步：获取 API Key

2.1 进入 API 密钥管理页面

访问七牛云 AI 推理 API Key 管理页面：

https://portal.qiniu.com/ai-inference/api-key

2.2 创建 API Key

⚠️ 安全警告

• API Key 仅在生成时显示一次，请立即复制保存
• 不要上传至 GitHub 等公开代码库
• 不要在邮件或聊天中分享
• 如泄露请立即删除并重新生成

⚙️ 第三步：在 Zed 中配置七牛云 AI

3.1 打开 Zed 设置

• 快捷键：Cmd + ,（Mac）或 Ctrl + ,（Windows/Linux）
• 菜单：设置 → 首选项

3.2 配置 AI 供应商

找到 AI 供应商 配置部分，点击 添加供应商，填写以下信息：

3.3 保存配置

点击 保存 按钮，Zed 将自动验证配置有效性。

???? 第四步：启用 Claude Code Agent

1. 打开 Zed 扩展管理器（搜索 Agents）
2. 在 Agents 部分点击 新建
3. 选择刚配置的 七牛云 供应商

✨ 开始使用

配置完成后，您将可以在 Zed 中使用以下功能：

❓ 常见问题

Q1：API Key 泄露了怎么办？

1. 登录七牛云管理后台
2. 进入 API Key 管理页面
3. 删除 已泄露的 Key
4. 重新生成 新的 Key
5. 更新 Zed 配置

Q2：无法连接七牛云 API？

Q3：如何切换模型？

1. 打开 Zed 设置
2. 找到七牛云供应商配置
3. 修改模型选择为：
   • claude-sonnet-4-5（推荐）
   • claude-opus-4-1（更高性能）
4. 保存配置

Q4：可以为多个项目使用同一个 API Key 吗？

可以。但建议：

• ✅ 为不同项目创建独立 Key，便于管理和监控
• ✅ 使用环境变量存储，避免硬编码
• ✅ 定期检查使用配额

???? 最佳实践

安全建议

性能建议

• 选择 claude-sonnet-4-5 获得最佳性能/成本平衡
• 定期查看配额使用情况，避免超额

???? 获取帮助

最后更新：2026-03-16