LowHow 文档

中文

English

中文

English

深色模式

OpenCode 入门实战教程：从零安装到首次 AI 对话 ​

📚 分类: AI 开发工具 ⏱️ 预计耗时: 10 分钟 🎯 难度: 入门 🔧 环境要求: 一台能联网的电脑 (Windows / macOS / Linux)

你将学到什么 ​

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

  • [ ] 理解 OpenCode 是什么以及它能帮你做什么
  • [ ] 在你的电脑上成功安装 OpenCode
  • [ ] 配置并连接一个免费的 AI 模型
  • [ ] 发起你的第一次 AI 编程对话

最终效果 ​

你将打开一个终端窗口，输入一条简单的自然语言指令（例如：“帮我创建一个 ‘Hello World’ 的 Python 文件”），然后 OpenCode 会理解你的指令，自动生成代码并保存到文件。

前置准备 ​

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

检查项要求版本验证命令
操作系统Windows 10+, macOS 11+, 或 Linux-
终端任意终端 (cmd, PowerShell, Terminal)-
网络能够正常访问国内网络-

💡 提示：你不需要安装任何编程语言或框架。OpenCode 是一个独立的终端工具，安装后即可使用。

第 1 步：认识你的新伙伴——OpenCode 是什么？ ​

🎯 目标：用 1 分钟了解 OpenCode 的核心能力以及它与其他工具的区别。

📝 操作：阅读以下核心概念。

OpenCode 是一个运行在终端里的 AI 编程助手。它不像网页聊天机器人那样只能和你“聊天”，而是可以直接读取你的项目文件、执行你给的命令，像一个真正的编程伙伴一样和你并肩工作。

它主要能帮你做三件事：

  1. 写代码 & 改 Bug：告诉它你想要的功能，它能生成代码，甚至帮你修复报错。
  2. 自动化办公：让它帮你批量重命名文件、整理文件夹、处理 Excel 数据。
  3. 完成日常任务：从写一封邮件草稿到翻译一篇文档，它都能胜任。

🤔 它和“代码补全工具”或“ChatGPT”有什么不同？

  • VS 代码补全工具 (如 GitHub Copilot)：代码补全工具擅长“下一行猜你想写什么”，但 OpenCode 能理解整个项目，帮你完成“写一个用户登录功能”这样的复杂任务。
  • VS 聊天机器人 (如 ChatGPT)：聊天机器人只能“说”，而 OpenCode 能“做”。它可以直接在你的电脑上创建文件、运行命令，是行动的巨人。

✅ 验证：现在你已经理解了 OpenCode 的价值。接下来，我们把它装进你的电脑里。

第 2 步：5 分钟快速安装 ​

🎯 目标：在你的电脑上成功安装 OpenCode。

📝 操作：

打开你的终端（Windows 用户请打开 PowerShell 或 cmd，Mac/Linux 用户打开 Terminal），复制并粘贴以下命令，然后按回车键执行：

bash
# 💡 这是官方推荐的快速安装命令，适用于所有平台
$ curl -fsSL https://www.opencodechina.com/install.sh | sh

⚠️ 常见错误：

  • Windows 用户：如果提示 curl 不是内部或外部命令，请改用以下命令：
    powershell
    # 在 PowerShell 中执行
$ irm https://www.opencodechina.com/install.ps1 | iex
  • 权限错误 (Mac/Linux)：如果遇到 Permission denied，请在命令前加上 sudo：
    bash
    $ sudo curl -fsSL https://www.opencodechina.com/install.sh | sh

✅ 验证： 安装完成后，关闭并重新打开你的终端。然后输入以下命令：

bash
$ opencode --version

如果看到类似 opencode 0.x.x 的输出版本号，说明安装成功！🎉

第 3 步：连接你的第一个免费 AI 模型 ​

🎯 目标：配置 OpenCode 使其能够连接一个免费的 AI 模型，开启对话能力。

