OpenCode 连接 DeepSeek AI 编程助手实战教程

📚 分类: AI 编程工具配置 ⏱️ 预计耗时: 10 分钟 🎯 难度: 入门 🔧 环境要求: 已安装 OpenCode 命令行工具，网络可访问 platform.deepseek.com

---

你将学到什么

完成本教程后，你将能够：

• [ ] 注册并获取 DeepSeek 的 API Key
• [ ] 在 OpenCode 中配置并连接 DeepSeek 模型
• [ ] 发送第一条消息并成功收到 AI 回复
• [ ] 理解 API Key 的作用和安全性规范

最终效果

你将能够在 OpenCode 的终端界面中，像与一个智能助手对话一样，向 DeepSeek 发送指令并立即得到代码、解释或其他文本回复，为后续的 AI 辅助编程打下基础。

---

前置准备

在开始前，请确认你已经完成了以下准备工作：

1. 安装 OpenCode：请确保你已经按照 1.2 安装教程 完成了 OpenCode 的安装，并且在终端中运行 opencode 命令可以正常启动程序。
2. 网络访问：你的电脑需要能够访问 https://platform.deepseek.com 这个网站。

1. 理解 API Key

🤔 什么是 API Key？ API Key 就像一把“钥匙”，它允许 OpenCode 这个程序代表你与 DeepSeek 的服务器进行通信。没有它，OpenCode 就无法调用 DeepSeek 的强大模型来帮你编程。请务必像保管密码一样保管好你的 API Key。

---

第 1 步：注册 DeepSeek 账号并获取 API Key

🎯 目标：在 DeepSeek 官网上创建一个账户，并生成一个专属于你的 API Key。

📝 操作：

1. 访问 DeepSeek 官网： 打开你的浏览器，访问 DeepSeek 的开放平台地址： https://platform.deepseek.com

2. 登录/注册： 点击页面右上角的 “登录/注册” 按钮，按照页面提示，使用你的手机号或邮箱完成注册并登录。

3. 进入 API Keys 管理页面： 登录成功后，在左侧菜单栏中找到并点击 “API Keys”。你也可以直接访问这个链接： https://platform.deepseek.com/api_keys

4. 创建新的 API Key： 点击 “创建 API Key” 或类似的按钮。

5. 复制并保存 Key： 系统会生成一串以 sk- 开头的密钥。⚠️ 立刻复制并保存到安全的地方！ （例如密码管理器或加密的备忘录）。这个 Key 只会完整显示一次，关闭弹窗后就再也看不到了。

   ✅ 验证：你的记事本或密码管理器中应该存有一串类似 sk-xxxxxxxxxxxxxxxx 的文本。

⚠️ 安全警告：

• ❌ 不要 将 API Key 发送到任何聊天群、社交媒体。
• ❌ 不要 将 API Key 截图分享。
• ❌ 不要 将 API Key 提交到 GitHub 等公开代码仓库。
• ✅ 建议使用密码管理器（如 1Password, Bitwarden）来保存。

💡 提示（可选但推荐）： DeepSeek 为新用户提供了一些免费额度，但可能很快用完。为了获得完整体验，建议在控制台中进行少量充值（例如 10 元人民币），这足以支持长时间的使用。

---

第 2 步：在 OpenCode 中连接 DeepSeek

🎯 目标：将你刚才获取的 API Key 配置到 OpenCode 中，让其能够调用 DeepSeek 的模型。

📝 操作：

1. 启动 OpenCode： 打开你的终端，输入以下命令并回车：

   $ opencode

   OpenCode 的交互界面会启动。

2. 输入连接命令： 在 OpenCode 的输入框中，输入以下命令并回车：

   /connect

3. 选择模型提供商： 屏幕会显示一个提供商列表。使用键盘的上下方向键，选择 DeepSeek，然后按回车键确认。

4. 粘贴 API Key： 系统会提示你输入 API Key。将你在第 1 步中保存的 Key 粘贴到输入框中，然后按回车。 （提示：在终端中，通常使用 Ctrl + Shift + V 或右键点击进行粘贴）

✅ 验证： 配置成功后，OpenCode 会自动进入模型选择界面。你应该能看到一个包含 DeepSeek 可用模型的列表，例如：

• deepseek-chat
• deepseek-reasoner

选择任意一个模型，你就完成了连接！现在可以开始对话了。

💡 环境变量自动检测（快捷方式） 如果你已经在系统的环境变量中设置了 DEEPSEEK_API_KEY，那么 OpenCode 启动时会自动识别并配置好 DeepSeek。你无需执行 /connect 命令，直接输入 /models 就可以看到模型列表并选择。这是一个更省事的方法。

---

第 3 步：发送第一条消息（验证成功）

🎯 目标：向 DeepSeek 发送一条消息，确认连接成功并能正常接收回复。

📝 操作：

1. 在 OpenCode 的输入框中，输入以下内容：

   你好，请简单介绍一下你自己。

2. 按回车键发送。

✅ 验证： 如果一切顺利，DeepSeek 模型会开始思考，并在几秒钟后返回一段回复，例如介绍自己是由 DeepSeek 公司开发的 AI 助手。只要能看到回复，就说明连接成功！

🤔 为什么要先发“你好”？ 这是一个经典的“冒烟测试”。它用最简单的方式验证了整个链路（你的电脑 -> OpenCode -> DeepSeek 服务器 -> 返回结果）是否通畅，确保后续复杂的编程任务能够正常执行。

---

常见问题与排错

在配置过程中，你可能会遇到以下问题：

错误现象	可能原因	解决方案
API key invalid	你复制的 API Key 不正确、有多余空格或已过期。	1. 重新从你的密码管理器复制粘贴。 2. 确保粘贴时没有开头或结尾的空格。 3. 登录 DeepSeek 官网，检查 API Key 是否已失效，如有必要，重新生成一个。
insufficient balance	你的 DeepSeek 账户余额不足。	登录 DeepSeek 控制台，为你的账户充值（例如 10 元）。
connection timeout	网络连接不稳定或无法访问 DeepSeek 服务器。	1. 稍等片刻后重试。 2. 检查你的网络连接是否正常。 3. 如果你使用了代理或 VPN，尝试切换或关闭它们。

---

总结

恭喜你完成了本教程！🎉

回顾一下我们今天学到的核心内容：

1. 获取 API Key：在 DeepSeek 官网注册并安全地创建了你的专属 API Key。
2. 配置 OpenCode：使用 /connect 命令或环境变量，将 API Key 配置到 OpenCode 中。
3. 完成首次对话：向 DeepSeek 发送了第一条消息并成功收到了回复，验证了整个流程。

现在，你已经成功将强大的 DeepSeek AI 模型接入到你的编程工具链中，可以开始探索 AI 辅助编程的奇妙世界了！

---

下一步学习建议

• 📖 熟悉界面操作：学习 OpenCode 的基本界面和常用快捷键，请参考 2.1 界面与基础操作。
• 📖 尝试实战场景：从一个简单的编程任务开始，例如“用 Python 写一个读取 CSV 文件的脚本”，让 AI 帮你完成。
• 📖 了解其他模型：在 /connect 中，你也可以探索其他模型提供商，如 OpenAI、Claude 等。

💡 练习任务：尝试向 DeepSeek 提问：“请帮我写一个函数，用于计算斐波那契数列的第 N 项。” 观察它给出的代码和解释。

---