# 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 团队使用技巧知识库

Claude Code 团队使用技巧知识库

基于 Claude Code 创始人 Boris 分享的 10 大使用技巧

>

来源: Datawhale 翻译整理
适用: Claude Code、OpenClaw、OpenCode 等 AI 编程工具

---

📋 目录

---

核心原则

Boris 说: "团队里每个人用 Claude Code 的方式都不一样,没有所谓「唯一正确」的用法,关键是自己去试,找到适合自己的节奏。"

🎯 核心理念

理念说明
并行第一同时运行多个会话,效率翻倍
多端协作终端 + 网页端 + Claude 并行
自动化审批让 AI 自己处理安全检查
语音加速语速是打字的 3 倍

---

1. 并行开发技巧

团队排名第一的提效技巧

原理

同时开多个 git worktree,每个 worktree 跑一个独立的 Claude Code session,并行干活。

操作步骤

``bash

1. 创建多个 worktree

git worktree add -b feature/login ../login-feature

git worktree add -b feature/payment ../payment-feature

git worktree add -b feature/notification ../notification-feature

2. 每个目录启动独立的 Claude Code

cd ../login-feature && claude-code

cd ../payment-feature && claude-code

cd ../notification-feature && claode-code

`

效果

适用场景

`

✓ 大项目多模块同时开发

✓ 需要同时修复多个 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:

Workflow:

`

4.2 Bug 修复代理

`markdown

You are a Bug Fixing Sub-Agent.

Focus:

Priority:

`

4.3 代码审查代理

`markdown

You are a Code Review Sub-Agent.

Checklist:

Output format:

`

4.4 测试编写代理

`markdown

You are a Test Writing Sub-Agent.

Coverage targets:

Test types:

`

4.5 文档生成代理

`markdown

You are a Documentation Sub-Agent.

Output:

`

4.6 性能优化代理

`markdown

You are a Performance Optimization Sub-Agent.

Areas:

Tools:

`

4.7 安全审计代理

`markdown

You are a Security Audit Sub-Agent.

Check:

`

4.8 迁移助手代理

`markdown

You are a Migration Assistant Sub-Agent.

Migration types:

Steps:

`

4.9 API 设计代理

`markdown

You are an API Design Sub-Agent.

Consider:

`

4.10 部署代理

`markdown

You are a Deployment Sub-Agent.

Checks:

`

---

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 WPM99%精确代码
语音输入120 WPM95%自然语言提示
混合模式60-80 WPM97%日常使用

语音提示技巧

`bash

❌ 不好的方式

"帮我写一个函数计算斐波那契数列"

✅ 好的方式

"写一个递归函数计算斐波那契数列第N项,使用记忆化优化避免重复计算,函数接受整数参数N,返回第N个斐波那契数,添加类型注解和错误处理"

`

---

9. 自定义命令

常用操作一键执行

内置命令

`bash

/commit # 提交代码

/commit-push-pr # 提交 + 推送 + 创建 PR

/code-review # 代码审查

/test # 运行测试

/deploy # 部署到生产环境

/rollback # 回滚

/status # 查看状态

`

自定义命令模板

部署命令 (.claude/commands/deploy.md)

`markdown

部署到生产环境:

`

代码审查命令 (.claude/commands/code-review.md)

`markdown

执行代码审查:

`

快速测试命令 (.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. 技术设计

3. 实现

4. 验证

`

模板 2: Bug 修复流程

`markdown

Bug 修复模板

1. 重现

2. 诊断

3. 修复

4. 验证

`

模板 3: 代码审查清单

`markdown

代码审查清单

代码质量

功能正确

性能

安全

测试

`

---

附录

推荐阅读

工具推荐

工具用途
tmux终端复用
iTerm2macOS 终端
Alacritty快速终端
Neovim高效编辑器
VS CodeIDE

快捷键速查

`bash

tmux

Ctrl+b % # 垂直分割

Ctrl+b " # 水平分割

Ctrl+b 数字 # 切换窗口

Ctrl+b d # 脱离会话

Claude Code

Ctrl+c # 中断任务

Ctrl+l # 清屏

Ctrl+r # 历史搜索

`

---

更新日志

日期更新内容
2026-02-04初始版本,完成核心内容整理
``