OpenCode 实用学习指南
本目录包含 OpenCode CLI 工具的完整学习文档，从基础命令到高级功能，以 Python Web API 项目为例进行实战演练。
文档导航
入门篇
| 文档 | 内容 | 建议学习时长 |
|---|
| 01-OpenCode快速上手.md | 安装配置、基础命令、基本操作 | 30分钟 |
| 02-CLI交互技巧.md | 命令行高效交互技巧 | 30分钟 |
核心功能篇
| 文档 | 内容 | 建议学习时长 |
|---|
| 03-MCP与工具调用.md | MCP 服务器在 CLI 中的使用 | 45分钟 |
| 04-SubAgent任务分发.md | Task 工具并行处理 | 40分钟 |
| 05-Hooks自动化.md | 命令钩子、工作流自动化 | 40分钟 |
| 06-Skills复用.md | 技能创建与共享 | 35分钟 |
进阶篇
| 文档 | 内容 | 建议学习时长 |
|---|
| 07-代码分析与重构.md | 批量编辑、智能分析 | 45分钟 |
| 08-OpenCode独有技巧.md | 自然语言命令、Git 集成 | 35分钟 |
| 09-实战：PythonWebAPI开发.md | FastAPI 项目完整开发 | 90分钟 |
高级篇
| 文档 | 内容 | 建议学习时长 |
|---|
| 10-多模型配置指南.md | 配置多个大模型、海外模型（Claude Opus） | 30分钟 |
| 11-项目规划测试代码审查实战.md | 软件工程全流程：规划、测试、代码审查 | 90分钟 |
推荐学习路线
初学者路线（总计约 3 小时）
01-OpenCode快速上手 → 02-CLI交互技巧 → 08-OpenCode独有技巧 → 09-实战：PythonWebAPI开发
进阶开发者路线（总计约 5 小时）
01-OpenCode快速上手 → 02-CLI交互技巧 → 03-MCP与工具调用 → 04-SubAgent任务分发 → 05-Hooks自动化 → 06-Skills复用 → 07-代码分析与重构 → 09-实战：PythonWebAPI开发
实战项目简介
Python FastAPI Web API 开发
- 项目地址: github.com/example/fastapi-todo-api
- 技术栈: FastAPI + SQLAlchemy + Pydantic + pytest
- 展示功能:
- 使用自然语言命令初始化项目
- 使用 MCP Browser 测试 API 端点
- 使用 Sub Agent 并行生成 CRUD 代码
- 使用 Hooks 自动化测试和 Git 提交
- 使用 Skills 标准化 API 开发流程
核心命令速查表
| 命令 | 功能 | 示例 |
|---|
/help | 显示帮助信息 | /help |
/status | 查看当前状态 | /status |
/clear | 清除对话历史 | /clear |
/compact | 压缩历史 | /compact |
/exit | 退出 | /exit |
核心功能速查表
| 功能 | 使用方式 | 应用场景 |
|---|
| 文件操作 | 自然语言描述 | “读取 src/main.py” |
| 代码生成 | 直接描述需求 | “创建一个 User 模型” |
| 批量修改 | 描述修改范围 | “将所有 print 改为 logging” |
| Git 操作 | 自然语言命令 | “提交当前更改” |
| 终端命令 | 直接输入 | “运行 pytest” |
| Sub Agent | 使用 Task 工具 | “并行处理多个文件” |
目录结构
open code/ ├── README.md # 本文件 ├── 01-OpenCode快速上手.md # 基础入门 ├── 02-CLI交互技巧.md # CLI 交互 ├── 03-MCP与工具调用.md # MCP 服务器 ├── 04-SubAgent任务分发.md # 并行任务 ├── 05-Hooks自动化.md # Hooks 自动化 ├── 06-Skills复用.md # 技能复用 ├── 07-代码分析与重构.md # 代码重构 ├── 08-OpenCode独有技巧.md # 独有功能 ├── 09-实战：PythonWebAPI开发.md # 实战项目 ├── 10-多模型配置指南.md # 多模型配置 └── 11-项目规划测试代码审查实战.md # 软件工程全流程
与 Claude Code 的区别
| 特性 | OpenCode | Claude Code |
|---|
| 使用方式 | 命令行 CLI | 命令行 CLI |
| 交互模式 | 自然语言为主 | 自然语言为主 |
| 文件编辑 | 批量文件操作 | 批量文件操作 |
| Sub Agent | 显式 Task 工具 | 显式 Task 工具 |
| MCP 使用 | 通过工具调用 | 通过工具调用 |
| 适用场景 | 大型重构、批量操作 | 大型重构、批量操作 |
相关资源
- OpenCode 官方文档
- Python FastAPI 文档
