Claude Code 技能

通过 MCP（Model Context Protocol）控制 Claude Code。该技能全面释放 Claude Code 的能力，赋能 OpenClaw 智能体，支持持久化会话、智能体协作团队以及高级工具控制。

⚡ 快速开始

# 为项目启动一个持久化 Claude 会话
claude-code-skill session-start myproject -d ~/project 
  --permission-mode plan 
  --allowed-tools "Bash,Read,Edit,Write,Glob,Grep" 
  --max-budget 2.00

# 提交复杂任务（Claude 将自主调用工具）
claude-code-skill session-send myproject "查找所有 TODO 注释并创建 GitHub Issue" --stream

# 查看执行进度
claude-code-skill session-status myproject

🎯 何时使用此技能

在以下场景中使用持久化会话：

• ✅ 多步骤任务，需多次调用工具
• ✅ 迭代式开发（编写代码 → 测试 → 修复 → 重复）
• ✅ 长对话需要完整上下文
• ✅ 智能体需自主工作
• ✅ 需要流式实时反馈

在以下场景中直接使用 MCP 工具：

• ✅ 单条命令执行
• ✅ 快速读写文件
• ✅ 一次性搜索
• ✅ 操作间无需共享上下文

📚 命令参考

基础 MCP 操作

# 连接至 Claude Code MCP
claude-code-skill connect
claude-code-skill status
claude-code-skill tools

# 直接调用工具（不启用持久化会话）
claude-code-skill bash "npm test"
claude-code-skill read /path/to/file.ts
claude-code-skill glob "**/*.ts" -p ~/project
claude-code-skill grep "TODO" -p ~/project -c
claude-code-skill call Write -a '{"file_path":"/tmp/test.txt","content":"Hello"}'

# 断开连接
claude-code-skill disconnect

持久化会话（智能体循环）

启动会话

# 基础启动
claude-code-skill session-start myproject -d ~/project

# 使用自定义 API 端点（适用于 Gemini/GPT 代理）
claude-code-skill session-start gemini-task -d ~/project 
  --base-url http://127.0.0.1:8082 
  --model gemini-2.0-flash

# 设置权限模式（plan = 应用前预览变更）
claude-code-skill session-start review -d ~/project --permission-mode plan

# 设置工具白名单（自动批准指定工具）
claude-code-skill session-start safe -d ~/project 
  --allowed-tools "Bash(git:*),Read,Glob,Grep"

# 设置预算上限
claude-code-skill session-start limited -d ~/project --max-budget 1.50

# 完整配置示例
claude-code-skill session-start advanced -d ~/project 
  --permission-mode acceptEdits 
  --allowed-tools "Bash,Read,Edit,Write" 
  --disallowed-tools "Task" 
  --max-budget 5.00 
  --model claude-opus-4-5 
  --append-system-prompt "Always write tests" 
  --add-dir "/tmp,/var/log"

权限模式说明：

发送消息

# 基础发送（阻塞直至完成）
claude-code-skill session-send myproject "为 auth.ts 编写单元测试"

# 流式输出（实时查看进度）
claude-code-skill session-send myproject "重构该模块" --stream

# 自定义超时时间
claude-code-skill session-send myproject "运行全部测试" -t 300000

管理会话

# 列出当前活跃会话
claude-code-skill session-list

# 获取详细状态
claude-code-skill session-status myproject

# 查看对话历史
claude-code-skill session-history myproject -n 50

# 暂停与恢复
claude-code-skill session-pause myproject
claude-code-skill session-resume-paused myproject

# 分叉会话（为实验创建分支）
claude-code-skill session-fork myproject myproject-experiment

# 停止会话
claude-code-skill session-stop myproject

# 重启失败的会话
claude-code-skill session-restart myproject

会话历史与搜索

# 浏览全部 Claude Code 会话
claude-code-skill sessions -n 20

# 按项目搜索会话
claude-code-skill session-search --project ~/myapp

# 按时间搜索
claude-code-skill session-search --since "2h"
claude-code-skill session-search --since "2024-02-01"

# 按关键词搜索
claude-code-skill session-search "bug fix"

# 恢复历史会话
claude-code-skill resume  "从上次中断处继续" -d ~/project

批量操作

# 一次性读取多个文件
claude-code-skill batch-read "src/**/*.ts" "tests/**/*.test.ts" -p ~/project

🤝 智能体协作团队功能

部署多个 Claude 智能体协同处理复杂任务。

基础智能体团队

# 定义智能体团队
claude-code-skill session-start team-project -d ~/project 
  --agents '{
    "architect": {
      "description": "设计系统架构",
      "prompt": "You are a senior software architect. Design scalable, maintainable systems."
    },
    "developer": {
      "description": "实现功能",
      "prompt": "You are a full-stack developer. Write clean, tested code."
    },
    "reviewer": {
      "description": "审查代码质量",
      "prompt": "You are a code reviewer. Check for bugs, style issues, and improvements."
    }
  }' 
  --agent architect

# 在对话中途切换智能体
claude-code-skill session-send team-project "设计认证系统"
# （architect 响应）

claude-code-skill session-send team-project "@developer 实现该设计方案"
# （developer 智能体接管）

claude-code-skill session-send team-project "@reviewer 审查实现结果"
# （reviewer 智能体接管）

预配置团队模板

# 代码审查团队
claude-code-skill session-start review -d ~/project 
  --agents '{
    "security": {"prompt": "Focus on security vulnerabilities"},
    "performance": {"prompt": "Focus on performance issues"},
    "quality": {"prompt": "Focus on code quality and maintainability"}
  }' 
  --agent security

