Claude Code 深度教程：从 CLI 命令到自定义 Skills 工作流

1
2
3
4
5
6
7
8

# macOS
brew install claude-code

# 或用 npm
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

1
2
3
4
5

# 方式一：用 Anthropic API Key（按量付费）
export ANTHROPIC_API_KEY=sk-ant-xxx

# 方式二：订阅 Claude Pro/Max（含额度）
claude login

1
2
3
4
5
6
7
8

{
  "permissions": {
    "allow": ["Read", "Write", "Edit", "Bash(git *)", "Bash(go *)", "Bash(make *)"],
    "deny": ["Bash(rm -rf /)", "Bash(:(){:|:&};:)"]
  },
  "model": "claude-3-5-sonnet-20241022",
  "max_uses": 50
}

1
2
3
4
5
6
7
8
9

# 在项目目录下启动
cd my-project
claude

# 启动时直接带任务
claude "给这个服务加一个健康检查接口"

# 用特定模型启动
claude --model opus "重构这个复杂函数"

1
2

# 在 Go 项目里
claude "给 resume-service 加一个健康检查接口 /health，返回服务状态、版本、数据库连接状态"

1
2
3
4
5
6
7
8

# 让 Claude 先理解项目结构
"先看一下这个项目的整体结构，主要有哪些服务，用了什么框架和中间件"

# 关注特定模块
"重点看一下 resume-service 的架构，handler/service/repository 分层是怎么设计的"

# 引用特定文件
"参考 @/internal/handler/resume.go 的风格，给 job-service 加类似的接口"

1
2
3
4
5
6
7
8

"把 resume-service 的 CreateResume 接口从同步改成异步：
1. 接口接收请求后立即返回任务ID
2. 实际处理放到后台 goroutine
3. 加一个查询任务状态的接口 /resume/task/{id}
4. 任务状态存在 Redis 里
5. 加单测覆盖正常和异常场景

先看一下现有代码，然后告诉我你的实现方案，确认后再改"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 贴报错日志
"这个服务启动报错了，帮我看看是什么问题：
[贴报错日志]
"

# 或者让它自己跑
"运行 make test，看看有什么测试失败，帮我修复"

# 复杂问题
"这个接口 P99 延迟突然从 50ms 升到 500ms，帮我排查一下。
先看最近的 git log 有什么变更，再看代码可能的性能瓶颈"

1
2
3
4
5
6
7

"审查一下最近3次 commit 的代码变更，重点看：
1. 有没有安全问题（SQL注入、XSS、权限绕过）
2. 有没有性能问题（N+1查询、内存泄漏、锁竞争）
3. 有没有不符合项目规范的地方
4. 错误处理是否完善

按严重程度排序，给出具体的修改建议"

1
2
3
4
5
6
7
8

"给 resume-service 的 service 层加单元测试，要求：
1. 覆盖所有公开方法
2. 正常场景和异常场景都要覆盖
3. 用 mock 模拟 repository 层，不要连真实数据库
4. 用 testify 断言库
5. 测试覆盖率达到 80% 以上

先看一下现有代码和已有的测试风格，再开始写"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

# .claude/skills/api-development/SKILL.md
---
name: api-development
description: 开发新 API 接口的标准流程，包含接口定义、参数校验、业务逻辑、错误处理、单测
---

# API 开发标准流程

当用户要求开发新 API 接口时，按以下流程执行：

## 1. 理解需求
- 确认接口的功能、输入、输出
- 确认权限要求（是否需要登录、角色权限）
- 确认是否有类似的现有接口可以参考

## 2. 查看现有代码
- 查看同模块的 handler 代码风格
- 查看路由注册方式
- 查看 service 层和 repository 层的模式
- 查看错误处理和参数校验的方式

## 3. 实现接口
按以下顺序实现：
1. **参数定义**：在 types 包定义请求和响应结构体，加 validate tag
2. **Handler**：参数校验、调用 service、格式化响应
3. **Service**：业务逻辑、事务管理、缓存操作
4. **Repository**：数据库操作
5. **路由注册**：在 router 里注册接口

