OpenCode 实用学习指南
本目录包含 OpenCode CLI 工具的完整学习文档,从基础命令到高级功能,以 Python Web API 项目为例进行实战演练。
文档导航
入门篇
核心功能篇
进阶篇
高级篇
推荐学习路线
初学者路线(总计约 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 使用 |
通过工具调用 |
通过工具调用 |
| 适用场景 |
大型重构、批量操作 |
大型重构、批量操作 |
相关资源
所有评论(0)