本文基于 Claude Code v2.1.80,记录一套经过实战验证的配置方案,涵盖插件、技能、规则、命令的完整体系。
什么是 Claude Code
Claude Code 是 Anthropic 官方推出的 CLI 编程助手,直接在终端中与 Claude 交互,支持:
-
读写文件、执行命令、搜索代码
-
LSP 代码智能(跳转定义、查找引用)
-
浏览器自动化(Playwright)
-
插件扩展、自定义技能和规则
-
Plan Mode 规划复杂任务
它不是一个简单的聊天工具,而是一个 可深度定制的 AI 编程代理 。
安装与基础配置
|
|
首次启动会引导你完成认证。之后所有配置都在~/.claude/目录下管理。
配置目录结构
|
|
插件系统(Plugins)
插件是 Claude Code 的能力扩展核心。通过settings.json中的enabledPlugins管理。
官方插件
来源:anthropics/claude-plugins-official(官方插件市场)
安装方式:
|
|
| 插件 | 说明 | 用途 |
|---|---|---|
| context7 | 实时文档查询 | 查询任意库/框架的最新文档和代码示例,不再依赖训练数据 |
| frontend-design | 前端设计生成 | 生成高质量、有辨识度的前端界面代码,避免"AI 感"的通用样式 |
| playwright | 浏览器自动化 | 控制浏览器进行页面截图、表单填写、E2E 测试等 |
| superpowers | 工作流增强 | 提供 brainstorming、TDD、debugging、plan 等结构化工作流技能 |
| skill-creator | 技能创建工具 | 创建、修改、测试自定义技能 |
| security-guidance | 安全指导 | 提供安全编码建议和漏洞检测指导 |
| gopls-lsp | Go 语言服务 | 为 Go 代码提供跳转定义、查找引用、hover 信息等 LSP 能力 |
| jdtls-lsp | Java 语言服务 | 为 Java 代码提供 LSP 代码智能 |
| typescript-lsp | TypeScript 语言服务 | 为 TS/JS 代码提供 LSP 代码智能 |
| pyright-lsp | Python 语言服务 | 为 Python 代码提供类型检查和 LSP 能力 |
社区插件
| 插件 | GitHub | 说明 | 安装方式 |
|---|---|---|---|
| claude-hud | jarrodwatts/claude-hud | 终端状态栏 HUD,实时显示 token 用量、模型信息、会话状态等 | 在settings.json中添加extraKnownMarketplaces配置后安装 |
配置示例:
|
|
技能系统(Skills)
技能是比规则更丰富的知识模块,包含完整的编码规范、参考文档和上下文指导。存放在~/.claude/skills/下,每个技能一个目录。
自定义技能列表
| 技能 | 说明 | 触发场景 |
|---|---|---|
| go-dev | Go 开发规范 v3.0 | 编写 Go 代码时自动触发,含命名约定、错误处理、并发编程、测试规范 |
| java-dev | Java 开发规范 v3.0 | 编写 Java 代码时触发,含 Spring Boot 最佳实践、命名约定、异常处理 |
| frontend-dev | 前端开发规范 v3.0 | Vue 3 + TypeScript 开发时触发,含 UI 风格约束、组件规范 |
| python-dev | Python 开发规范 v3.0 | Python 开发时触发,含 PEP 8 风格、类型注解、测试规范 |
| bash-style | Bash 编写规范 | 操作 .sh/Dockerfile/Makefile/YAML 文件时触发 |
| ops-safety | 运维安全规范 | 执行 sysctl/iptables/systemctl/Docker 等系统级命令时触发 |
| ui-ux-pro-max | 专业 UI/UX 设计规范 v1.0 | 需要高质量前端界面设计时触发,覆盖视觉层次、配色、排版、微动效 |
| size-check | 代码质量与大小检查 | 代码审查时触发,检查复用性、效率和文件大小限制 |
| ruanzhu | 软著源代码文档生成 v1.3 | 执行/ruanzhu时触发,生成软件著作权申请用的 DOCX 文档 |
技能目录结构
|
|
创建自定义技能
- 在
~/.claude/skills/下创建目录 - 编写
SKILL.md,包含 frontmatter:
|
|
也可以用/skill-creator插件辅助创建和测试
Superpowers 内置技能
Superpowers 插件(anthropics/claude-plugins-official)提供了一系列高级工作流技能:
| 技能 | 说明 |
|---|---|
brainstorming |
创意探索 — 实现功能前先探索意图、需求和设计 |
writing-plans |
编写实现计划 — 多步骤任务的结构化规划 |
executing-plans |
执行计划 — 带 review checkpoint 的计划执行 |
test-driven-development |
TDD 工作流 — 先写测试再实现 |
systematic-debugging |
系统化调试 — 遇到 bug 时的结构化排查流程 |
verification-before-completion |
完成前验证 — 提交前确认一切正常 |
subagent-driven-development |
子代理并行开发 — 独立任务并行执行 |
dispatching-parallel-agents |
并行代理调度 — 2+ 独立任务同时处理 |
requesting-code-review |
请求代码审查 — 完成功能后自动 review |
receiving-code-review |
接收代码审查 — 处理 review 反馈 |
finishing-a-development-branch |
完成开发分支 — 引导 merge/PR/cleanup 流程 |
using-git-worktrees |
Git Worktree 隔离开发 |
规则系统(Rules)
规则是轻量级的行为约束,存放在~/.claude/rules/下。可以配置paths条件按需加载。
| 规则 | 说明 |
|---|---|
| claude-code-defensive | 防御性编码核心规则 — 预防 AI 常见陷阱(禁止修改测试适配错误代码、禁止过度工程化) |
| bash-style | Bash 核心规范 — shell 脚本编写风格(禁止行尾注释等) |
| file-size-limit | 文件行数限制 — Java 300 行、Go 400 行、Vue/TSX 200 行 |
| date-calc | 日期计算规则 — 统一"日期 + N 月保持日不变"的逻辑 |
| doc-sync | 文档同步 — 配置/结构变更时更新相关文档 |
| ops-safety | 运维安全 — 系统级命令需说明影响范围、风险等级、回滚方案 |
| redis-safety | Redis 安全 — 禁用 KEYS/FLUSHDB,所有 key 必须设置 TTL |
创建自定义规则
在~/.claude/rules/下新建.md文件即可:
|
|
命令系统(Commands)
命令是用户可直接调用的斜杠指令,存放在~/.claude/commands/下。使用方式:在 Claude Code 中输入/命令名。
| 命令 | 说明 | 用法 |
|---|---|---|
/fix |
问题修复 | /fix快速修复 or/fix debug系统化调试 |
/review |
代码审查 | /review full、/review quick、/review security三种模式 |
/commit-msg |
生成 Commit Message | 分析未提交变更,生成结构化 commit message |
/new-feature |
新功能全流程 | 需求审问 → 设计 → 实现,支持中断恢复 |
/requirement |
需求分析 | /requirement doc文档框架 or/requirement interrogate极刑审问 |
/design |
技术设计 | /design doc文档框架 or/design checklist质量检查 |
/project-init |
项目初始化 | 为新项目生成CLAUDE.md配置 |
/project-scan |
项目扫描 | 自动识别技术栈,生成全套配置(CLAUDE.md/restart.sh/.gitignore/Docker) |
/status |
配置状态 | 显示当前加载的配置,帮助诊断问题 |
/style-extract |
样式提取 | 从 Vue 组件或设计图提取样式规范 |
/ruanzhu |
软著文档生成 | 生成软件著作权申请用的源代码 DOCX |
/check-toolsearch |
检查 WebSearch | 验证 ToolSearch 工具是否可用 |
创建自定义命令
在~/.claude/commands/下新建.md文件:
|
|
CLAUDE.md 核心配置
~/.claude/CLAUDE.md是全局指令文件, 优先级最高 ,所有对话都会加载。建议配置:
|
|
此外,每个项目根目录也可以放一个CLAUDE.md作为项目级配置。
实战工作流示例
1. 新建一个 Go 项目
|
|
2. 修 Bug
|
|
3. 代码审查
|
|
4. 提交代码
|
|
总结
Claude Code 的强大之处在于 高度可定制 。通过合理组合,你可以打造出一个真正理解你的编码风格、遵守你的规范、适配你的工作流的 AI 编程搭档。
| 层级 | 作用 | 特点 |
|---|---|---|
| CLAUDE.md | 身份 + 偏好 + 约束 | 每次对话都加载 |
| Rules | 行为护栏 | 轻量,条件触发 |
| Skills | 领域知识 | 丰富,含参考文档 |
| Commands | 工作流快捷入口 | 用户主动调用 |
| Plugins | 能力扩展 | LSP、浏览器、文档查询 |