学了这个可以做什么
先建立一套稳定的工具与排错方式
看懂主流终端 Agent 的差异
把 Claude Code、Codex CLI、Gemini CLI 之间的能力和取舍捋清楚，避免踩坑选错工具。
建立配置与权限判断方式
理解 settings 三层模型、hooks、MCP 接入和权限边界，知道遇到问题先看哪一层。
排查终端 Agent 高频问题
在装包失败、上下文超限、hook 死循环、API 限流等场景下能快速找到对应卡片。
CLI 速查手册
CLI 速查手册
这页不是导览页，而是一个更接近 README 的速查入口。遇到终端 Agent 工具、配置、工作流和集成术语不清楚时，先来这里查，再顺着左侧知识树继续展开。
分类导航
按主题浏览知识卡片
学习时长
你可以按投入时间来用它
10-20 分钟
先扫一遍「为什么用 CLI Agent」和工具横向对比，建立基本判断。
半天
把核心工具、配置、典型工作流和集成串起来，适合第一次系统了解。
1-3 天
沿着知识树连续阅读，再配合最佳实践和排错卡片，形成稳定的工作流认知。
如何使用
把它当成 README，而不是首页导览
- 01
先看左侧知识树，找到你当前最关心的工具、配置或工作流主题。
- 02
如果只记得术语，不记得它在哪个章节，就点开搜索面板查。
- 03
遇到装不上、跑不通、配错了，把这里当排错速查手册用，不必从头读。
推荐顺序
从入门到深用的学习路径
先理解 CLI Agent 的本质
搞清楚和 IDE 插件、网页版的差别，理解为什么 2026 年它成了主战场。
再选定一个核心工具
Claude Code 还是 Codex 还是 Gemini CLI，按照模型、价格、权限模型选定一个先深用。
然后补配置与工作流
settings 模型、hook 钩子、MCP 接入和典型工作流是真正决定使用体验的部分。
最后展开集成与实践
Git worktree、tmux、Obsidian、飞书等集成方案，和上下文预算、权限治理等长期实践。
常见误区
入门 CLI Agent 最容易混淆的点
- 不要把 CLI Agent 等同于「无 UI 的弱化版」，它在终端里是一等公民。
- 不要一次性装齐四个工具，先选一个深用，再做横向对比。
- 不要把 Skills、hooks、MCP 当成同一类东西，三者分别解决不同层的问题。