AI Agents¶

从环境准备到真实项目工作流，逐步学习 Codex、Claude Code、OpenCode、Pi、oh-my-pi、DSH、Kimi Code、WorkBuddy 与 Hermes。Windows 以 Git Bash 为主并介绍 PowerShell 7，兼顾 WSL、macOS 与 Linux。

这套教程能帮助你做什么¶

你将准备环境、安装并登录一款 Harness、完成可检查的文件任务，再学习项目规则、扩展、自动化与多 Agent 协作。各工具能力以官方资料为准，示例会注明核验范围。

选择你的学习路线¶

• Windows 原生：先看Git Bash 与 PowerShell 7。
• WSL：先看WSL 环境准备，理解与 Windows 原生的边界。
• macOS / Linux：平台环境准备。
• Python 项目或 MCP 服务需要 Python 时，再看uv 与 Anaconda3。

选择一款 Harness¶

• Codex CLI
• Claude Code CLI
• OpenCode
• Pi
• oh-my-pi
• DSH（DeepSeek Harness）
• Kimi Code CLI
• WorkBuddy
• Hermes Agent

不确定怎么选？先完成概念入门，再看工具选择与迁移。

按需配置配套工具¶

选定并用过一款 Harness 后，再按需要使用下面两款工具：

• CC Switch：配置切换。需要管理多个提供商或受支持客户端时阅读，先确认客户端自己的认证方式与配置位置。
• 模型 API 协议与接入。分清 Chat Completions、Responses 和 Anthropic Messages，以 DeepSeek 为例配置 Codex、Claude Code，理解何时需要协议转换。
• Herdr：终端组织。需要标签页、分屏和会话管理时阅读；基础布局无需多 Agent，协作部分可在掌握后面的自动化原则后回来实践。

按需选择这些专题，不影响直接继续学习日常工作流。

从基础任务到配置与扩展¶

1. 认识 Agent 与 Harness
2. 完成第一个 Agent 任务
3. 建立日常开发工作流
4. 撰写 AGENTS.md 与管理上下文
5. 扩展：Skills、MCP 与插件

迁移、自动化与协作¶

需要更换工具时阅读工具选择与迁移。准备脚本化任务或并行处理工作时，先阅读自动化与多 Agent 协作中的分工与隔离原则，再按需返回 Herdr 的协作部分实践。

遇到问题与版本变化¶

查阅常见问题、术语与命令速查及版本核验与教程维护。

学习路线图¶

flowchart LR
  A[平台准备] --> B[选择 Harness]
  B --> C[完成首个任务]
  C --> D[项目规则与日常工作流]
  C -. 可选 .-> T["配套工具：CC Switch / Herdr"]
  T -.-> D
  D --> E[扩展与迁移]
  E --> F[自动化与协作]
  F --> G[维护]

页面提供的是文档教程，不代表作者已在所有平台实测。安装、认证、服务商费用和功能状态请以链接的官方资料为准。