# claude-code-guide **Repository Path**: jasonfjs/claude-code-guide ## Basic Information - **Project Name**: claude-code-guide - **Description**: Claude Code 团队使用技巧知识库 - 基于 Claude Code 创始人 Boris 分享的 10 大使用技巧 - **Primary Language**: HTML - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-03-11 - **Last Updated**: 2026-03-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
基于 Claude Code 创始人 Boris 分享的 10 大使用技巧
>
来源: Datawhale 翻译整理
适用: Claude Code、OpenClaw、OpenCode 等 AI 编程工具
---
---
Boris 说: "团队里每个人用 Claude Code 的方式都不一样,没有所谓「唯一正确」的用法,关键是自己去试,找到适合自己的节奏。"
| 理念 | 说明 |
| 并行第一 | 同时运行多个会话,效率翻倍 |
| 多端协作 | 终端 + 网页端 + Claude 并行 |
| 自动化审批 | 让 AI 自己处理安全检查 |
| 语音加速 | 语速是打字的 3 倍 |
---
团队排名第一的提效技巧
同时开多个 git worktree,每个 worktree 跑一个独立的 Claude Code session,并行干活。
``bash
git worktree add -b feature/login ../login-feature
git worktree add -b feature/payment ../payment-feature
git worktree add -b feature/notification ../notification-feature
cd ../login-feature && claude-code
cd ../payment-feature && claude-code
cd ../notification-feature && claode-code
`
效果
- 3-5 个任务同时进行
- 互不干扰,各自独立
- 充分利用多核 CPU
适用场景
`
✓ 大项目多模块同时开发
✓ 需要同时修复多个 bug
✓ 功能开发 + 代码重构并行
✓ 紧急 hotfix + 常规开发并行
`
---
2. 多终端协作
本地终端 + 系统通知
操作方法
`bash
1. 打开多个终端标签页
标签页按 1-5 编号
2. 每个标签页运行一个 Claude 实例
标签页 1: 主开发任务
标签页 2: 代码审查
标签页 3: 测试
标签页 4: 重构
标签页 5: 文档
3. 配置系统通知
macOS: 系统偏好设置 → 通知 → 终端
Linux: 配置 libnotify
Windows: 配置 Toast 通知
`
通知触发条件
`
✓ Claude 需要人工输入时
✓ 任务完成时
✓ 遇到错误需要处理时
✓ 长时间运行任务结束时
`
推荐工具
`bash
tmux 增强终端管理
tmux new -s dev1
tmux new -s dev2
tmux new -s dev3
或使用 Alacritty/iTerm2 的分组功能
`
---
3. 网页端并行会话
5-10 个网页会话同时运行
工作流
`
终端写代码 ←→ 推送会话到网页端 ←→ Chrome 新会话
┌─────────────────────────────────────┐
│ 本地终端 (Claude Code) │
│ • 写代码 │
│ • 执行命令 │
│ • git 操作 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 网页端 Claude │
│ • 复杂分析 │
│ • 长文档处理 │
│ • 并行思考 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ Chrome 新会话 │
│ • 独立任务 │
│ • 头脑风暴 │
│ • 快速问答 │
└─────────────────────────────────────┘
`
协作方式
`bash
1. 将会话推送到网页端
本地终端中使用功能键或快捷键
2. 直接在 Chrome 开新会话
浏览器访问 claude.ai
3. 有时还会...
- 从网页端拉取结果到本地
- 跨会话共享上下文
- 用不同会话处理不同类型的任务
`
---
4. 子代理 (Subagents)
专业化分工,让 AI 各司其职
什么是子代理?
子代理是专门的 AI 代理,专注于特定任务类型。
10 个即用模板
4.1 代码重构代理
适用场景: 历史遗留代码、臃肿的组件、难看的服务
`markdown
You are a Code Refactoring Sub-Agent.
Rules:
- Do NOT change business logic
- Improve code structure and readability
- Follow SOLID principles
- Add appropriate comments
- Keep functions small and focused
Workflow:
- Analyze the current code
- Identify code smells
- Create refactoring plan
- Execute refactoring step by step
- Verify no logic changes
- Run tests to ensure correctness
`
4.2 Bug 修复代理
`markdown
You are a Bug Fixing Sub-Agent.
Focus:
- Reproduce the bug
- Identify root cause
- Fix with minimal changes
- Add regression tests
- Update documentation
Priority:
- Security bugs
- Data corruption bugs
- Crash bugs
- Logic errors
- UI/UX issues
`
4.3 代码审查代理
`markdown
You are a Code Review Sub-Agent.
Checklist:
- [ ] Code style compliance
- [ ] Security vulnerabilities
- [ ] Performance issues
- [ ] Error handling
- [ ] Test coverage
- [ ] Documentation
- [ ] Edge cases
- [ ] Race conditions
Output format:
- Summary
- Critical issues
- Suggestions
- Approval/Rejection
`
4.4 测试编写代理
`markdown
You are a Test Writing Sub-Agent.
Coverage targets:
- Unit tests: 80%+
- Integration tests: 50%+
- E2E tests: Critical paths
Test types:
- Unit tests
- Mock dependencies
- Edge cases
- Error scenarios
`
4.5 文档生成代理
`markdown
You are a Documentation Sub-Agent.
Output:
- API documentation
- README updates
- Code comments
- Architecture diagrams
- Usage examples
`
4.6 性能优化代理
`markdown
You are a Performance Optimization Sub-Agent.
Areas:
- CPU usage
- Memory usage
- I/O operations
- Network requests
- Database queries
- Rendering performance
Tools:
- Profilers
- Benchmarking
- Tracing
- Logging
`
4.7 安全审计代理
`markdown
You are a Security Audit Sub-Agent.
Check:
- OWASP Top 10
- Authentication/Authorization
- Data encryption
- Input validation
- SQL injection
- XSS/CSRF
- Sensitive data exposure
`
4.8 迁移助手代理
`markdown
You are a Migration Assistant Sub-Agent.
Migration types:
- Framework upgrade
- Library update
- Database migration
- Cloud migration
- Language version upgrade
Steps:
- Assessment
- Planning
- Incremental migration
- Testing
- Rollback plan
`
4.9 API 设计代理
`markdown
You are an API Design Sub-Agent.
Consider:
- RESTful principles
- GraphQL schemas
- gRPC contracts
- Versioning
- Authentication
- Rate limiting
- Error responses
`
4.10 部署代理
`markdown
You are a Deployment Sub-Agent.
Checks:
- Environment variables
- Secrets management
- Health checks
- Rollback strategy
- Monitoring setup
- CI/CD pipeline
- Container configuration
`
---
5. 权限审批自动化
Hook + AI 自动审批安全请求
架构
`
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ 权限请求 │────▶│ Hook 路由 │────▶│ Opus 4.5 │
│ (Claude) │ │ (自动分发) │ │ (安全扫描) │
└──────────────┘ └──────────────┘ └──────────────┘
│
┌───────────────────────┘
▼
┌──────────────┐
│ 自动批准 │
│ 或人工审批 │
└──────────────┘
`
配置方法
`bash
1. 配置权限请求 Hook
创建 .claude/hooks/permission-request
2. 设置路由规则
将请求路由给 Opus 4.5 进行安全扫描
3. 自动审批逻辑
- 安全请求 → 自动批准
- 可疑请求 → 人工审批
- 危险请求 → 拒绝
`
安全扫描项
`
✓ 文件系统访问
✓ 网络请求
✓ 环境变量读取
✓ 命令执行
✓ 代码修改
✓ 密钥/令牌使用
`
---
6. 数据分析
调用 CLI 工具,即时分析指标
BigQuery 示例
`bash
1. 创建 BigQuery 技能
文件: skills/bq/skill.json
{
"name": "bq-query",
"description": "Execute BigQuery queries",
"commands": [
"bq query"
],
"examples": [
"bq query 'SELECT * FROM dataset.table LIMIT 10'"
]
}
2. 使用示例
$ claude-code
使用 bq 查询今天活跃用户数
bq query "SELECT COUNT(DISTINCT user_id) as active_users FROM events WHERE DATE(created_at) = CURRENT_DATE()"
3. 分析结果
今天是 15,847 个活跃用户,比昨天增长 12.3%
`
其他数据分析工具
`bash
PostgreSQL
psql -c "SELECT COUNT(*) FROM users"
Prometheus
promql up
Grafana API
curl http://localhost:3000/api/datasources
AWS CloudWatch
aws cloudwatch get-metric-statistics
自定义脚本
./analyze.sh
`
---
7. 终端管理优化
颜色编码 + tmux + 标签页管理
颜色编码方案
`bash
为不同类型的会话设置不同颜色
🔴 红色: 生产环境/危险操作
🟡 黄色: 测试环境
🟢 绿色: 开发环境
🔵 蓝色: 数据分析
🟣 紫色: 代码审查
`
tmux 配置
`bash
~/.tmux.conf
开启鼠标支持
set -g mouse on
快速切换窗口
bind -n M-1 select-window -t 1
bind -n M-2 select-window -t 2
bind -n M-3 select-window -t 3
bind -n M-4 select-window -t 4
bind -n M-5 select-window -t 5
颜色主题
set -g status-bg colour235
set -g status-fg colour246
窗口名称
set-window-option -g automatic-rename on
`
标签页命名规范
`
[DEV] feature/login # 开发任务
[REV] code-review # 代码审查
[TEST] api-testing # 测试任务
[DBG] bug-fix-1234 # Bug 修复
[DOC] update-readme # 文档更新
`
---
8. 语音输入
语速是打字的 3 倍
macOS 配置
`bash
1. 打开语音输入
系统偏好设置 → 键盘 → 语音
2. 快捷键
按两下 fn 键启动语音输入
3. 优化建议
- 使用清晰的语句
- 适当停顿
- 练习口语化表达
`
效果对比
输入方式 速度 准确率 适用场景
键盘打字 40 WPM 99% 精确代码
语音输入 120 WPM 95% 自然语言提示
混合模式 60-80 WPM 97% 日常使用
语音提示技巧
`bash
❌ 不好的方式
"帮我写一个函数计算斐波那契数列"
✅ 好的方式
"写一个递归函数计算斐波那契数列第N项,使用记忆化优化避免重复计算,函数接受整数参数N,返回第N个斐波那契数,添加类型注解和错误处理"
`
---
9. 自定义命令
常用操作一键执行
内置命令
`bash
/commit # 提交代码
/commit-push-pr # 提交 + 推送 + 创建 PR
/code-review # 代码审查
/test # 运行测试
/deploy # 部署到生产环境
/rollback # 回滚
/status # 查看状态
`
自定义命令模板
部署命令 (.claude/commands/deploy.md)
`markdown
部署到生产环境:
- 运行测试
- 构建 Docker 镜像
- 推送到 registry
- 更新 k8s 配置
- 验证部署成功
`
代码审查命令 (.claude/commands/code-review.md)
`markdown
执行代码审查:
- 检查未提交的更改
- 运行 linter
- 检查安全漏洞
- 评估代码质量
- 生成审查报告
`
快速测试命令 (.claude/commands/test.md)
`markdown
运行测试:
- 运行单元测试
- 运行集成测试
- 检查测试覆盖率
- 生成测试报告
`
创建自定义命令
`bash
1. 创建命令文件
mkdir -p .claude/commands
touch .claude/commands/mycommand.md
2. 编写命令内容
使用 Markdown 格式
Claude 会读取并执行
3. 使用命令
$ claude-code
/mycommand
`
---
10. Claude Code 2.1 更新
史上最大更新,一次性 1096 次提交
主要改进
改进项 说明
性能提升 响应速度加快 50%
稳定性 减少崩溃和错误
上下文窗口 支持更长的上下文
新功能 多个新特性
工具增强 更强大的工具调用能力
更新内容
`
✓ 1096 次代码提交
✓ 多个重大功能更新
✓ 性能优化
✓ Bug 修复
✓ 安全性增强
`
---
常用命令速查
基础命令
`bash
启动 Claude Code
claude-code
指定项目目录
claude-code /path/to/project
使用特定模型
claude-code --model claude-sonnet-4
查看帮助
claude-code --help
`
Git 集成
`bash
/commit # 提交
/commit-push-pr # 提交+推送+PR
/code-review # 审查变更
/diff # 查看差异
/log # 查看提交历史
/branch # 管理分支
`
项目操作
`bash
/test # 运行测试
/build # 构建项目
/lint # 代码检查
/format # 格式化代码
/deploy # 部署
/rollback # 回滚
`
调试命令
`bash
/debug # 调试模式启动
/profile # 性能分析
/trace # 追踪执行
/monitor # 监控资源使用
`
---
实践模板库
模板 1: 新功能开发流程
`markdown
新功能开发模板
1. 需求理解
- 理解功能需求
- 识别边界条件
- 确定验收标准
2. 技术设计
- 设计 API 接口
- 设计数据结构
- 确定技术方案
3. 实现
- 编写代码
- 编写测试
- 代码审查
4. 验证
- 手动测试
- 自动化测试
- 性能测试
`
模板 2: Bug 修复流程
`markdown
Bug 修复模板
1. 重现
- 描述问题
- 复现步骤
- 环境信息
2. 诊断
- 查看日志
- 定位代码
- 分析原因
3. 修复
- 修复代码
- 添加测试
- 更新文档
4. 验证
- 验证修复
- 回归测试
- 上线验证
`
模板 3: 代码审查清单
`markdown
代码审查清单
代码质量
- [ ] 代码风格一致
- [ ] 命名清晰
- [ ] 函数短小
- [ ] 避免重复
功能正确
- [ ] 逻辑正确
- [ ] 边界处理
- [ ] 错误处理
- [ ] 并发安全
性能
- [ ] 无内存泄漏
- [ ] 无性能瓶颈
- [ ] 资源释放
安全
- [ ] 无注入风险
- [ ] 敏感数据保护
- [ ] 权限检查
测试
- [ ] 测试覆盖
- [ ] 测试可读
- [ ] 测试独立
`
---
附录
推荐阅读
工具推荐
工具 用途
tmux 终端复用
iTerm2 macOS 终端
Alacritty 快速终端
Neovim 高效编辑器
VS Code IDE
快捷键速查
`bash
tmux
Ctrl+b % # 垂直分割
Ctrl+b " # 水平分割
Ctrl+b 数字 # 切换窗口
Ctrl+b d # 脱离会话
Claude Code
Ctrl+c # 中断任务
Ctrl+l # 清屏
Ctrl+r # 历史搜索
`
---
更新日志
日期 更新内容
2026-02-04 初始版本,完成核心内容整理
``