LowHow 文档

中文

English

中文

English

深色模式

OpenCode 免费模型配置与首次对话实战教程 ​

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

你将学到什么 ​

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

  • [ ] 零成本启动 OpenCode 并完成首次对话
  • [ ] 在多个免费 AI 模型间进行切换
  • [ ] 诊断并解决常见的连接与限额问题
  • [ ] 验证 OpenCode 的安装与网络配置是否成功

最终效果 ​

你将能够在终端中与一个免费的 AI 编程助手进行实时对话，它会回答你的问题。这标志着你的 OpenCode 环境已完全就绪，可以开始日常使用。

前置准备 ​

在开始前，请确认你的环境满足以下条件：

检查项要求验证命令
OpenCode已安装opencode --version
网络连接可访问外网ping 8.8.8.8

1. 安装 OpenCode（如未安装） ​

bash
$ npm install -g @opencode/cli    // 全局安装 OpenCode
$ opencode --version               // 验证安装：应输出版本号

✅ 验证：如果看到类似 v1.2.3 的输出，说明安装成功。

第 1 步：启动 OpenCode ​

🎯 目标：启动 OpenCode 命令行界面，并验证它能否自动加载免费模型。

📝 操作：

在终端中直接输入以下命令并回车：

bash
$ opencode
  • 首次启动时，OpenCode 会自动检测并加载免费模型列表，无需任何手动配置。
  • 你将看到 OpenCode 的命令行交互界面。

✅ 验证： 启动成功后，你会看到终端提示符变为 opencode> 或类似的交互式状态，表明已进入 OpenCode 的对话环境。

💡 提示：如果启动后报错，请优先检查网络连接。OpenCode 首次启动需要从服务器获取模型列表。

第 2 步：查看并选择免费模型 ​

🎯 目标：了解当前可用的免费模型，并选择一个用于对话。

📝 操作：

在 OpenCode 的交互界面中，输入以下斜杠命令并按回车：

bash
/models

系统将返回一个可用模型列表。你需要从中寻找并选择一个免费模型。免费模型通常具备以下特征：

  • 命名规范：包含 -free 后缀，例如 opencode/glm-4.7-free。
  • 价格标签：在列表中显示为 $0 或 免费。

🤔 为什么要这样做？/models 命令是 OpenCode 的“模型市场”，它会实时显示你当前账户有权限使用的所有 AI 模型。免费模型是零成本体验 OpenCode 的最佳起点。

✅ 验证： 你会在列表中看到类似以下名称的条目：

  • opencode/glm-4.7-free (智谱 GLM-4.7)
  • opencode/minimax-m2.1-free (MiniMax M2.1)
  • opencode/gpt-5-nano (GPT-5 Nano)

💡 提示：免费模型的列表会随时间更新，以 /models 命令显示的实时列表为准。

第 3 步：发送你的第一条消息 ​

🎯 目标：与选定的免费模型进行第一次对话，验证整个“安装 → 选模型 → 对话”流程是否通畅。

📝 操作：

  1. 在 /models 列表中找到你心仪的免费模型（例如 opencode/glm-4.7-free），输入其完整名称并按回车。
  2. 系统会提示已切换到该模型。现在，输入你的第一句话：
text
你好，请介绍一下你自己

✅ 验证： 如果一切正常，AI 模型会返回一段自我介绍或问候语，例如：

text
你好！我是由智谱AI开发的GLM-4.7模型，很高兴为你服务。我可以帮你编写、解释、调试代码，也可以回答各种技术问题。

🎉 恭喜！ 当你看到 AI 的回复时，说明你已经成功跑通了 OpenCode 的完整工作流。

⚠️ 常见错误： 如果请求被拒绝，并收到类似 Rate limit exceeded 或 请求过于频繁 的提示，说明你当前的 IP 地址触发了免费模型的使用限额。免费模型通常有 IP 级别的访问频率限制。解决方法是：

  • 更换模型：尝试使用列表中的其他免费模型。
  • 稍后再试：等待一段时间（如 15-30 分钟），让限额重置。

进阶技巧（可选） ​

掌握基础后，你可以尝试：

  1. 切换模型：在对话过程中，随时可以再次输入 /models 并选择另一个模型，来体验不同 AI 的回复风格。
  2. 查看模型详情：在 /models 列表中，某些模型可能支持 info 命令来查看更多参数，例如上下文长度。

常见问题 (FAQ) ​

Q1: 输入 /models 后，列表里看不到任何免费模型，怎么办？A: 这通常由两个原因导致：

  1. 网络问题：你的网络可能无法连接到 OpenCode 的模型服务器。请检查你的网络连接，或尝试更换网络环境。
  2. 版本过旧：你的 OpenCode 版本可能太旧，无法获取最新的模型列表。请运行以下命令更新：
    bash
    $ opencode upgrade

Q2: AI 响应速度非常慢，是正常的吗？A: 是的，这是正常现象。免费模型通常部署在共享服务器上，当同时使用的人数较多时，响应速度会变慢。你可以耐心等待，或者尝试切换到另一个响应更快的免费模型。

Q3: 我收到了 请求被拒绝/报限流 的错误，但只发了一条消息。A: 免费模型的限额是基于 IP 地址的，并且可能非常严格。即使只发了一条消息，也可能因为该 IP 在短时间内被多次请求（例如，你和同事共享同一个公司网络）而触发限制。请尝试：

  1. 更换列表中的另一个免费模型。
  2. 使用手机热点等不同的网络环境。
  3. 等待一段时间（例如 15 分钟）再试。

总结 ​

恭喜你完成了本教程！🎉

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

  1. 零成本启动：通过 opencode 命令直接启动，并自动加载免费模型。
  2. 模型选择：使用 /models 命令查看并切换到 -free 后缀的免费模型。
  3. 首次对话：成功发送消息并收到 AI 回复，验证了流程通畅。
  4. 问题排查：了解了如何解决“看不到免费模型”和“请求限流”等常见问题。

© 2026 LowHow