LowHow 文档

中文

English

中文

English

深色模式

OpenCode 连接智谱 GLM-5 教程：10分钟配置AI编程助手 ​

📚 分类: AI 编程助手配置 ⏱️ 预计耗时: 10 分钟 🎯 难度: 入门 🔧 环境要求: OpenCode 已安装 🌐 原文来源: OpenCode 官方文档

你将学到什么 ​

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

  • [ ] 获取并安全保管智谱 AI 的 API Key（应用程序编程接口密钥，用于验证你的身份）
  • [ ] 在 OpenCode 中成功配置并连接智谱 AI 服务
  • [ ] 选择并使用 GLM-5 模型进行第一次对话
  • [ ] 理解不同套餐的区别，并做出最适合自己的选择

最终效果 ​

你将在 OpenCode 终端中，成功向智谱 GLM-5 模型发送消息，并收到它流畅、智能的中文回复。这意味着你的 AI 编程助手已准备就绪，可以开始工作了。

前置准备 ​

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

检查项说明验证方法
安装 OpenCode确保你的电脑上已成功安装 OpenCode在终端输入 opencode，能正常启动
注册智谱 AI 账号拥有一个可以登录智谱 AI 开放平台的账号访问 智谱 AI 开放平台 并登录

1. 了解核心概念 ​

🤔 什么是 API Key？ API Key 就像一个专属的“密码”或“通行证”。当你使用 OpenCode 这样的工具时，它需要向智谱 AI 的服务器发送请求。API Key 用来证明你的身份，告诉服务器“这是合法用户发起的请求”，并允许你使用相应的服务。

⚠️ 重要安全提示：你的 API Key 关联了你的账户和付费额度，请务必像保管银行卡密码一样保管它。不要将其分享给任何人，也绝对不要将其上传到公开的代码仓库（如 GitHub）。

第 1 步：获取智谱 AI 的 API Key ​

🎯 目标：在你的智谱 AI 账户中，创建并复制一个专属的 API Key。

📝 操作：

  1. 访问智谱 AI 开放平台：点击下面的链接注册或登录。这个链接是专属优惠通道，可以享受额外福利。

  2. 进入 API Key 管理页面：登录后，在控制台页面找到“API 密钥”或类似的选项（通常在个人中心或左侧导航栏）。

  3. 创建新的 API Key：

    • 点击“添加 API Key”或“创建新的密钥”按钮。
    • 为你的 Key 取一个便于识别的名字，例如 “OpenCode”。
    • 点击确认创建。

  4. 复制并安全保存：

    • 系统会弹出一个窗口，显示你新创建的 API Key。这是你唯一一次看到完整 Key 的机会。
    • 立即点击“复制”按钮，并将其粘贴到一个安全的本地文件中（例如一个加密的笔记软件或本地的 .env 文件）。
    • 一个标准的 API Key 格式类似于 xxx.xxx 的字符串。

✅ 验证： 你的本地文件中现在应该保存了一个以 xxx.xxx 格式开头的字符串。请确认它完整无误。

⚠️ 常见错误：

  • 找不到创建入口：不同平台的控制台布局可能略有不同，可以搜索“API 密钥”或参考平台的官方帮助文档。
  • 忘记复制：如果不小心关闭了弹窗，无法再次查看完整 Key。你需要在密钥管理页面删除旧 Key，并重新创建一个新的。

第 2 步：在 OpenCode 中连接智谱 AI ​

🎯 目标：在 OpenCode 的配置界面中，添加你刚才获取的 API Key，建立连接。

📝 操作：

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

    bash
    $ opencode

  2. 进入连接配置模式：在 OpenCode 的交互界面中，输入斜杠命令 /connect 并回车。

    bash
    /connect

  3. 选择提供商：

    • 你会看到一个提供商列表。使用键盘的上下方向键进行浏览。
    • 找到并选择 Zhipu AI Coding Plan（智谱 AI 编程计划）。如果找不到，请先更新 OpenCode 到最新版本。

  4. 粘贴 API Key：

    • 系统会提示你输入 API Key。
    • 将你在第 1 步中复制并保存的 API Key 粘贴到终端中（在大多数终端中，快捷键是 Ctrl+Shift+V 或 Command+V）。
    • 粘贴后，内容可能不会显示在屏幕上（出于安全考虑），这是正常的。直接按回车键确认。

