七牛云 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

步骤	操作
1	点击 创建 API Key 按钮
2	输入名称（如：Zed-Claude）用于区分不同用途的密钥
3	点击 确认 完成创建
4	立即复制 并保存到安全的地方 ⚠️

⚠️ 安全警告

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

---

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

3.1 打开 Zed 设置

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

3.2 配置 AI 供应商

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

配置项	值	说明
供应商名称	七牛云	可自定义
API 端点	https://api.qnaigc.com/v1	不可修改
API Key	[粘贴第二步获取的密钥]	完整粘贴
默认模型	claude-sonnet-4-5	推荐，性能最佳

3.3 保存配置

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

---

🤖 第四步：启用 Claude Code Agent

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

---

✨ 开始使用

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

功能	说明
📝	AI 代码补完和生成
💬	代码讨论与问题解答
🔍	代码审查与优化建议
🛠️	重构与调试辅助

---

❓ 常见问题

Q1：API Key 泄露了怎么办？

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

Q2：无法连接七牛云 API？

检查项	操作
网络连接	确保网络通畅
API Key	重新复制，确保无空格
API 端点	确认为 https://api.qnaigc.com/v1
模型名称	确认拼写正确
编辑器	重启 Zed 后重试

Q3：如何切换模型？

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

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

可以。但建议：

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

---

🎓 最佳实践

安全建议

✅ 推荐	❌ 避免
定期检查用量	提交到版本控制
分项目创建 Key	明文存储在代码中
使用环境变量	在公开渠道分享

性能建议

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

---

📞 获取帮助

渠道	链接
官方文档	https://portal.qiniu.com/ai-inference/api-key
技术支持	通过七牛云官网
日志排查	查看 Zed 控制台输出

---

最后更新：2026-03-16