claude
claude-code
安装
claude-code安装命令:npm install -g @anthropic-ai/claude-code
配置
cd .claude
touch .settings.json

{
"env": {
"ANTHROPIC_AUTH_TOKEN": "glm token key",
"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
},
"enabledPlugins": {
"superpowers@claude-plugins-official": true,
"chrome-devtools-mcp@chrome-devtools-plugins": true
}
}
使用
//运行命令
claude
//mcp添加
claude mcp add -s user chrome-devtools npx chrome-devtools-mcp@latest
claude mcp add -s user playwright npx @playwright/mcp@latest
//# oh-my-claudecode
/plugin marketplace add GitHub - Yeachan-Heo/oh-my-claudecode: Teams-first Multi-agent orchestration for Claude Code
/plugin install oh-my-claudecode
//#everything-claude-code
/plugin marketplace add GitHub - affaan-m/everything-claude-code: The agent harness performance optimization system. Skills,
/plugin install ecc@ecc
常用插件superpower安装
github地址:superpowers
一、核心理念:先想清楚,再动手写
Superpowers 解决 AI 编程三大通病:
急于写代码:需求没理清就开始写,反复返工
无测试、无质量:只写主流程,不考虑边界、异常、测试
无工程化:不做设计、不分任务、不审查、不验证
它的口号:
让 AI 像资深工程师一样工作,而不是像只会写代码的实习生。
二、核心能力:20+ 技能(Skills)覆盖全开发流程
Superpowers 不是简单提示词,而是一套 强制执行的****工作流****系统。常用核心技能:
1. 需求与规划(必用)
/brainstorming:头脑风暴、苏格拉底式提问,先理清需求、边界、约束再动手/writing-plans:把大任务拆成 2–5 分钟可执行小任务,精确到文件、步骤、验证点
2. 开发与质量(最关键)
/test-driven-development (TDD):先写测试 → 再写实现 → 重构,强制红 - 绿 - 重构循环/systematic-debugging:4 步系统化调试,找根因、不瞎改/executing-plans:按计划一步步执行、自动验证、不跳步
3. 协作与工程化
/requesting-code-review:自动做代码审查、自检质量/using-git-worktrees:Git 多分支安全并行开发/dispatching-parallel-agents:子代理并行处理多文件任务
三、完整工作流(7 阶段)
用 Superpowers 开发,AI 会自动走这套流程:
需求澄清(brainstorming)
方案设计
编写计划(writing-plans)
TDD 开发(先测后码)
系统化调试
代码审查
验证与交付
Claude code安装superpower
# 安装Claude Code Official Marketplace/plugin install superpowers@claude-plugins-official# 安装superpowers/plugin marketplace add obra/superpowers-marketplace/plugin install superpowers@superpowers-marketplace
Codex
直接codex 输入框(Tell Codex):
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md
使用
# 格式: /brainstorming 你的需求描述 # 示例: /brainstorming 用 React + TypeScript 做一个待办 App,支持增删改查、本地存储](https://github.com/obra/superpowers)
常用插件everything-claude-code (ecc)
ecc plugin Github地址:https://github.com/affaan-m/everything-claude-code
Everything Claude Code (ECC):为你组建一支完整的虚拟开发团队(架构师、测试、安全、审查、调试专家),自带全套企业级开发规范与自动化流程。
五大核心组件(开箱即用)
ECC 通过以下模块,系统性定义 AI 的行为规范:
- 🤖 专业代理 (Agents) - 47+ 专家角色将任务分给不同专家,各司其职,确保专业质量:
Planner (架构师):拆解需求、制定开发计划、设计技术方案。
Code-Reviewer (代码审查员):检查代码质量、Bug、规范、性能。
TDD-Guru (测试专家):强制测试驱动开发 (****TDD****),先写测试,后写代码。
Security-Scanner (安全专家):内置 AgentShield 102 条安全规则,扫描漏洞。
Debugger (调试专家):系统化定位、分析、修复 Bug。
语言 / 框架专家:Go/TS/Python/React/Flutter 等专属 Reviewer。
目录结构
everything-claude-code/
|-- .claude-plugin/ # 插件与应用商店清单
| |-- plugin.json # 插件元数据与组件路径
| |-- marketplace.json # 用于 /plugin marketplace add 的自托管应用商店目录
|
|-- agents/ # 36 个专用子智能体,用于任务委派
| |-- planner.md # 功能实现规划
| |-- architect.md # 系统架构设计决策
| |-- tdd-guide.md # 测试驱动开发
| |-- code-reviewer.md # 代码质量与安全审查
| |-- security-reviewer.md # 漏洞分析
| |-- build-error-resolver.md # 构建错误修复
| |-- e2e-runner.md # Playwright 端到端测试
| |-- refactor-cleaner.md # 无效代码清理
| |-- doc-updater.md # 文档同步更新
| |-- docs-lookup.md # 文档 / API 查阅
| |-- chief-of-staff.md # 沟通梳理与文稿起草
| |-- loop-operator.md # 自主循环执行
| |-- harness-optimizer.md # 执行框架配置调优
| |-- cpp-reviewer.md # C++ 代码审查
| |-- cpp-build-resolver.md # C++ 构建错误修复
| |-- go-reviewer.md # Go 代码审查
| |-- go-build-resolver.md # Go 构建错误修复
| |-- python-reviewer.md # Python 代码审查
| |-- database-reviewer.md # 数据库 / Supabase 审查
| |-- typescript-reviewer.md # TypeScript/JavaScript 代码审查
| |-- java-reviewer.md # Java/Spring Boot 代码审查
| |-- java-build-resolver.md # Java/Maven/Gradle 构建错误修复
| |-- kotlin-reviewer.md # Kotlin/Android/KMP 代码审查
| |-- kotlin-build-resolver.md # Kotlin/Gradle 构建错误修复
| |-- rust-reviewer.md # Rust 代码审查
| |-- rust-build-resolver.md # Rust 构建错误修复
| |-- pytorch-build-resolver.md # PyTorch/CUDA 训练错误修复
|
|-- skills/ # 工作流定义与领域知识库
| |-- coding-standards/ # 各语言最佳实践
| |-- clickhouse-io/ # ClickHouse 分析、查询与数据工程
| |-- backend-patterns/ # API、数据库、缓存设计模式
| |-- frontend-patterns/ # React、Next.js 开发模式
| |-- frontend-slides/ # HTML 幻灯片与 PPTX 转网页工作流(新增)
| |-- article-writing/ # 长文本写作,保留指定风格、避免通用 AI 腔调(新增)
| |-- content-engine/ # 多平台社交内容创作与复用工作流(新增)
| |-- market-research/ # 带来源引用的市场、竞品与投资方研究(新增)
| |-- investor-materials/ # 融资路演 PPT、单页摘要、备忘录与财务模型(新增)
| |-- investor-outreach/ # 定制化融资触达与跟进(新增)
| |-- continuous-learning/ # 从会话中自动提取模式(长文本指南)
| |-- continuous-learning-v2/ # 基于本能的学习,附带置信度评分
| |-- iterative-retrieval/ # 为子智能体渐进式优化上下文
| |-- strategic-compact/ # 手动上下文精简建议(长文本指南)
| |-- tdd-workflow/ # 测试驱动开发方法论
| |-- security-review/ # 安全检查清单
| |-- eval-harness/ # 验证循环评估(长文本指南)
| |-- verification-loop/ # 持续验证机制(长文本指南)
| |-- videodb/ # 音视频采集、检索、编辑、生成与推流(新增)
| |-- golang-patterns/ # Go 语言惯用写法与最佳实践
| |-- golang-testing/ # Go 测试模式、TDD 与基准测试
| |-- cpp-coding-standards/ # 遵循 C++ Core Guidelines 的编码规范(新增)
| |-- cpp-testing/ # 基于 GoogleTest、CMake/CTest 的 C++ 测试(新增)
| |-- django-patterns/ # Django 模式、模型与视图(新增)
| |-- django-security/ # Django 安全最佳实践(新增)
| |-- django-tdd/ # Django TDD 工作流(新增)
| |-- django-verification/ # Django 验证循环(新增)
| |-- laravel-patterns/ # Laravel 架构模式(新增)
| |-- laravel-security/ # Laravel 安全最佳实践(新增)
| |-- laravel-tdd/ # Laravel TDD 工作流(新增)
| |-- laravel-verification/ # Laravel 验证循环(新增)
| |-- python-patterns/ # Python 惯用写法与最佳实践(新增)
| |-- python-testing/ # 基于 pytest 的 Python 测试(新增)
| |-- springboot-patterns/ # Java Spring Boot 模式(新增)
| |-- springboot-security/ # Spring Boot 安全(新增)
| |-- springboot-tdd/ # Spring Boot TDD(新增)
| |-- springboot-verification/ # Spring Boot 验证(新增)
| |-- configure-ecc/ # 交互式安装向导(新增)
| |-- security-scan/ # 集成 AgentShield 安全审计(新增)
| |-- java-coding-standards/ # Java 编码规范(新增)
| |-- jpa-patterns/ # JPA/Hibernate 模式(新增)
| |-- postgres-patterns/ # PostgreSQL 优化模式(新增)
| |-- nutrient-document-processing/ # 基于 Nutrient API 的文档处理(新增)
| |-- docs/examples/project-guidelines-template.md # 项目专属技能模板
| |-- database-migrations/ # 数据库迁移模式(Prisma、Drizzle、Django、Go)(新增)
| |-- api-design/ # REST API 设计、分页、错误响应(新增)
| |-- deployment-patterns/ # CI/CD、Docker、健康检查、回滚(新增)
| |-- docker-patterns/ # Docker Compose、网络、数据卷、容器安全(新增)
| |-- e2e-testing/ # Playwright E2E 模式与页面对象模型(新增)
| |-- content-hash-cache-pattern/ # 用于文件处理的 SHA-256 内容哈希缓存(新增)
| |-- cost-aware-llm-pipeline/ # LLM 成本优化、模型路由、预算跟踪(新增)
| |-- regex-vs-llm-structured-text/ # 文本解析:正则与 LLM 选型决策框架(新增)
| |-- swift-actor-persistence/ # 基于 Actor 的 Swift 线程安全数据持久化(新增)
| |-- swift-protocol-di-testing/ # 基于协议的依赖注入,实现可测试 Swift 代码(新增)
| |-- search-first/ # 先调研再编码工作流(新增)
| |-- skill-stocktake/ # 技能与命令质量审计(新增)
| |-- liquid-glass-design/ # iOS 26 Liquid Glass 设计系统(新增)
| |-- foundation-models-on-device/ # 基于 Apple FoundationModels 的端侧大模型(新增)
| |-- swift-concurrency-6-2/ # Swift 6.2 简洁并发编程(新增)
| |-- perl-patterns/ # 现代 Perl 5.36+ 惯用写法与最佳实践(新增)
| |-- perl-security/ # Perl 安全模式、污点模式、安全 I/O(新增)
| |-- perl-testing/ # 基于 Test2::V0、prove、Devel::Cover 的 Perl TDD(新增)
| |-- autonomous-loops/ # 自主循环模式:顺序流水线、PR 循环、DAG 编排(新增)
| |-- plankton-code-quality/ # 基于 Plankton 钩子的实时代码质量管控(新增)
|
|-- commands/ # 传统斜杠命令兼容层;优先使用 skills/
| |-- tdd.md # /tdd - 测试驱动开发
| |-- plan.md # /plan - 实现规划
| |-- e2e.md # /e2e - 生成端到端测试
| |-- code-review.md # /code-review - 代码质量审查
| |-- build-fix.md # /build-fix - 修复构建错误
| |-- refactor-clean.md # /refactor-clean - 清理无效代码
| |-- learn.md # /learn - 会话中提取模式(长文本指南)
| |-- learn-eval.md # /learn-eval - 提取、评估并保存模式(新增)
| |-- checkpoint.md # /checkpoint - 保存验证状态(长文本指南)
| |-- verify.md # /verify - 运行验证循环(长文本指南)
| |-- setup-pm.md # /setup-pm - 配置包管理器
| |-- go-review.md # /go-review - Go 代码审查(新增)
| |-- go-test.md # /go-test - Go TDD 工作流(新增)
| |-- go-build.md # /go-build - 修复 Go 构建错误(新增)
| |-- skill-create.md # /skill-create - 从 Git 历史生成技能(新增)
| |-- instinct-status.md # /instinct-status - 查看已学习本能(新增)
| |-- instinct-import.md # /instinct-import - 导入本能(新增)
| |-- instinct-export.md # /instinct-export - 导出本能(新增)
| |-- evolve.md # /evolve - 将本能聚类为技能
| |-- prune.md # /prune - 删除过期待处理本能(新增)
| |-- pm2.md # /pm2 - PM2 服务生命周期管理(新增)
| |-- multi-plan.md # /multi-plan - 多智能体任务拆解(新增)
| |-- multi-execute.md # /multi-execute - 多智能体工作流编排(新增)
| |-- multi-backend.md # /multi-backend - 后端多服务编排(新增)
| |-- multi-frontend.md # /multi-frontend - 前端多服务编排(新增)
| |-- multi-workflow.md # /multi-workflow - 通用多服务工作流(新增)
| |-- orchestrate.md # /orchestrate - 多智能体协同调度
| |-- sessions.md # /sessions - 会话历史管理
| |-- eval.md # /eval - 按标准评估
| |-- test-coverage.md # /test-coverage - 测试覆盖率分析
| |-- update-docs.md # /update-docs - 更新文档
| |-- update-codemaps.md # /update-codemaps - 更新代码映射
| |-- python-review.md # /python-review - Python 代码审查(新增)
|
|-- rules/ # 必须遵守的规范(复制到 ~/.claude/rules/)
| |-- README.md # 结构概览与安装指南
| |-- common/ # 与语言无关的通用原则
| | |-- coding-style.md # 不可变性、文件组织规范
| | |-- git-workflow.md # 提交格式、PR 流程
| | |-- testing.md # TDD、80% 覆盖率要求
| | |-- performance.md # 模型选型、上下文管理
| | |-- patterns.md # 设计模式、项目骨架
| | |-- hooks.md # 钩子架构、TodoWrite
| | |-- agents.md # 子智能体委派时机
| | |-- security.md # 强制安全检查
| |-- typescript/ # TypeScript/JavaScript 专属规范
| |-- python/ # Python 专属规范
| |-- golang/ # Go 专属规范
| |-- swift/ # Swift 专属规范
| |-- php/ # PHP 专属规范(新增)
|
|-- hooks/ # 基于触发器的自动化逻辑
| |-- README.md # 钩子文档、使用示例与自定义指南
| |-- hooks.json # 全部钩子配置(PreToolUse、PostToolUse、Stop 等)
| |-- memory-persistence/ # 会话生命周期钩子(长文本指南)
| |-- strategic-compact/ # 上下文精简建议(长文本指南)
|
|-- scripts/ # 跨平台 Node.js 脚本(新增)
| |-- lib/ # 通用工具库
| | |-- utils.js # 跨平台文件 / 路径 / 系统工具
| | |-- package-manager.js # 包管理器检测与选择
| |-- hooks/ # 钩子实现
| | |-- session-start.js # 会话启动时加载上下文
| | |-- session-end.js # 会话结束时保存状态
| | |-- pre-compact.js # 上下文精简前状态保存
| | |-- suggest-compact.js # 策略性精简建议
| | |-- evaluate-session.js # 从会话中提取模式
| |-- setup-package-manager.js # 交互式包管理器设置
|
|-- tests/ # 测试套件(新增)
| |-- lib/ # 工具库测试
| |-- hooks/ # 钩子测试
| |-- run-all.js # 运行全部测试
|
|-- contexts/ # 动态注入的系统提示上下文(长文本指南)
| |-- dev.md # 开发模式上下文
| |-- review.md # 代码审查模式上下文
| |-- research.md # 研究 / 探索模式上下文
|
|-- examples/ # 配置与会话示例
| |-- CLAUDE.md # 项目级配置示例
| |-- user-CLAUDE.md # 用户级配置示例
| |-- saas-nextjs-CLAUDE.md # 真实 SaaS 项目(Next.js + Supabase + Stripe)
| |-- go-microservice-CLAUDE.md # 真实 Go 微服务(gRPC + PostgreSQL)
| |-- django-api-CLAUDE.md # 真实 Django REST API(DRF + Celery)
| |-- laravel-api-CLAUDE.md # 真实 Laravel API(PostgreSQL + Redis)(新增)
| |-- rust-api-CLAUDE.md # 真实 Rust API(Axum + SQLx + PostgreSQL)(新增)
|
|-- mcp-configs/ # MCP 服务端配置
| |-- mcp-servers.json # GitHub、Supabase、Vercel、Railway 等配置
|
|-- marketplace.json # 自托管应用商店配置(用于 /plugin marketplace add)
常用命令
claude code常用命令
Claude Code 命令分为 CLI 启动命令(终端输入)、会话内斜杠命令(/ 开头)、文件 / Shell 符号(@/!)和 快捷键 四类。
CLI 启动命令(终端直接运行)
claude # 启动交互式会话(当前目录)
claude "分析项目" # 带初始提示启动
claude -p "一句话提问" # 非交互、直接回答并退出
claude -c / --continue # 继续最近一次会话
claude --resume # 列出历史会话并选择恢复
claude --model sonnet # 指定模型(sonnet / opus / haiku)
claude --version # 查看版本
claude login # 登录认证
claude logout # 登出
会话内斜杠命令(最常用)
//1\. 上下文与会话(必记)
/help # 帮助、列出所有命令
/clear # 清空全部上下文(省Token、新任务)
/compact # 压缩历史(保留摘要、减少Token)
/context # 查看当前上下文/Token占用
/exit # 退出会话(同 Ctrl+D)
//2\. 模型与成本
/model # 切换模型(sonnet/opus/haiku)
/cost # 查看当前会话Token/费用
//3\. 文件与工作区
/init # 初始化 CLAUDE.md(项目文档)
/add-dir # 添加目录到工作区
/export # 导出对话到文件
//4\. 任务与模式
/plan # 进入规划模式(先分析再写代码)
/break # 中断当前任务
/redo # 重做上一步
/undo # 撤销上一步文件修改
/status # 查看状态(模型、版本、权限)
/doctor # 环境诊断
//5\. 其他常用
/copy # 复制最后一次回答
/rename 名称 # 给会话命名
/resume 名称 # 按名称恢复会话
//文件引用 & Shell 执行(开发必备)
//# 引用文件/目录(自动补全)
@src/index.ts
@src/components/
@*.tsx
//# 直接执行 Shell 命令(!前缀)
!git status
!npm install
!ls -la
!python test.py
//核心快捷键(效率神器)
Ctrl+C # 中断生成/取消
Ctrl+D # 退出
Esc # 停止生成(保留上下文)
Esc+Esc # 检查点/撤销(多文件修改救命)
Ctrl+R # 搜索历史
Ctrl+L # 清屏
Ctrl+G # 用外部编辑器写提示
Shift+Tab # 切换模式(普通/规划/自动)
极简高频清单(新手先记这 10 个)
-
claude→ 启动 -
/clear→ 新任务清上下文 -
/compact→ 长对话压缩 -
/model→ 切模型 -
/context→ 看 Token -
@文件→ 引用代码 -
!命令→ 执行 Shell -
Ctrl+C→ 中断 -
Esc+Esc→ 撤销修改 -
/exit→ 退出
技能安装
//安装 vercel-react-native-skills
//自动激活:RN 项目目录下自动启用
//核心能力
//React Native 最佳实践与代码规范
//跨平台(iOS/Android)适配指导
//原生模块集成方案
//性能优化建议
//常见坑点排查
npx skills add vercel-labs/agent-skills@vercel-react-native-skills -g
claude "帮我写一个 RN 底部标签导航,带两个页面"
claude "RN 中如何调用原生相册/相机权限?"
claude "优化我的 RN 列表渲染性能"
claude "Vercel 部署 RN 后端/服务端"
# React 最佳实践
npx skills add vercel-labs/agent-skills@vercel-react-best-practices -g
# Vercel 部署/边缘函数
npx skills add vercel-labs/agent-skills@vercel-deployment -g
claude skills list # 列出已安装的所有技能
claude skills list --all # 列出官方仓库里所有可安装的技能
claude skills list --global # 列出全局技能
claude skills enable vercel-react-native-skills
claude rules list # 列出当前项目所有生效规则
claude rules list --global # 列出全局规则
claude models list # 列出你可用的所有 Claude 模型
claude info # 查看当前版本、配置、模型、技能、规则总览
claude sessions list # 列出所有会话
claude history # 查看当前会话历史
claude config list # 查看当前所有配置项
部分模块介绍
在 Claude Code 中,Agents、Rules、Plugins、Skills 是四大核心扩展机制,分别负责专业分工、全局约束、能力打包、流程模板,共同构成了 AI 编程助手的可定制化体系。
1. Agents(智能体 / 专家)
定义:专注特定领域的专家级子助手,拥有独立的提示词、能力范围和工具集,负责端到端自主完成复杂目标。
本质:独立角色 + 专业领域 + 自主决策(如 “架构师”、“代码审查员”)
核心作用:复杂任务拆解与自主执行
文件结构:
agents/[name]/AGENT.md(含frontmatter声明能力)触发:自动调度(Claude 按需指派)或手动
/agent [name]-
示例:
markdown
--- description: 资深Go语言专家,负责代码审查与优化capabilities: ["code-review", "security-audit", "refactoring"] --- # Go 代码审查专家 专注Go语言最佳实践、并发安全、性能优化... 类比:公司里的部门专家(如安全工程师、测试主管)
2. Rules(规则 / 全局约束)
定义:全局静态提示词,以 CLAUDE.md 存在,始终注入系统上下文,强制 Claude 遵守项目规范。
本质:软约束、项目宪法、风格指南
核心作用:统一输出规范、减少重复指令
-
级别:
-
用户级:
~/.claude/CLAUDE.md(全局) -
项目级:
./.claude/CLAUDE.md(当前项目)
-
用户级:
内容:代码风格、提交规范、禁止行为、技术栈约束
类比:公司规章制度 / 项目手册
3. Plugins(插件 / 能力包)
定义:打包分发容器,将 agents/skills/commands/hooks/MCP 等能力封装为可安装、可共享、可版本化的单元Anthropic。
本质:能力集合 + 分发格式(非功能本身)
核心作用:跨项目 / 团队共享配置、一键安装扩展Anthropic
-
结构:
plaintext
my-plugin/ ├── .claude-plugin/ │ └── plugin.json # 清单(元数据、依赖、入口) ├── agents/ # 内置智能体 ├── skills/ # 内置技能 └── mcp/ # 内置工具服务器 管理:
/plugin install、/plugin enablecode.claude.com类比:IDE 插件 / App 安装包
4. Skills(技能 / 流程模板)
定义:结构化工作流 SOP,用 SKILL.md 定义 “遇到 X 场景,按 Y 步骤执行” 的可复用模板。
本质:操作手册、步骤清单、最佳实践封装
核心作用:标准化重复任务、提升效率与一致性
-
结构:
plaintext
skills/ └── react-native-debug/ ├── SKILL.md # 主流程(含 frontmatter) ├── reference.md # 可选参考 └── scripts/ # 可选辅助脚本
code.claude.com
-
触发:自动匹配(语义激活)或
/skill-name显式调用 - 类比:员工培训手册 / 标准作业程序
核心区别与关系(一目了然)
表格
| 维度 | Agents (智能体) | Rules (规则) | Plugins (插件) | Skills (技能) |
|---|---|---|---|---|
| 定位 | 独立专家 | 全局约束 | 能力容器 | 流程模板 |
| 粒度 | 目标 / 任务 | 全局 / 项目 | 打包 / 分发 | 步骤 / 操作 |
| 自主性 | 高(自主决策) | 无(静态提示) | 无(载体) | 中(按步骤执行) |
| 复用性 | 跨任务 | 全局 / 项目 | 跨项目 / 团队 | 跨场景 |
| 文件 | AGENT.md |
CLAUDE.md |
plugin.json |
SKILL.md |
| 关系 | 可调用 Skills | 约束所有 Agents | 可包含 Agents/Skills | 被 Agents / 用户调用 |
一句话总结
- Agents 是专家(负责复杂任务)
- Rules 是规矩(全局统一规范)
- Plugins 是安装包(分享整套能力)
- Skills 是说明书(标准化操作步骤)