Claude Code交互效率深度实战：从语音输入到多实例级联

# 在Claude Code会话中输入
> /voice

# 安装 superwhisper
brew install --cask superwhisper

# 使用 Parakeet 系列模型，本地运行
git clone https://github.com/ykdojo/super-voice-assistant
cd super-voice-assistant
pip install -r requirements.txt
python main.py

brew install --cask macwhisper

# 添加到 ~/.zshrc 或 ~/.bashrc

# === Claude Code 核心别名 ===
alias c='claude'                           # 最常用：启动Claude Code
alias ch='claude --chrome'                 # 带Chrome浏览器集成启动
alias cr='claude -c'                       # 继续最近一次对话
alias crr='claude -r'                      # 列出最近对话列表

# === 组合快捷键 ===
alias cf='claude -c --fork-session'        # 继续并分叉对话
alias chf='claude --chrome -c --fork-session'  # Chrome模式+分叉

# === 辅助工具 ===
alias co='code'                            # 打开VS Code
alias gb='github'                          # 打开GitHub Desktop
alias q='cd ~/Desktop/projects'            # 跳转到项目总目录

# === 上下文管理 ===
alias cc='claude && /compact'              # 启动后立即压缩（需要交互式输入）

# 添加到 ~/.zshrc 或 ~/.bashrc
claude() {
  local args=()
  for arg in "$@"; do
    if [[ "$arg" == "--fs" ]]; then
      args+=("--fork-session")
    else
      args+=("$arg")
    fi
  done
  command claude "${args[@]}"
}

#!/bin/bash
# 文件: ~/.claude/scripts/context-bar.sh

# 颜色主题（可切换）
THEME="${THEME:-orange}"
case "$THEME" in
  orange) COLOR="208";;  blue)   COLOR="39";;
  teal)   COLOR="43";;   green)  COLOR="82";;
  lavender) COLOR="183";; rose)   COLOR="204";;
  gold)   COLOR="220";;  slate)  COLOR="102";;
  cyan)   COLOR="87";;   gray)   COLOR="246";;
  *)      COLOR="208";;
esac

# 获取模型名称
get_model() {
  echo "Opus 4.5"
}

# 获取Git信息
get_git_info() {
  if git rev-parse --git-dir > /dev/null 2>&1; then
    local branch=$(git branch --show-current 2>/dev/null)
    local uncommitted=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
    local sync=$(git status -uno 2>/dev/null | grep -c "Your branch is up to date" > /dev/null 2>&1 && echo "synced" || echo "ahead/behind")
    local last_fetch=$(git log -1 --format="%ar" 2>/dev/null | sed 's/ ago//')
    echo "🔀${branch} (${uncommitted} uncommitted, ${sync} ${last_fetch})"
  else
    echo "no git"
  fi
}

# Token使用率进度条
get_progress_bar() {
  local percent=$1
  local filled=$((percent / 10))
  local empty=$((10 - filled))
  local bar=$(printf '█%.0s' $(seq 1 $filled 2>/dev/null))$(printf '░%.0s' $(seq 1 $empty 2>/dev/null))
  echo "${bar} ${percent}%"
}

# 获取当前目录名
get_dir() {
  basename "$(pwd)"
}

