当前位置：首页 > news >正文

零基础小白用 GitHub 和 OpenCode 写代码入门教程（超详细保姆级）

news 2026/5/7 9:39:41

零基础小白用 GitHub 和 OpenCode 写代码入门教程（超详细保姆级）

你好！即使你完全没有电脑基础（不会用命令行、不会装软件、没碰过代码），也没关系。这个教程像手把手教你做菜一样，从最最基础开始，一步一步教你用 GitHub（存代码的“网盘+版本记录器”）和 OpenCode（一个免费的 AI 编程助手，像聪明机器人帮你写代码）来写代码。

我们目标很简单：

整个过程用中文操作，OpenCode 支持中文对话，你直接用大白话和它聊天就行。
预计总时间：1-2 小时（慢慢来，别着急）。

准备一台电脑和网络
- Windows 10/11、Mac 或 Linux 都行（教程以 Windows 和 Mac 为主，Linux 类似）。
- 保证网络能正常上网（OpenCode 需要连 AI 模型）。
- 推荐用鼠标右键 + “在新窗口打开” 的方式慢慢看教程。
创建 GitHub 账号（超级简单）
- 打开浏览器，输入：https://github.com
- 点击右上角 Sign up（注册）。
- 用邮箱注册（推荐用常用邮箱），设置用户名和密码。
- 验证邮箱（点邮件里的链接）。
- 账号创建好后，记住你的用户名（比如 abc123）。
小贴士：GitHub 就像你的代码“云盘”，以后所有代码都存这里，不会丢。

我们需要两个东西：

Windows：
1. 打开浏览器，输入 https://git-scm.com/download/win
2. 点击下载，下载完双击安装。
3. 一直点“Next” → “Install”（默认选项就行）。
4. 安装完，搜索“Git Bash”打开（这是一个黑窗口，我们以后用它操作）。
Mac：
1. 打开“终端”（搜索 Spotlight 打“终端”）。
2. 复制粘贴下面命令，按回车：
```
xcode-select --install
```
3. 弹窗点“安装”。
验证：打开 Git Bash 或终端，输入 git --version，看到版本号就成功了。

OpenCode 有桌面版 Beta（最适合小白，图形界面）和终端版（功能最全）。我们先装终端版（最稳定）。

最简单安装（所有系统通用）：

Windows 用户备选（如果上面失败）：

搜索安装 “Scoop” 或直接从 https://github.com/anomalyco/opencode/releases 下载最新 .exe 文件，双击运行。

超级简单备选：去 https://opencode.ai/zh/download 下载 桌面应用 Beta 版（图形界面，像普通软件一样点开用），但本教程以终端版为主（功能更强）。

在 Git Bash / 终端里输入：
```
opencode
```
（进入 OpenCode 的聊天界面，黑窗口变漂亮了）。
输入命令 /connect 按回车。
选择 OpenCode Zen（官方免费模型通道）。
浏览器会自动打开 https://opencode.ai/auth
- 登录你的 GitHub 账号（或用邮箱注册）。
- 添加账单信息（免费模型也需要这一步，但真正免费使用不会扣钱）。
- 复制出现的 API Key（一串很长的字符）。
回到 OpenCode 窗口，粘贴 Key，按回车。
输入 /models 查看模型列表。
推荐免费模型（目前上限时免费，够小白用了）：
- opencode/minimax-m2.5-free
- opencode/ling-2.6-flash-free
- opencode/big-pickle（官方默认）
输入 /model opencode/minimax-m2.5-free 选中一个免费模型。

小贴士：以后每次打开 OpenCode 都会自动记住配置。

克隆项目到电脑（下载代码）：
在 Git Bash / 终端里输入下面命令（把 你的用户名 换成你自己的）：
```
git clone https://github.com/你的用户名/my-first-code.git
cd my-first-code
```
启动 OpenCode：
```
opencode
```
初始化项目（让 AI 认识你的文件夹）：
输入 /init 按回车。
写第一个代码（超级简单 Python 程序）
在 OpenCode 聊天框里直接用中文说：
```
帮我创建一个 Python 文件，叫 hello.py，里面写一个程序：打印 “你好，我是零基础小白，这是我的第一个程序！” 然后问用户输入名字，并说 “欢迎你，[名字]！”
```
- OpenCode 会进入 Plan 模式（先规划），按 Tab 键 切换到 Build 模式（真正写代码）。
- 它会自动创建文件、写代码。
- 看完它写的代码后，输入 “确认，帮我保存” 或直接回车，它就会生成文件。
测试代码（验证是否能跑）：
退出 OpenCode（输入 /exit），在终端输入：
```
python hello.py
```
（Windows 可能要用 python3）。看到输出就成功了！

想改代码？重新打开 opencode，直接说：
“把 hello.py 改成计算器，能加减乘除”
AI 就会自动修改！

在终端里依次输入下面 3 条命令（每条按回车）：

git add .
git commit -m "我的第一个 AI 写的程序"
git push

恭喜！你已经成功用 AI 写代码并存到 GitHub 了！

在 GitHub 上直接让 AI 帮忙：
在仓库的 Issue（问题）里发帖，评论 /opencode 帮我写一个计算器，OpenCode 会自动创建分支、改代码、提交 Pull Request（PR）。
命令：在仓库里运行 opencode github install 就能开启这个功能。
常用 OpenCode 命令（记住这几个就够用）：
- /plan → 先规划怎么写
- Tab 键 → 切换 Plan / Build 模式
- /undo → 撤销上一步改动
- /share → 生成分享链接给别人看
- 直接说中文：“解释一下这个文件干什么” 或 “修复 Bug”
推荐下一个小项目：
让 OpenCode 帮你做一个“猜数字游戏”或“TODO 待办事项列表”。