📝 操作：

  1. 启动配置向导：在终端中输入以下命令，OpenCode 会启动一个交互式配置流程。

    bash
    $ opencode init

  2. 选择模型提供商：你会看到一系列模型列表。OpenCode 原生支持国内模型，无需翻墙。我们选择对新手最友好的免费模型。

    • 在选项中，找到并选择 [推荐] 智谱 GLM-4.7 或 DeepSeek。
    • 使用键盘的 上下箭头 移动光标，按 回车键 确认。

  3. 获取并填入 API Key：

    • 选择模型后，终端会提示你输入一个 API Key。这是你调用 AI 模型的“通行证”。
    • 获取 Key：
    • 填入 Key：在终端提示输入 API Key 的地方，复制粘贴你刚刚创建的 key，然后按回车键。

💡 提示：Key 是一串很长的字符，类似 sk-xxxxxxxxxxxxxxxxxxxx。复制粘贴时注意不要有多余的空格。

✅ 验证： 配置完成后，OpenCode 会尝试连接模型。如果看到类似 ✅ 连接成功 或 模型已就绪 的提示，恭喜你，准备工作全部完成了！

第 4 步：开启你的第一次 AI 对话 ​

🎯 目标：与 OpenCode 进行第一次对话，让它帮你完成一个简单的任务。

📝 操作：

  1. 进入对话模式：在终端中直接输入 opencode 并按回车键。

    bash
    $ opencode

    你会看到一个以 > 开头的输入提示符，这表示你已经进入了与 AI 的对话界面。

  2. 下达你的第一个指令：输入以下文字，然后按回车键。

    > 请在桌面上创建一个名为 hello.py 的文件，内容是一个打印 "Hello, OpenCode!" 的 Python 程序。

  3. 观察 AI 行动：你会看到 OpenCode 开始“思考”，然后自动执行一系列操作，最终会提示它已经完成了任务。

✅ 验证：

  • 在你的电脑桌面上，你应该能看到一个新文件 hello.py。

  • 用记事本或代码编辑器打开它，内容应该如下：

    python
    # 这是 AI 为我们生成的代码
print("Hello, OpenCode!")

  • 如果你安装了 Python，可以在终端中运行它来验证：

    bash
    $ python ~/Desktop/hello.py
# 预期输出：
Hello, OpenCode!

💡 提示：如果你没有安装 Python，也没关系。你可以让 AI 做其他事情，比如“帮我在桌面上创建一个名为 日记 的文件夹”。

进阶技巧（可选） ​

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

  1. 多轮对话：在第一次对话后，你可以继续输入新的指令，AI 会记住之前的上下文。例如：“现在修改这个文件，让它打印10次。”
  2. 使用斜杠命令：在对话中输入 /help，可以查看所有内置命令，例如 /clear 清空对话历史。

常见问题 (FAQ) ​

Q1: 安装时报错 command not found: curl 怎么办？A: 你的系统缺少 curl 命令。请根据你的系统搜索“如何安装 curl”，或者使用本教程中提供的 Windows PowerShell 备用安装命令。

Q2: 配置模型时，API Key 是什么？从哪里获取？A: API Key 是 AI 模型提供商（如智谱、DeepSeek）用来识别和计费用户的唯一密钥。你需要先去它们的官网注册账户，然后在后台创建一个 Key。这个过程完全免费，通常注册就会赠送免费额度。

Q3: 运行 opencode 后没有反应，或者报错 Connection failed？A: 这通常是网络问题或 API Key 错误。请检查：

  1. 你的电脑是否能正常上网。
  2. 在配置时是否正确粘贴了 API Key（注意不要有多余的空格或换行）。
  3. 如果是公司网络，可能需要配置网络代理。请参考 OpenCode 官方文档的“网络配置”部分。

总结 ​

恭喜你完成了本教程！🎉

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

  1. 了解 OpenCode：它是一个能直接操作你电脑文件的 AI 编程助手，比聊天机器人更强大。
  2. 快速安装：通过一条简单的命令，5 分钟内完成了安装。
  3. 连接模型：配置并成功连接了一个免费的国内 AI 模型。
  4. 第一次对话：用自然语言指挥 AI 创建了一个 Python 文件。

你已经从一个观望者变成了 OpenCode 的实践者。现在，大胆地去尝试吧！

© 2026 LowHow