Docs

AI运维

ClaudeCode-集合

ClaudeCode
工程化
- 推荐项目结构
- 注解
- harness
  - Hooks
  - Skills
  - Plugins
  - LSP
  - Subagents
  - MCP: 连接内部工具
最佳实践

ClaudeCode

Anthropic 推出的 AI 编程助手

https://github.com/anthropics/claude-code

https://code.claude.com/docs/zh-CN/overview

install

curl -fsSL https://claude.ai/install.sh | bash

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
npm install -g @anthropic-ai/claude-code

概念

CLAUDE.md       # 添加 Claude 每个会话都能看到的持久上下文
Skills          # 添加可重用的知识和可调用的工作流
MCP             # 将 Claude 连接到外部服务和工具
Subagents       # 在隔离的上下文中运行自己的循环, 返回摘要
Agent teams     # 协调多个独立会话, 具有共享任务和点对点消息传递
Hooks           # 完全在循环外运行作为确定性脚本
Plugins         # 和 marketplaces 打包和分发这些功能

memory

CLAUD.md 文件, 默认启动时自动加载
Auto memory (自动记忆)

运行 /memory 命令查看加载了哪些内存文件

Auto memory

会记录用户对项目的历史要求

~/.claude/projects/project_name/

agentTeams

采用对等协作式架构

不仅仅是一个主管和多个工人的关系, 而是一个真正的虚拟团队

团队成员之间可以通过共享任务列表和内置的"收件箱"系统直接相互通信, 分享发现, 挑战彼此方案, 实现自主协作;

模型管理

官方模型

opus 复杂任务
sonnet 日常
haiku 小活

模型别名 - 别名始终指向最新版本

default 推荐的模型设置, 取决于你的账户类型
sonnet 使用最新的 Sonnet 模型(当前为 Sonnet 4.5)用于日常编码任务
opus 使用最新的 Opus 模型(当前为 Opus 4.6)用于复杂推理任务
haiku 使用快速高效的 Haiku 模型用于简单任务
sonnet[1m] 使用 Sonnet 和 100 万 token 上下文窗口用于长会话
opusplan 特殊模式, 在计划模式中使用 opus, 然后在执行时切换到 sonnet

模型切换优先级

在会话期间 - 使用 /model <alias|name> 在会话中切换模型
启动时 - 使用 claude --model <alias|name> 启动
环境变量 - 设置 ANTHROPIC_MODEL=<alias|name>
设置 - 在设置文件中使用 model 字段永久配置;

claude --model opus
/model sonnet
/model sonnet[1m]

外部供应商模型配置

# moonshot kimi
export ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic"
export ANTHROPIC_MODEL=kimi-k2-thinking-turbo                   # 默认模型
export ANTHROPIC_AUTH_TOKEN="sk-li7PZE5njPFB111x26EXOqLFnj78kcUeHMxqZ4idbIDgk111"
export ANTHROPIC_DEFAULT_OPUS_MODEL=kimi-k2-thinking-turbo
export ANTHROPIC_DEFAULT_SONNET_MODEL=kimi-k2-thinking-turbo
export ANTHROPIC_DEFAULT_HAIKU_MODEL=kimi-k2-thinking-turbo     # haiku
export CLAUDE_CODE_SUBAGENT_MODEL=kimi-k2-thinking-turbo        # 子任务模型

# 火山
export ANTHROPIC_BASE_URL="https://ark.cn-beijing.volces.com/api/coding"

管理cli


claude --version
claude update

claude              # 交互式启动
claude "body"       # 一次性任务

claude -p "查询内容"    # 非交互模式
claude -p "查询" --output-format json   # 输出格式控制

# 恢复会话
claude -c                    # 继续最近的一次会话
claude -r <session-id>       # 恢复指定会话

# 权限控制
claude --dangerously-skip-permissions  # 跳过权限提示(需谨慎)

# 工具管理
claude --allowedTools "Edit" "Bash(git:*)"
claude --disallowedTools "Edit"

# 模型选择
claude --model sonnet
claude --model opus

claude doctor       # 检查修复和更新

# 全局跳过权限(危险模式)
claude --dangerously-skip-permissions

# 仅允许必要的工具
claude --allowedTools "Read" "Edit" "Bash(git:*)"

# 禁用危险操作
claude --disallowedTools "Bash(rm:*)" "Bash(sudo:*)"

## 使用情况监控
claude --verbose                    # 详细日志
claude --output-format json         # 输出结构化日志

tui

