第3章:环境搭建 — 从零构建你的 AI 编程工作台
适合读者: AI初学者, 效率追求者, 后端开发者(BACKEND)
本章是实践起点,手把手带你完成 OpenCode 开发环境的安装、配置和集成。
章节概述
第 3 章解决“怎么装、怎么配、怎么用“的问题。我们从零开始:安装 OpenCode 和 oh-my-openagent、配置基础参数、连接模型供应商。然后深入 OpenCode 的配置体系,讲解主配置文件的每个关键字段。接着完成 oh-my-openagent 的集成,解锁多 Agent(智能体) 编排能力。针对国内开发者,我们单独讨论国产模型供应商的配置方案。最后,给出在多环境(本地开发、CI/CD、远程服务器)下的部署最佳实践。
本章包含以下文章(建议按顺序阅读):
价值声明
| 维度 | 内容 |
|---|---|
| 目标读者 | 准备安装和配置 OpenCode 的开发者,特别是使用国产大模型(DeepSeek、Qwen、Kimi)的国内团队。 |
| 前驱知识 | 完成第 1、2 章阅读,具备基本的命令行操作能力和 JSON 配置文件编辑经验。 |
| 读完能做什么 | 能在 30 分钟内完成 OpenCode 全套环境搭建,配置国产模型供应商接入,实现多环境(本地/CI/CD/远程)的配置分离与部署。 |
| 业务指标关联 | 环境搭建耗时从平均 2 天缩短到 30 分钟,团队成员配置一致性从 60% 提升到 95% 以上。 |
| 文章 | 说明 |
|---|---|
| 快速上手 | 20–30 分钟内完成 OpenCode 安装和第一个 AI 编程任务 |
| OpenCode 配置深度解析 | opencode.json 的完整参考:Agent 定义、Skill(技能) 注册、类别路由 |
| oh-my-openagent 集成 | oh-my-openagent 的安装配置与 OpenCode 的协同工作模式 |
| 国产模型供应商配置 | 国内大模型 API 接入(DeepSeek/Qwen/Kimi 等)与网络代理设置 |
| 多环境部署方案 | 开发/测试/生产环境的配置分离与 CI/CD 集成要点 |