工欲善其事，必先利其器。学习 AI 工程协作最忌讳在脆弱的环境上进行复杂的思考。只有当你的版本控制、AI 工作台和远端同步设施处于 100% 确定就绪的状态，知识与代码的迭代才不会中途沉没。
花 20-30 分钟把基础设施搭扎实，后续在遇到代码异常时，你能立即排除工具层面的偶发故障，专注于业务逻辑与架构推导。
安装 Git：版本管理基石
Git 是分布式版本控制系统。它记录每一次文件演进，让你随时回退、分支实验，并安全推送到远程仓库。
安装与验证基线
Git 是所有软件工程的存档点系统。在你的操作系统终端中运行版本检查命令，确认系统已正确识别 Git CLI：
git --version
如果控制台输出了类似 git version 2.x.x 的版本信息，即代表安装成功。
配置 OpenCode：项目级 AI 工作台
OpenCode 是开源 AI 编码智能体，运行在终端与项目上下文中，是实现全自主多 Agent 协作的核心宿主。
准备 AI 智能体终端
OpenCode 能够直接读取你的项目代码库、理解上下文，并依据多 Agent 编排指令执行自动化编写与质检：
opencode
终端成功启动交互提示符并正常响应对话，即表明 AI 运行时已正常接入。
访问 OpenCode 官网获取安装指引 ↗注册 Gitee：持久化知识资产库
必须建立专属的私有远程仓库，统一同步保存学习笔记、演练代码、修复证据与阶段验收复盘报告。
创建专属私有学习仓库
建议使用英文小写命名（如 ai-engineering-practice），默认设为「私有」以保护个人隐私和实验数据。
规范化目录层级
将仓库内容划分为清晰目录：docs/（需求与方案）、src/（核心代码）、notes/（学习复盘与反思）。
完成首次远程推送验证
在本地执行 git push -u origin main，确认在 Gitee 网页端能完整查看文件，确保网络与凭据完全打通。
环境与网络基线校验
确保与各大代码托管平台和 AI 模型 API 接口的畅通稳定连接，严格遵循合规与数据安全底线。
在连接第三方大模型 API 与远程 Git 仓库时，绝对不要在公共脚本中明文硬编码任何 API 密钥或凭证；在企业或校园网络环境中，务必遵循网络安全治理与合规准则。
恭喜你，现在底层代码版本控制、AI 工作台与远程备份网络已全部就绪。如果你想彻底告别在浏览器网页点来点去，推荐进一步掌握终端神兵 GitHub CLI (gh)。
阅读 GitHub CLI 实战指南 →