# 全栈开发团队
claude-code-skill session-start fullstack -d ~/project 
  --agents '{
    "frontend": {"prompt": "React/TypeScript frontend specialist"},
    "backend": {"prompt": "Node.js/Express backend specialist"},
    "database": {"prompt": "PostgreSQL/Redis database specialist"}
  }' 
  --agent frontend

🔧 高级功能

工具控制

# 允许特定工具及其子命令模式
--allowed-tools "Bash(git:*,npm:*),Read,Edit"

# 禁用高危操作
--disallowed-tools "Bash(rm:*,sudo:*),Write(/etc/*)"

# 限定仅使用指定工具集
--tools "Read,Glob,Grep"

# 禁用全部工具
--tools ""

系统提示词（System Prompts）

# 完全替换系统提示词
--system-prompt "You are a Python expert. Always use type hints."

# 追加至现有提示词末尾
--append-system-prompt "Always run tests after changes."

会话管理

# 恢复会话并分叉（创建分支）
--resume  --fork-session

# 使用自定义 UUID 指定会话 ID
--session-id "550e8400-e29b-41d4-a716-446655440000"

# 添加额外工作目录
--add-dir "/var/log,/tmp/workspace"

多模型支持（代理模式）

使用 --base-url 将请求路由至代理服务，从而支持其他模型（如 Gemini、GPT）驱动 Claude Code：

# 通过 claude-code-proxy 使用 Gemini
claude-code-skill session-start gemini-task -d ~/project 
  --base-url http://127.0.0.1:8082 
  --model claude-3-5-sonnet-20241022  # 代理将映射为 Gemini

# 通过代理使用 GPT
claude-code-skill session-start gpt-task -d ~/project 
  --base-url http://127.0.0.1:8082 
  --model claude-3-haiku-20240307  # 代理将映射为 GPT

注意：需确保 claude-code-proxy 已在端口 8082 启动，并已正确配置 API 密钥。

# 启动代理服务
cd ~/clawd/claude-code-proxy && source .venv/bin/activate
uvicorn server:app --host 127.0.0.1 --port 8082

🎓 最佳实践

面向 OpenClaw 智能体

1. 多步骤任务务必使用持久化会话

   # ❌ 不推荐：频繁断连/重连
   claude-code-skill bash "step1"
   claude-code-skill bash "step2"
   
   # ✅ 推荐：单次持久化会话
   claude-code-skill session-start task -d ~/project
   claude-code-skill session-send task "依次执行 step1 和 step2"
   

2. 对长时间运行任务使用 --stream

   claude-code-skill session-send task "运行完整测试套件" --stream
   

3. 设置预算上限以保障安全

   --max-budget 2.00  # API 调用费用达 $2 时自动终止
   

4. 关键变更启用 plan 模式

   --permission-mode plan  # 应用前预览变更内容
   

5. 实验前先分叉会话

   claude-code-skill session-fork main experimental
   claude-code-skill session-send experimental "尝试高风险重构"
   

错误恢复

# 若会话失败：
claude-code-skill session-status myproject  # 查看失败原因
claude-code-skill session-history myproject -n 20  # 查看最近事件
claude-code-skill session-restart myproject  # 从最后正常状态重启

# 若需彻底重试：
claude-code-skill session-stop myproject
claude-code-skill session-start myproject -d ~/project --resume 

🏗️ 架构概览

openclaw agent
    ↓
claude-code-skill CLI（本工具）
    ↓ HTTP
sasha-doctor API (:18795)
    ↓ MCP
claude mcp serve（Claude Code）
    ↓
您的文件与工具

🔌 可用工具（通过 MCP）

所有 Claude Code 工具均可调用：

📊 示例

示例 1：代码审查

claude-code-skill session-start review -d ~/myapp 
  --permission-mode plan 
  --agents '{"security":{"prompt":"Focus on security"},"quality":{"prompt":"Focus on quality"}}' 
  --agent security

claude-code-skill session-send review 
  "审查 src/ 下所有 TypeScript 文件，检查安全漏洞及代码质量问题" 
  --stream

示例 2：自动化测试

claude-code-skill session-start test -d ~/myapp 
  --allowed-tools "Bash(npm:*,git:*),Read,Write" 
  --max-budget 1.00

claude-code-skill session-send test 
  "查找所有未覆盖函数，编写单元测试，运行测试并修复失败项"

示例 3：多智能体调试

claude-code-skill session-start debug -d ~/myapp 
  --agents '{
    "detective": {"prompt": "Find the root cause of bugs"},
    "fixer": {"prompt": "Implement fixes"},
    "tester": {"prompt": "Verify fixes work"}
  }' 
  --agent detective

claude-code-skill session-send debug "API 服务存在内存泄漏问题" --stream
# detective 展开调查，随后移交 fixer 实施修复，再交由 tester 验证

🔗 与 OpenClaw 集成

当 OpenClaw 需执行复杂编码任务时：

# 在 openclaw 智能体上下文中执行：
openclaw skills run claude-code-skill -- session-start task -d ~/project
openclaw skills run claude-code-skill -- session-send task "实现特性 X" --stream
openclaw skills run claude-code-skill -- session-status task

或通过 sasha-doctor HTTP API 以编程方式调用该技能（参见 TOOLS.md 第 3 节）。

📖 参阅

• TOOLS.md 第 3 节 — 完整 HTTP API 文档
• sasha-doctor 端点 — 后端集成详情
• Claude Code 文档 — 官方 Claude Code 文档（可通过 qmd 工具查询）