/init           # 初始化项目, 创建 CLAUDE.md; 自动为已有项目创建 CLAUDE.md 方便后续开发
/clear          # 清除对话上下文
/compact        # 压缩对话内容, 减少 token 使用
/cost           # 查看 token 使用统计
/skills         # 查看相关命令
/agents         # 查看 agents 列表
/goal           # 给一个客观可验证的终止条件，Claude 自己跑到条件满足为止

/help            # 获取帮助
/memory          # 编辑项目记忆文件
/model           # 切换模型(Sonnet/Opus)
/status          # 查看账户与系统状态
/config          # 查看或修改配置
/doctor          # 检查安装状态
/review          # 请求代码审查
/vim             # 进入 vim 编辑模式

高级命令:
/mcp             # 管理 MCP 连接
/add-dir <path>  # 添加额外工作目录
/terminal-setup  # 配置 Shift+Enter 换行
/pr_comments     # 查看 Pull Request 评论
/bug             # 上报错误给 Anthropic


/permissions    # 查看权限设置

# 允许特定命令
/permissions allow "Bash(git:*)"
/permissions allow "Edit"

memory

# 写入记忆
/memory 项目用 Next.js 14 + TypeScript，接口规范见 docs/api.md
/memory list                # show
/memory delete [key]

fastKey

Ctrl+C          # 取消输入 / 中断生成
Ctrl+D          # 退出 Claude Code
Ctrl+L          # 清屏
Esc             # 中断当前操作
Esc + Esc       # 编辑上条消息
↑ / ↓             # 浏览历史
Shift+Tab       # 切换计划模式
\ + Enter       # 多行输入
Option+Enter    # 多行输入(macOS)

Ctrl+B          # 后台运行
Esc + Esc   回退代码/对话  将代码和/或对话恢复到之前的状态

commands 自定义命令

本质上就是一个存放在指定位置的 Markdown 文件, 文件定义了一些配置属性(FrontMatter)形式, 具体包括这个 Command 的名称以及描述等

通过 /name 触发

~/.claude/commands/             # 全局作用域
{project}/.claude/commands/     # 项目作用域

示例1

~/.claude/commands/deploy.md

---
name: deploy
description: 描述, UI展示使用
---

按步骤执行以下操作
1. 运行 `go test ./...`
2. 编译
3. 部署

触发

使用自定义命令:
/deploy 部署这个环境

hook

每次任务结束时触发一个任务, 例如格式化代码

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "prettier --write $CLAUDE_TOOL_INPUT_PATH 2>/dev/null || true"
          }
        ]
      }
    ]
  }
}

skills

Skill 有三种存放位置:

个人级: ~/.claude/skills/, 所有项目通用, 不进 Git
项目级: .claude/skills/, 跟随项目提交, 团队共享
插件级: 通过插件市场安装, 用 plugin-name:skill-name 调用

Skill 分两种触发方式;

手动输入 /skill-name 触发
Claude 根据 Skill 的 description 字段自动判断是否加载

可以设 disable-model-invocation: true 禁止自动触发

内置的几个 Skill

/simplify 审查你最近改动的文件, 找出代码重复, 质量问题, 效率低下的地方, 然后自动修复; 会并行启动三个审查 Agent, 分别从不同角度审查你的代码

/simplify /simplify error handling 只看错误处理 /simplify reduce duplication 只看重复代码 /simplify memory efficiency 只看内存效率

/review 严格的 PR Reviewer, 重点找 Bug, 逻辑错误, 边界情况, 风格问题

/review 审查本地未提交的改动
/review 123 审查指定编号的 PR
/review ``https://github.com/org/repo/pull/123 审查指定 URL 的 PR

/batch 当你需要对大量文件执行同一类操作时, /batch 会把工作拆解成 5-30 个独立单元, 每个单元在独立的 Git Worktree 中并行执行;

/batch 将所有测试文件从 Jest 迁移到 Vitest
/batch 给 src/utils/ 下所有文件添加 TypeScript 类型
/batch 更新所有 API 接口使用新的认证中间件

适合模式化的重复操作

/loop 可以按时间间隔反复执行一个提示词, 适合监控场景:

/loop 5m 检查开发服务器日志里有没有新错误
/loop 10m 运行测试套件并报告失败用例
/loop 1h 检查部署状态并汇总指标

/debug Claude 诊断自己"的工具; 它会读取会话的调试日志, 帮你找出问题原因:

/debug 自动分析最近的问题
/debug 为什么上一次编辑失败了
/debug 工具调用一直超时

mcp

配置作用域:

local: 当前项目私有
project: 项目团队共享
user: 个人全局配置

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