## 4. 错误处理
- 参数错误返回 400，code=1
- 未登录返回 401，code=2
- 无权限返回 403，code=3
- 资源不存在返回 404，code=4
- 服务器错误返回 500，code=500

## 5. 单测
- Handler 层：用 httptest 测试，mock service
- Service 层：mock repository，覆盖正常和异常场景
- 覆盖率要求 80% 以上

## 6. 验证
- 运行 `go build ./...` 确认编译通过
- 运行 `go test ./...` 确认测试通过
- 运行 `go vet ./...` 确认没有静态检查问题

## 注意事项
- 遵循现有代码风格，不要引入新的依赖
- 敏感操作（删除、修改）要加权限校验
- 数据库操作用事务保证一致性
- 不要硬编码，配置放 config

1

"用 api-development skill 给 job-service 加一个批量更新职位状态的接口"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

{
  "mcpServers": {
    "recruitment": {
      "url": "https://mcp.example.com/sse",
      "headers": {
        "X-API-Key": "your-key"
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxx"
      }
    }
  }
}

1

"查看一下我最近的 PR，找出有 review 意见但还没修改的，帮我逐个处理"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

# CLAUDE.md

## 项目概述
这是最佳东方招聘平台的后端微服务，用 Go + Gin + GORM 开发，部署在 K8s 上。

## 技术栈
- 语言：Go 1.22
- Web 框架：Gin
- ORM：GORM
- 数据库：MySQL 8.0
- 缓存：Redis 7
- 消息队列：RabbitMQ
- 服务发现：etcd
- 部署：K8s + ArgoCD

## 代码规范
- 分层架构：handler → service → repository
- 错误处理：用自定义 error，统一返回格式 {code, message, data}
- 参数校验：用 go-playground/validator
- 日志：用 zap，结构化日志
- 测试：用 testify，mock 用 mockery

## 常用命令
- 构建：make build
- 测试：make test
- 运行：make run
- 代码生成：make gen（mock、swagger）

## 注意事项
- 不要直接修改 main 分支，新建分支开发
- 数据库迁移用 golang-migrate，不要手动改表
- 敏感配置不要硬编码，从环境变量读
- 提交前跑 make lint 和 make test

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 不好的方式
"把这个服务从 PHP 重写成 Go"

# 好的方式
"我们要把 apply-service 从 PHP 重写成 Go，分几步来：
第一步：先看一下 PHP 版的代码结构和业务逻辑，给我一个迁移方案
第二步：搭建 Go 项目骨架（目录结构、依赖、配置、启动脚本）
第三步：实现数据模型和 repository 层
第四步：实现 service 层
第五步：实现 handler 层和路由
第六步：加单测
第七步：写迁移文档和回滚方案

先做第一步，给我迁移方案，确认后再开始第二步"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

我：用 api-development skill 加一个批量导出简历的接口，支持按条件筛选，导出 Excel，异步生成，完成后发通知。

Claude：（读取项目结构，理解现有代码）
好的，我理解需求了。这个接口涉及异步任务和文件生成，我的实现方案：
1. 接口 POST /resume/export，接收筛选条件，立即返回任务ID
2. 后台 goroutine 执行：查询数据 → 生成 Excel → 上传 OSS → 更新任务状态 → 发通知
3. 查询任务状态接口 GET /resume/export/{task_id}
4. 任务状态存在 Redis，任务记录存在 MySQL
5. Excel 生成用 excelize 库
6. 加单测覆盖

你看这个方案可以吗？

我：可以，开始实现。

Claude：（开始编辑文件，加 types、handler、service、repository、路由）
（运行 go build，编译通过）
（运行 go test，测试通过）
（运行 go vet，没有问题）

完成了，新增/修改了以下文件：
- internal/types/export.go（请求/响应类型）
- internal/handler/export.go（handler）
- internal/service/export.go（异步任务逻辑）
- internal/repository/export_task.go（任务持久化）
- internal/router/router.go（注册路由）
- internal/service/export_test.go（单测）

接口已经可以用了，你可以用 curl 测试一下：
curl -X POST http://localhost:8080/resume/export \
  -H "Content-Type: application/json" \
  -d '{"keyword":"Go开发","city":"杭州"}'