# 获取最近一条消息摘要
get_last_msg() {
  local history_file=$(ls -t ~/.claude/projects/-$(echo "$(pwd)" | tr '/' '-')/*.jsonl 2>/dev/null | head -1)
  if [[ -n "$history_file" ]]; then
    local last_msg=$(tail -5 "$history_file" | grep -o '"content":"[^"]*"' | tail -1 | cut -c12- | head -c 80)
    echo "💬 ${last_msg}..."
  fi
}

# 渲染状态栏
percent=18  # 示例值，实际可通过 /context 获取
echo -e "\033[38;5;${COLOR}m$(get_model) | 📁$(get_dir) | $(get_git_info) | $(get_progress_bar $percent) of 200k tokens\033[0m"
echo -e "\033[38;5;${COLOR}m$(get_last_msg)\033[0m"

// ~/.claude/settings.json
{
  "statusLine": {
    "enabled": true,
    "command": "bash ~/.claude/scripts/context-bar.sh",
    "refreshInterval": 5000
  }
}

Opus 4.5 | 📁my-project | 🔀main (3 uncommitted, synced 12m ago) | ██░░░░░░░░ 18% of 200k tokens
💬 Refactor the database layer to separate query logic from business logic...

┌─────────────────────────────────────────────────┐
│           上下文生命周期                          │
│                                                 │
│  新会话(最优) → 逐步积累 → 性能下降 → 需要处理    │
│       ↓            ↓           ↓           ↓    │
│    200k空窗    任务进行中    响应变慢    压缩/交接  │
└─────────────────────────────────────────────────┘

# 在对话中主动压缩
> /compact

# 带自定义提示压缩（引导压缩方向）
> /compact 保留关于数据库重构的所有细节，忽略之前的尝试性代码

> /config
# 导航到 Auto-compact > false

# 在当前对话中，请求Claude Code编写交接文档
> 把当前工作进展写成HANDOFF.md，放到项目根目录。
> 包含：目标、已完成的工作、尝试过但失败的方案、下一步计划。
> 写得足够详细，让一个全新Agent只读这个文件就能无缝接续。

# 数据库重构 - 交接文档

## 目标
将用户模块的数据库查询从Service层分离到Repository层

## 当前进度
### 已完成
- UserRepository接口定义（src/repository/UserRepository.ts）
- findAll() 和 findById() 方法实现
- 单元测试通过（12/12）

### 进行中
- updateRole() 方法的权限校验逻辑

## 失败尝试
- ❌ 直接在Service层用TypeORM的@Transaction装饰器（与NestJS的DI系统冲突）
- ❌ 使用内存数据库进行集成测试（数据隔离问题）

## 下一步
1. 完成 updateRole() 方法
2. 添加Repository层的集成测试
3. 重构 AdminService 使其依赖 UserRepository

> # 新对话
> HANDOFF.md
> 继续这个任务

<!-- ~/.claude/skills/handoff/SKILL.md -->
---
name: handoff
description: 创建或更新交接文档，用于Agent间传递上下文
---

## 执行步骤

1. 检查项目根目录是否已有 HANDOFF.md
2. 如果有，读取现有内容
3. 分析当前对话的完整上下文
4. 创建或更新 HANDOFF.md，包含：
   - 目标（Goal）
   - 当前进度（What's been done）
   - 失败尝试（What didn't work）
   - 下一步（Next steps）
5. 输出文件路径，方便新Agent加载

# 克隆脚本（将对话一分为二）
~/.claude/scripts/half-clone-conversation.sh

// ~/.claude/settings.json
{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/scripts/check-context.sh"
          }
        ]
      }
    ]
  }
}

flowchart TD
    A[上下文使用率] --> B{< 50%?}
    B -->|是| C[继续当前对话]
    B -->|否| D{50% - 70%?}
    D -->|是| E[主动 /compact<br/>带方向性提示]
    D -->|否| F{70% - 85%?}
    F -->|是| G[编写 Handoff 文档<br/>开启新对话]
    F -->|否| H[紧急处理：<br/>半克隆或新对话]

    style C fill:#4CAF50,color:#fff
    style E fill:#FF9800,color:#fff
    style G fill:#FF5722,color:#fff
    style H fill:#F44336,color:#fff

// ~/.claude/settings.json
{
  "env": {
    "ENABLE_TOOL_SEARCH": "true"
  }
}

// ~/.claude/settings.json
{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

flowchart LR
    T1["Tab 1<br/>常驻服务<br/>语音转录"] --> T2["Tab 2<br/>构建任务<br/>Docker build"] --> T3["Tab 3<br/>运维任务<br/>磁盘检查"] --> T4["Tab 4<br/>工程任务<br/>功能开发"] --> T5["Tab 5<br/>写作任务<br/>本文撰写"]

    style T1 fill:#90A4AE,color:#fff
    style T2 fill:#FF9800,color:#fff
    style T3 fill:#42A5F5,color:#fff
    style T4 fill:#66BB6A,color:#fff
    style T5 fill:#AB47BC,color:#fff

# Tab 1: 主分支日常维护
cd ~/projects/my-app
c  # claude

# Tab 2: 新功能分支
cd ~/projects/my-app
claude "创建git worktree到 ../my-app-feature-auth，基于feature/auth分支"
cd ../my-app-feature-auth
c  # claude

# Tab 3: 紧急修复分支
claude "创建git worktree到 ../my-app-hotfix-123，基于hotfix/issue-123"
cd ../my-app-hotfix-123
c  # claude

# 让Claude Code执行指数退避检查
> 我的Docker镜像正在构建，请每隔递增时间检查一次状态。
> 第一次等1分钟，第二次等2分钟，第三次等4分钟，依此类推。
> 构建完成后立即通知我结果。

⏳ 等待 1 分钟...
🔍 检查构建状态... 仍在进行中 (Layer 15/32)

⏳ 等待 2 分钟...
🔍 检查构建状态... 仍在进行中 (Layer 24/32)

⏳ 等待 4 分钟...
🔍 检查构建状态... 仍在进行中 (Layer 30/32)

⏳ 等待 8 分钟...
✅ 构建完成！镜像ID: sha256:abc123...

> 不要用 gh run watch（太浪费Token），
> 而是用 gh run view <run-id> | grep <job-name> 检查状态，
> 采用指数退避策略。

> # 生成内容后
> /copy
# Claude的最后一条回复已复制到剪贴板（Markdown格式）

# macOS
> 用 pbcopy 把分析报告复制到剪贴板

# Linux
> 用 xclip -selection clipboard 把结果复制到剪贴板

> 把重构方案写到 REFACTOR_PLAN.md，然后在VS Code中打开
> 打开后跳到第42行

# macOS
> 用 open 命令在浏览器中打开这个URL

# 也可以直接说
> 在我的浏览器中打开 https://example.com

> 在GitHub Desktop中打开当前仓库

# 编辑GitHub PR描述——安全可控的流程
> 1. 把当前PR描述的内容复制到本地文件 pr-description.md
> 2. 在VS Code中打开 pr-description.md
# (你手动审查和编辑)
> 3. 编辑完成后，把文件内容更新到GitHub PR描述中

# 对话历史位置
~/.claude/projects/-<项目路径转换>/

# 项目路径转换规则：/ 变成 -
# 例如：/Users/yk/Desktop/projects/my-app
# → ~/.claude/projects/-Users-yk-Desktop-projects-my-app/

# 搜索包含"数据库重构"的对话
grep -l -i "数据库重构" ~/.claude/projects/-Users-yk-Desktop-projects-*/*.jsonl

# 搜索今天的特定主题对话
find ~/.claude/projects/-Users-yk-Desktop-projects-*/*.jsonl -mtime 0 -exec grep -l -i "关键词" {} \;

# 提取某个对话中的用户消息（需要jq）
cat ~/.claude/projects/.../conversation-id.jsonl | jq -r 'select(.type=="user") | .message.content'

> 今天我们讨论了什么关于数据库重构的内容？

# 基础容器启动
docker run -it \
  -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \
  -v $(pwd):/workspace \
  node:20-slim \
  bash -c "npm install -g @anthropic-ai/claude-code && cd /workspace && claude --dangerously-skip-permissions"

flowchart TD
    A["本地Claude Code<br/>（主控端）"] -->|"tmux send-keys"| B["tmux会话"]
    B -->|"docker exec"| C["容器内Claude Code<br/>（Worker端）"]
    C -->|"执行任务"| D["容器环境<br/>--dangerously-skip-permissions"]
    D -->|"结果文件"| E["挂载卷:/workspace"]
    A -->|"读取结果"| E

    style A fill:#42A5F5,color:#fff
    style C fill:#FF9800,color:#fff
    style D fill:#F44336,color:#fff

# 1. 启动tmux会话
tmux new-session -d -s worker

# 2. 在tmux中连接到容器
tmux send-keys -t worker 'docker exec -it claude-worker bash' Enter

# 3. 在容器中启动Claude Code
tmux send-keys -t worker 'claude --dangerously-skip-permissions' Enter
sleep 3

# 4. 发送任务
tmux send-keys -t worker '分析整个代码库，找出所有SQL注入漏洞，输出到 /workspace/security-report.md' Enter

# 5. 捕获输出
tmux capture-pane -t worker -p

# 容器1：Claude Code（主力编码）
docker run -d --name claude-worker ...

# 容器2：OpenAI Codex（代码审查）
docker run -d --name codex-worker ...

# 容器3：Gemini CLI（信息检索）
docker run -d --name gemini-worker ...

# 终端启动，加载别名
q  # cd ~/Desktop/projects
cd my-backend-app
c  # claude

> /voice
# （语音输入）"今天的任务有三个：
# 第一，完成用户认证模块的重构，把JWT逻辑从中间件移到独立的AuthModule；
# 第二，审查PR #42的代码变更；
# 第三，给新的API接口写文档。
# 先从第一个任务开始。"

# Claude Code开始分析和重构
> 先分析当前的认证中间件代码，列出所有需要移动的函数

# 查看状态栏，Token使用率12%，继续

# 状态栏显示Token 55%
> /compact 保留AuthModule重构的所有进度，忽略中间的调试对话

# 新Tab
c  # 新的Claude Code实例

> 审查PR #42的代码变更，关注安全性和性能问题
> 用 gh pr view 42 获取diff

# Claude Code完成后
> /copy  # 复制审查意见到剪贴板

# 新Tab
c
> /voice
# （语音输入）"给AuthModule的所有公开API写文档，
# 包括使用示例和参数说明，
# 格式用Markdown，参考已有的API文档风格"

# 文档生成后
> 把文档写到 docs/api/auth.md 并在VS Code中打开
# 人工审查Markdown渲染效果

> 把文档也复制到剪贴板，我要粘贴到Notion

# 当前Tab
> 我需要分析整个代码库的性能瓶颈。
> 这个任务比较危险，用容器化的Worker来执行。

# Claude Code启动容器Worker
# ...容器中运行分析...

# 完成后拉取结果
> 把容器中的 /workspace/perf-report.md 复制到本地

# 各Tab执行交接
> 写一个HANDOFF.md总结今天的所有进度和未完成的事项

# 关闭已完成的Tab

flowchart TB
    subgraph 开发者["开发者"]
        V["🎤 语音输入"]
        K["⌨️ 键盘输入"]
    end

    subgraph 终端环境["终端环境"]
        AL["别名体系<br/>c/ch/cr/cf"]
        SL["状态栏<br/>Token + Git + 摘要"]
        T1["Tab 1: 主任务"]
        T2["Tab 2: 审查"]
        T3["Tab 3: 文档"]
    end

    subgraph 上下文管理["上下文管理"]
        CP["/compact 主动压缩"]
        HF["Handoff 交接文档"]
        HC["Half-Clone 半克隆"]
        FK["--fork-session 分叉"]
    end

    subgraph 输出通道["输出提取"]
        CY["/copy"]
        PB["pbcopy/xclip"]
        FL["文件 + 编辑器"]
        GH["GitHub Desktop"]
    end

    subgraph 隔离环境["容器化"]
        CW["Worker Claude Code"]
        CO["Codex / Gemini"]
    end

    V --> T1
    K --> T1
    AL --> T1
    SL --> T1

    T1 --> CP
    T1 --> HF
    T1 --> HC
    T1 --> FK

    T1 --> CY
    T1 --> PB
    T1 --> FL
    T2 --> GH

    T3 --> CW
    CW --> CO

    style V fill:#AB47BC,color:#fff
    style CP fill:#FF9800,color:#fff
    style CW fill:#F44336,color:#fff
    style CY fill:#4CAF50,color:#fff

#!/bin/bash
# quick-setup.sh — Claude Code高效环境一键配置

echo "🚀 配置Claude Code高效开发环境..."

# 1. 别名
cat >> ~/.zshrc << 'EOF'

# === Claude Code 高效别名 ===
alias c='claude'
alias ch='claude --chrome'
alias cr='claude -c'
alias crr='claude -r'
alias cf='claude -c --fork-session'
alias co='code'
alias q='cd ~/Desktop/projects'

# --fs 快捷方式
claude() {
  local args=()
  for arg in "$@"; do
    [[ "$arg" == "--fs" ]] && args+=("--fork-session") || args+=("$arg")
  done
  command claude "${args[@]}"
}
EOF

# 2. 状态栏目录
mkdir -p ~/.claude/scripts

# 3. MCP工具懒加载
echo '启用MCP工具懒加载...'
cat >> ~/.claude/settings.json << 'EOF'
{
  "env": {
    "ENABLE_TOOL_SEARCH": "true"
  }
}
EOF

# 4. 交接Skill
mkdir -p ~/.claude/skills/handoff
cat > ~/.claude/skills/handoff/SKILL.md << 'SKILLEOF'
---
name: handoff
description: 创建或更新交接文档
---
检查 HANDOFF.md 是否存在，分析当前对话上下文，
创建/更新交接文档包含：目标、进度、失败尝试、下一步。
SKILLEOF

echo "✅ 配置完成！运行 source ~/.zshrc 使别名生效。"

# 在对话中分叉
> /fork

# 或用CLI参数
claude -c --fork-session  # 继续并分叉
claude -r --fork-session  # 选择历史并分叉