claude mcp add --transport http corridor https://app.corridor.dev/api/mcp --header "Authorization: Bearer ..."

# Add stdio server with environment variables:
claude mcp add my-server -e API_KEY=xxx -- npx my-mcp-server

# Add stdio server with subprocess flags:
claude mcp add my-server -- my-command --some-flag arg1

常用 MCP 服务器

文件系统服务器:
claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Documents ~/Projects

网络搜索服务器:
claude mcp add brave-search -s user -- npx -y @modelcontextprotocol/server-brave-search

浏览器自动化
claude mcp add puppeteer -s user -- npx -y @modelcontextprotocol/server-puppeteer

添加需要认证的远程服务器

claude mcp add --transport sse github-server https://api.github.com/mcp

# 在 Claude Code 中认证
/mcp

# 选择 "Authenticate" 完成 OAuth 流程

mcp 管理 cli

claude mcp list                     # 列出所有配置的服务器
claude mcp get my-server            # 查看特定服务器详情
claude mcp remove my-server         # 移除服务器

添加本地 mcp cli

claude mcp list
claude mcp add --transport stdio hello-cli -- /home/wait/git/code2/go-project/mcp2/build/mcp2
claude mcp remove hello-cli

Subagent

注解

支持为每个子代理指定不同的模型
上下文隔离: 每个 Agent 拥有自己独立且精简的上下文窗口
角色固化: 将"你是测试专家"这样的指令固化成可复用的 Agent 配置
并行处理: 多个 Agent 可以同时工作

模式

主 Agent (Orchestrator): 扮演"技术主管"角色, 负责任务拆解, 分发和结果汇总, 但不直接处理具体工作

子 Agent (Workers): 扮演"专职员工"角色, 执行具体的, 定义明确的任务, 然后将结果汇报给主 Agent

调用 Agents

可以告诉 Claude Code 去调用某个 Agent, 也可以在 CLAUDE.md 中添加 Agents 调用规则

Agent 设计原则

单一职责: 每个 Agent 只做一件事
明确输入输出
串并行合理规划: 有数据依赖的 Agent 串行, 无依赖的并行
系统提示词要给示例: 尤其是输出格式

定义

Subagent 通过 Markdown + YAML frontmatter 定义, 存放在:

.claude/agents/ # 项目级, 只对当前项目生效 ~/.claude/agents/ # 用户级, 全局生效

model 字段支持的值: opus — Claude Opus(强大能力) sonnet — Claude Sonnet(平衡性能与速度) haiku — Claude Haiku(快速低成本) inherit — 继承主会话的模型(默认值)

示例: 前端开发 Agent

# .claude/agents/frontend-dev.md
---
name: frontend-dev
description: 前端组件开发专家, 负责 React/Vue 组件编写, CSS 样式和 UI 交互
tools: Read, Write, Edit, Bash, Glob, Grep
model: sonnet
---
你是一位高级前端开发工程师, 专注于:
- React/Vue 组件开发
- Tailwind CSS 样式设计
- 响应式布局和交互优化
- TypeScript 类型安全
开发时遵循以下原则:
1. 组件粒度适中, 单一职责
2. 使用 TypeScript 严格模式
3. 优先使用 Tailwind 工具类
4. 确保可访问性 (a11y)

示例: 代码审查 Agent 系统提示词

# .claude/agents/code-reviewer.md
---
name:code-reviewer
description:代码审查专家, 负责安全漏洞, 性能问题和最佳实践检查
tools:Read,Grep,Glob
model:sonnet
---
你是一位资深代码审查员; 审查时关注:

## 安全分析
-SQL 注入, XSS, CSRF 漏洞
- 敏感信息泄露(APIkey, 密码硬编码)
- 权限控制缺失

## 性能分析
-N+1 查询问题
- 不必要的重渲染
- 内存泄漏风险

## 代码质量
- 命名规范和可读性
- 重复代码和抽象机会
- 错误处理完整性

输出格式: JSON { summary, issues: [{ severity:"P0"|"P1"|"P2", ... }] }

示例: 后端架构 Agent 系统提示词

# .claude/agents/backend-architect.md
---
name:backend-architect
description:后端架构设计和实现专家, 负责 API 设计, 数据库建模和系统架构
tools:Read,Write,Edit,Bash,Glob,Grep
model:opus
---
你是一位高级后端架构师, 精通:
-RESTful/GraphQLAPI 设计
- 数据库建模(关系型和 NoSQL)
- 微服务架构和分布式系统
- 性能优化和缓存策略

