Featured image of post 入门Claude Code之从安装到打造你的专属 AI 编程助手

入门Claude Code之从安装到打造你的专属 AI 编程助手

你可以打造出一个真正理解你的编码风格、遵守你的规范、适配你的工作流的 AI 编程搭档

本文基于 Claude Code v2.1.80,记录一套经过实战验证的配置方案,涵盖插件、技能、规则、命令的完整体系。

什么是 Claude Code

Claude Code 是 Anthropic 官方推出的 CLI 编程助手,直接在终端中与 Claude 交互,支持:

  • 读写文件、执行命令、搜索代码

  • LSP 代码智能(跳转定义、查找引用)

  • 浏览器自动化(Playwright)

  • 插件扩展、自定义技能和规则

  • Plan Mode 规划复杂任务

它不是一个简单的聊天工具,而是一个 可深度定制的 AI 编程代理

安装与基础配置

1
2
3
4
5
6
7
8
# 安装 Claude Code
curl -fsSL <https://claude.ai/install.sh> | sh

# 启动
claude

# 查看版本
claude --version

首次启动会引导你完成认证。之后所有配置都在~/.claude/目录下管理。

配置目录结构

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
~/.claude/
├── CLAUDE.md              # 全局用户配置(核心!)
├── settings.json          # 插件启用、模型选择、状态栏等
├── rules/                 # 规则文件(条件触发)
│   ├── claude-code-defensive.md
│   ├── bash-style.md
│   ├── file-size-limit.md
│   └── ...
├── skills/                # 技能目录(按需加载)
│   ├── go-dev/
│   ├── java-dev/
│   ├── frontend-dev/
│   └── ...
├── commands/              # 斜杠命令(/fix, /review 等)
│   ├── fix.md
│   ├── review.md
│   └── ...
├── plugins/               # 插件缓存和配置
├── templates/             # 项目模板
└── projects/              # 项目级配置

插件系统(Plugins)

插件是 Claude Code 的能力扩展核心。通过settings.json中的enabledPlugins管理。

官方插件

来源:anthropics/claude-plugins-official(官方插件市场)

安装方式:

1
2
3
# 在 Claude Code 中执行
/install-plugin <plugin-name>
# 或直接编辑 ~/.claude/settings.json 添加后重启
插件 说明 用途
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配置后安装

配置示例:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
// ~/.claude/settings.json
{
 "enabledPlugins": {
   "claude-hud@claude-hud": true
 },
 "statusLine": {
   "type": "command",
   "command": "node /path/to/claude-hud/dist/index.js"
 },
 "extraKnownMarketplaces": {
   "claude-hud": {
     "source": {
       "source": "github",
       "repo": "jarrodwatts/claude-hud"
     }
   }
 }
}

技能系统(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 文档

技能目录结构

1
2
3
4
5
~/.claude/skills/go-dev/
├── SKILL.md               # 技能主文件(必须)
└── references/            # 参考文档(可选)
   ├── go-style.md
   └── date-time.md

创建自定义技能

  1. ~/.claude/skills/下创建目录
  2. 编写SKILL.md,包含 frontmatter:
1
2
3
4
5
6
7
8
---
name: my-skill
description: 一句话描述,用于判断是否触发
version: v1.0
---

# 技能内容
...

也可以用/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文件即可:

1
2
3
4
5
6
7
8
---
description: 何时触发这条规则
globs: "**/*.go"        # 可选:仅匹配特定文件时加载
---

# 规则内容
- 必须做 xxx
- 禁止做 yyy

命令系统(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文件:

1
2
3
4
5
---
description: 命令描述
---

你的 prompt 内容,支持 $ARGUMENTS 接收参数

CLAUDE.md 核心配置

~/.claude/CLAUDE.md是全局指令文件, 优先级最高 ,所有对话都会加载。建议配置:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
# 个人身份
全栈开发者,技术栈:Go、Java、Vue + TypeScript

# 沟通风格
- 简洁优先,代码优先
- 技术术语保留英文,说明用中文

# 技术栈偏好
| 场景 | 首选 |
|------|------|
| Go 后端 | Gin + GORM |
| Java 后端 | Spring Boot |
| 前端 | Vue 3 + TS + Element Plus |

# 核心约束
- 禁止过度重构已工作的代码
- 禁止添加未要求的功能
- 禁止修改测试来匹配错误代码

# 决策原则
简单方案 > 复杂方案
复用现有 > 创建新的

此外,每个项目根目录也可以放一个CLAUDE.md作为项目级配置。

实战工作流示例

1. 新建一个 Go 项目

1
2
3
4
5
> /project-scan
# Claude 自动识别技术栈,生成 CLAUDE.md、.gitignore、Dockerfile、restart.sh

> /new-feature 用户登录接口
# 进入需求审问 → 设计 → 实现全流程

2. 修 Bug

1
2
> /fix debug 用户列表接口返回 500
# 系统化调试:复现 → 假设 → 验证 → 最小修复

3. 代码审查

1
2
> /review full
# 完整代码审查,覆盖逻辑、安全、性能

4. 提交代码

1
2
> /commit-msg
# 自动分析 diff,生成结构化 commit message

总结

Claude Code 的强大之处在于 高度可定制 。通过合理组合,你可以打造出一个真正理解你的编码风格、遵守你的规范、适配你的工作流的 AI 编程搭档。

层级 作用 特点
CLAUDE.md 身份 + 偏好 + 约束 每次对话都加载
Rules 行为护栏 轻量,条件触发
Skills 领域知识 丰富,含参考文档
Commands 工作流快捷入口 用户主动调用
Plugins 能力扩展 LSP、浏览器、文档查询

📎 参考文章