Structure Docs

Appearance

AI 编程 Agents 使用指南 ​

概述 ​

本目录汇总了当前主流 AI 编程 Agent 与通用 Agent 的使用与配置教程，帮助团队快速上手并选择适合的工具。

编程 Agent 对比 ​

工具厂商形态平台默认模型开源核心特点
Claude CodeAnthropicCLI + IDE 插件macOS / Linux / WindowsClaude 系列部分开源Agent 能力强，MCP / Hooks / Skills / 权限体系完善
CursorAnysphereIDEmacOS / Windows / LinuxClaude / GPT 等否可视化，Tab 补全 + Composer
Codex CLIOpenAICLImacOS / Linux / WindowsGPT 系列开源沙盒模式，Git 集成
Qoder阿里云（通义）CLI + IDE + JetBrainsmacOS / Linux / WindowsQwen 系列部分开源自定义/本地模型，中文友好
Trae字节跳动IDE + CLImacOS / Windows豆包 / DeepSeek / Claude / GPT部分开源免费，Chat / Builder / SOLO 模式
CodeBuddy腾讯CLI + IDE + 插件macOS / Linux / Windows混元 / DeepSeek / Claude 等部分开源腾讯云生态，三位一体
OpenCodeAnomalyCLI/TUI + 桌面 + 插件macOS / Linux / Windows(WSL)供应商中立开源数百种模型，任意 OpenAI/Anthropic 端点
ClineClineIDE 扩展 + CLI + SDKmacOS / Linux / Windows30+ 供应商开源Plan & Act 双模式，审批机制完善
Kilo CodeKiloCLI + IDE 扩展macOS / Linux / Windows供应商中立开源OpenCode Fork，Architect/Code/Debug 模式
ZCode智谱 AI桌面 ADEmacOS / Windows / LinuxGLM 系列否多任务并行、闲时任务调度

通用 Agent 对比 ​

工具昵称核心特点运行方式
OpenClaw小龙虾执行外壳 + 网关 + 技能，50+ 渠道本地 / 服务器
Hermes爱马仕持久记忆 + 自我进化技能本地 / 服务器
OpenHands—自主软件工程智能体Docker / 云

目录结构 ​

agents/
├── index.md                # 本文件：总览与选型
├── automation-summary.md  # Agent 自动化工作总结
├── cli-methodology.md     # CLI 通用方法论：权限 / 技能 / 规则 / 文档
├── claude-code.md         # Claude Code 使用和配置指南（详细）
├── cursor.md              # Cursor AI IDE 教程
├── codex.md               # OpenAI Codex CLI 教程
├── qoder.md               # Qoder CLI 教程
├── trae.md                # Trae IDE 教程
├── codebuddy.md           # CodeBuddy Code CLI 教程
├── opencode.md            # OpenCode 教程
├── cline.md               # Cline 教程
├── kilo-code.md           # Kilo CLI / Kilo Code 教程
├── zcode.md               # ZCode 桌面 ADE 教程
├── openclaw.md            # OpenClaw（小龙虾）教程
├── hermes.md              # Hermes Agent（爱马仕）教程
└── openhands.md           # OpenHands 教程

工作流平台（Dify / Coze / n8n）文档见独立的 workflow/ 目录。

国内云平台的 Coding Plan / Token Plan 订阅接入配置见 coding-plan/ 目录。

选型建议 ​

场景推荐工具理由
深度 Agent 化开发、复杂重构Claude CodeAgent 能力最强，MCP/Hooks/Skills 生态完善
可视化日常开发CursorTab 补全 + Composer，体验流畅
OpenAI 生态、Git 集成Codex CLI沙盒模式，原生 Git 工作流
国内网络、阿里云/通义生态Qoder基于 Qwen，支持百炼/魔搭 API
免费、可视化 IDE、快速原型Trae免费，Builder/SOLO 模式
腾讯云生态、企业私有化CodeBuddy腾讯云三位一体
自由切换任意模型供应商OpenCode / Kilo CLI供应商中立，可接入任意 OpenAI/Anthropic 端点
需要严格审批、先规划后执行ClinePlan & Act 双模式，逐步审批
GLM 套餐用户、图形化操作ZCode深度集成 GLM，支持闲时任务降低消耗
系统级自动化、跨平台消息OpenClaw50+ 渠道，本地优先
长期记忆、经验沉淀Hermes持久记忆 + 自我进化技能
自主修 bug、生成 PROpenHands自主软件工程智能体

通用方法论 ​

无论使用哪个工具，以下能力都是核心（详见 cli-methodology.md）：

  1. 权限 (Permissions)：控制 Agent 能做什么，防止误操作
  2. 技能 (Skills)：封装可复用的领域能力
  3. 规则 (Rules)：通过规则文件约束 AI 的行为和代码风格
  4. 文档 (Documentation)：维护上下文记忆，保持 AI 与项目知识同步

快速导航 ​