✅ 验证： 如果操作成功，你会看到一条类似“Provider connected successfully!”（提供商连接成功！）的提示信息。这表明 OpenCode 已经成功与智谱 AI 建立了连接。

第 3 步：选择 GLM-5 模型 ​

🎯 目标：从可用的模型列表中，选择你需要的 GLM-5 模型。

📝 操作：

  1. 进入模型选择模式：在 OpenCode 中，输入斜杠命令 /models 并回车。

    bash
    /models

  2. 选择 GLM-5：

    • 你会看到一个模型列表，其中应包含 glm-5 或类似名称的模型。
    • 使用方向键选中它，然后按回车键确认。

✅ 验证： OpenCode 界面会显示当前使用的模型为 glm-5。此时，你的 AI 编程助手已经配置完毕。

第 4 步：发送你的第一条消息（验证成功） ​

🎯 目标：通过一次真实的对话，确认整个配置流程完全正确，AI 可以正常响应。

📝 操作：

  1. 在 OpenCode 的输入框中，输入以下文字并回车：
    text
    你好，请介绍一下你自己。

✅ 验证：

  • ✅ 响应成功：等待几秒钟，你会看到 AI 开始生成回复。回复内容会介绍它是智谱 AI 的 GLM-5 模型，并说明它的能力。
  • ✅ 响应速度：首次响应可能稍慢（几秒钟），之后的对话应该非常流畅。
  • ✅ 语言质量：回复应该是流畅、自然的中文。

💡 提示：如果响应非常慢或超时，可能是网络波动导致的。可以稍后再试，或者检查你的网络连接。

进阶技巧：选择最适合你的套餐 ​

智谱 AI 的 Coding Plan（编程计划）提供不同档位的套餐，以满足不同用户的需求。

套餐名称连续包月价格推荐人群核心优势
Lite49 元/月轻度体验用户价格最低，满足基础对话需求
Pro149 元/月日常开发主力（强烈推荐）性价比最高，支持 GLM-5 旗舰模型，解锁联网搜索、图像理解、开源仓库分析等高级能力，生成速度更快
Max469 元/月重度用户用量充足，适合将 AI 深度整合到所有工作流中的用户

🤔 为什么强烈推荐 Pro 套餐？ 对于绝大多数开发者，Pro 套餐是性价比之王。它不仅包含了 GLM-5 这个“最强大脑”，还解锁了“联网搜索”等实用功能。这意味着你可以让 AI 帮你查询最新的 API 文档、分析 GitHub 上的开源项目，甚至理解你截图的报错信息，极大提升开发效率。

常见问题 (FAQ) ​

Q1: 在 /connect 列表里找不到 Zhipu AI Coding Plan 怎么办？A: 这说明你的 OpenCode 版本太旧，不支持最新的智谱 AI 接口。请更新 OpenCode 到最新版本：

bash
$ opencode upgrade

更新完成后，重新执行第 2 步。

Q2: 粘贴 API Key 后，提示 API key invalid 怎么办？A: 这通常是因为 API Key 格式不正确或复制时遗漏了字符。请检查：

  1. 完整复制：确保你复制了整个 Key，没有缺少开头或结尾的字符。
  2. 格式正确：确认 Key 是类似 xxx.xxx 的格式。
  3. 重新创建：如果确认无误，可以回到智谱 AI 控制台，删除旧 Key 并创建一个新的，重新粘贴。

Q3: 发送消息后，响应非常慢或者直接超时了？A: 这大概率是网络问题。智谱 AI 的服务器在国内，国内用户访问通常很快。请尝试：

  1. 检查你的网络连接是否正常。
  2. 关闭可能干扰网络连接的代理软件（VPN）。
  3. 换一个时间段再试。

总结 ​

恭喜你！你已经成功完成了 OpenCode 与智谱 AI GLM-5 模型的连接。🎉

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

  1. API Key 安全：理解了 API Key 的重要性，并学会了如何安全地获取和保管它。
  2. 配置流程：掌握了 /connect 和 /models 这两个核心命令，能够独立完成 AI 提供商的配置和模型选择。
  3. 模型选择：了解了 GLM-5 模型的优势，以及如何根据自己的需求选择最合适的套餐。

© 2026 LowHow