设计原则:
1.API 优先设计, 契约驱动
2. 领域驱动设计(DDD)边界划分
3.CQRS+EventSourcing 适用时采用
4. 完善的错误处理和日志链路

交互式创建 agent, 自动完善提示词; 按 e 进行修改, 或者回车直接保存

/agents
create new agent

everything-claude-code

agent 集合 - 覆盖全栈开发的多个高质量 Sub-Agent

https://github.com/affaan-m/everything-claude-code

Step 1: 在 Claude Code 对话框中安装插件
/plugin marketplace add affaan-m/everything-claude-code
/plugin install everything-claude-code@everything-claude-code


Step 2: 在终端中安装依赖
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code
./install.sh typescript

Step 3: 验证安装
在 Claude Code 对话框中查看安装情况
/plugin list everything-claude-code@everything-claude-code

工程化

注解

在 rules 内通过 paths 实现规则隔离
从子目录初始化, 不要从根目录, 减少上下文开销

harness

harness 即围绕模型搭的基础设施: CLAUDE.md, Hooks, Skills, Plugins, MCP 服务器, LSP 集成, Subagents

核心理解

CLAUDE.md 是核心引导
rules 是约束
skills 是赋予新能力
lsp 是代码开发必备的快速索引
MCP 是操作外部大数据的必要规范措施
Subagents 并行处理多任务
commands 是预定义的快捷命令操作

Hooks

关键是 stop hooks, 在结束时进行反思, 提议更新 CLAUDE.md

Skills

单独的专项能力包

Plugins

把 Skills, Hooks, MCP 配置打包成一个可安装的东西, 团队共享

LSP

LSP 让 Claude 能像 IDE 一样跳转到定义, 查找引用; 没有 lsp, Claude 只能用 grep 做文本匹配, 容易找错

Subagents

是独立的 Claude 实例, 有自己的 context window, 干完活只把结果返回给主 agent; 建议用 subagent 做只读的探索任务, 主 agent 专注编辑

MCP: 连接内部工具

例如外部 API 文档不应该全塞进 context, 应该做成 MCP 服务器按需查询

加载机制

CLAUDE.md 每次加载,
Hooks 关键时刻触发,
Skills 按需加载
LSP 始终在线(配置后)
MCP 连外部工具
Subagents 按需调用

最佳实践

模式切换

三种模式切换 - Shift+Tab 循环切换

编辑模式(默认): 所有更改需确认, 稳健派首选;
自动接受模式: 一键直接写, 适合大多数任务, 省时省力;
计划模式: 只生成行动计划不动代码, 适合方案推演和调研;

规划优先原则

先探索后编码：让 Claude 先理解项目结构
制定详细计划：使用 think 命令深度思考
分步骤执行：避免一次性大型重构
及时版本控制：频繁提交保存进度

实际操作：

第一步：项目分析: "分析这个项目的架构，不要编写代码"
第二步：制定计划: "think hard 如何重构用户认证模块"
第三步：分步实施: "首先重构登录功能，然后处理注册功能"

代码质量保证

自动代码审查 /review
指定审查范围: "审查 src/components/ 目录下的所有文件"
安全检查: "检查这个应用是否存在安全漏洞"

测试策略

单元测试: "为这个函数编写单元测试"
集成测试: "为用户注册流程编写集成测试"
端到端测试: "编写购物车功能的 e2e 测试"

思考模式

触发思考模式 think: 标准思考, 需要一定推理的普通任务 think hard: 深度思考, 较复杂的问题 think harder: 更深度思考, 疑难问题 think hardest: 最深度思考-复杂任务

成本控制

文件过滤：.claudeignore
上下文压缩：/compact
文档驱动：CLAUDE.md
记忆管理：/memory
Plan Mode; Shift+Tab
模型切换：/model
```
/model haiku
/model sonnet
/model opus
```
新任务清理上下文 /clear
查看使用统计 /cost

最后更新于 2026-05-10

AI-Agent开发 openclaw

ClaudeCode-集合

ClaudeCode

install

概念

memory

Auto memory

相关文件

agentTeams

模型管理

外部供应商模型配置

管理cli

tui

commands 自定义命令

示例1

hook

skills

内置的几个 Skill

mcp

mcp 管理 cli

添加本地 mcp cli

Subagent

模式

调用 Agents

Agent 设计原则

定义

everything-claude-code

工程化

推荐项目结构

注解

harness

Hooks

Skills

Plugins

LSP

Subagents

MCP: 连接内部工具

最佳实践

模式切换

规划优先原则

代码质量保证

思考模式

成本控制