diff --git a/01-topics/2026-03-20-claude-code-45-tips.md b/01-topics/2026-03-20-claude-code-45-tips.md new file mode 100644 index 0000000..629e9f5 --- /dev/null +++ b/01-topics/2026-03-20-claude-code-45-tips.md @@ -0,0 +1,67 @@ +--- +id: "2026-03-20-claude-code-45-tips" +title: "Claude Code 45 个实战技巧" +slug: "claude-code-45-tips" +status: topic +content_type: article +channels: + - wechat +language: zh-CN +source_urls: + - "https://github.com/ykdojo/claude-code-tips" +assets: [] +cover_image: "" +template: article +owner: content-forge +created_at: "2026-03-20T00:00:00+08:00" +updated_at: "2026-03-20T00:00:00+08:00" +tags: + - claude-code + - ai-tools + - productivity + - dev-tools +--- + +# 选题内容 + +## 核心主题 + +分享 ykdojo 的 claude-code-tips 仓库中的 45 个实战技巧,帮助读者提升 Claude Code 使用效率。 + +## 目标读者 + +- 已在使用 Claude Code 的开发者 +- 对 AI 编程工具感兴趣的技术人员 +- 想提升开发效率的程序员 + +## 核心要点 + +1. **效率提升类技巧** + - 自定义状态栏(Tip 0) + - 语音输入(Tip 2) + - 终端别名(Tip 7) + +2. **上下文管理** + - 主动压缩上下文(Tip 8) + - 精简系统提示(Tip 15) + - 克隆/半克隆对话(Tip 23) + +3. **工作流优化** + - Git worktrees(Tip 16) + - 容器化长任务(Tip 21) + - 后台运行(Tip 36) + +4. **测试与质量** + - TDD(Tip 34) + - 简化过度复杂代码(Tip 40) + - 审计已批准命令(Tip 33) + +## 素材来源 + +- GitHub 仓库: https://github.com/ykdojo/claude-code-tips +- 作者 6 个月实战经验总结 +- 6 个自定义 skills(clone, half-clone, handoff, gha, reddit-fetch, review-claudemd) + +## 写作角度 + +从"我用了 6 个月 Claude Code,总结了这些技巧"的角度,分享实战经验而非理论堆砌。 diff --git a/02-drafts/2026-03-20-claude-code-45-tips.md b/02-drafts/2026-03-20-claude-code-45-tips.md new file mode 100644 index 0000000..8a57499 --- /dev/null +++ b/02-drafts/2026-03-20-claude-code-45-tips.md @@ -0,0 +1,349 @@ +--- +id: "2026-03-20-claude-code-45-tips" +title: "我用了 6 个月 Claude Code,这 45 个技巧让我效率翻倍" +slug: "claude-code-45-tips" +status: draft +content_type: article +channels: + - wechat + - x +language: zh-CN +source_urls: + - "https://github.com/ykdojo/claude-code-tips" +assets: [] +cover_image: "" +template: article +owner: content-forge +created_at: "2026-03-20T00:00:00+08:00" +updated_at: "2026-03-20T00:00:00+08:00" +style: "tech_blog" +audience: "已在使用或想尝试 Claude Code 的开发者" +tags: + - claude-code + - ai-tools + - productivity + - dev-tools +source_notes: + - "01-topics/2026-03-20-claude-code-45-tips.md" +--- + +# 我用了 6 个月 Claude Code,这 45 个技巧让我效率翻倍 + +过去半年,我在 Claude Code 上消耗了 1760 万 tokens,活跃了 79/80 天,最长连续使用 streak 达到 75 天。这不是炫技,而是因为我发现了一个能显著提升开发效率的工具——前提是你得用对方法。 + +今天分享 45 个实战技巧,帮你避开我踩过的坑,让 Claude Code 真正成为你的"第二大脑"。 + +## 一、效率提升:让 Claude Code 更顺手 + +### 1. 自定义状态栏:一眼看清关键信息 + +默认的状态栏只显示基本信息。你可以自定义它来显示:当前模型、git 分支、未提交文件数、token 使用进度条,甚至上一条消息的摘要。 + +```bash +# 示例:状态栏显示 +Opus 4.5 | 📁my-project | 🔀main (2 files uncommitted, synced 5m ago) | ████░░░░ 35% of 200k tokens +``` + +这样你不用切屏就能知道:我是不是该压缩上下文了?有没有忘记提交的文件? + +**配置方法**:参考 [context-bar.sh](https://github.com/ykdojo/claude-code-tips/blob/main/scripts/context-bar.sh),支持 10 种颜色主题。 + +### 2. 语音输入:比打字快 3-5 倍 + +很多人不知道,Claude Code 可以配合本地语音识别工具使用。我用自己写的语音转录工具,语速比打字快 3-5 倍,即使有识别错误,Claude 也能理解我的意图。 + +关键是:**像跟朋友打电话一样,发语音消息**。不用每次都追求完美表达,Claude 足够聪明。 + +### 3. 终端别名:一个字母启动一切 + +```bash +# 添加到 ~/.zshrc 或 ~/.bashrc +alias c='claude' +alias ch='claude --chrome' +alias gb='github' +alias co='code' +alias q='cd ~/projects' +``` + +现在 `c` 就是 `claude`,`c -c` 继续上次对话,`c -r` 查看最近对话列表。 + +## 二、上下文管理:别让对话"变质" + +### 4. AI 上下文像牛奶:新鲜和浓缩最好 + +新对话性能最佳。随着对话变长,性能会下降——这是大模型的特性。 + +**解决方案**: +- 新话题开新对话 +- 性能下降时主动压缩 + +### 5. 主动压缩:手写交接文档 + +关闭自动压缩(`/config` > Auto-compact > false),手动控制时机。 + +压缩前,让 Claude 写一个 HANDOFF.md: + +```markdown +# Handoff Document +## Goal +[当前目标] + +## What's Been Done +[已完成的工作] + +## Next Steps +[下一步计划] +``` + +然后新对话只需要:`path/to/HANDOFF.md`,下一个 agent 就能无缝接手。 + +### 6. 精简系统提示:节省 50% tokens + +Claude Code 的系统提示和工具定义占用约 19k tokens(~10% 上下文)。通过精简,可以降到 9k tokens,节省 ~10k tokens。 + +| 组件 | 精简前 | 精简后 | 节省 | +|------|-------|-------|------| +| 系统提示 | 3.0k | 1.8k | 1,200 | +| 工具定义 | 15.6k | 7.4k | 8,200 | +| **总计** | **~19k** | **~9k** | **~10k (50%)** | + +**配置**:参考 [system-prompt 目录](https://github.com/ykdojo/claude-code-tips/tree/main/system-prompt),记得关闭自动更新。 + +### 7. 克隆/半克隆对话:分支实验 + +想从某个点尝试不同方案?`/fork` 或 `--fork-session` 可以克隆当前对话。 + +**半克隆**:只保留后半段对话,减少上下文占用。适合长对话精简。 + +```bash +# 设置 hook,上下文超 85% 自动半克隆 +# 参考 check-context.sh +``` + +## 三、工作流优化:并行与自动化 + +### 8. Git Worktrees:多分支并行开发 + +在同一个项目同时开发多个功能?Git worktrees 让你在不同目录工作不同分支。 + +``` +# 主目录:main 分支 +~/projects/my-app + +# 新目录:feature-x 分支 +~/projects/my-app-feature-x +``` + +两边互不干扰,可以同时跑两个 Claude Code 实例。 + +### 9. 容器化长任务:让它自己跑 + +对于耗时且有风险的任务(如研究、实验),用 Docker 容器 + `--dangerously-skip-permissions`: + +```bash +# Claude Code 在容器中自主运行 +docker run -v $(pwd):/app -w /app claude-code --dangerously-skip-permissions +``` + +如果出问题,污染的只是容器。 + +**进阶**:本地 Claude Code 通过 tmux 控制容器内的 Claude Code——完全自主的"工人" agent。 + +### 10. 后台运行:Ctrl+B 移走长命令 + +长命令在跑?按 Ctrl+B 移到后台,Claude Code 会用 BashOutput 工具检查进度。 + +结合指数退避:1 分钟后检查 → 2 分钟 → 4 分钟... 比干等高效。 + +## 四、测试与质量:让代码更可靠 + +### 11. TDD:测试先行,目标清晰 + +```bash +# 1. 先写测试(会失败) +# 2. 确认测试失败 +# 3. commit 测试 +# 4. 让 Claude 写代码通过测试 +``` + +这样 Claude 有明确目标,你也容易验证实现是否正确。 + +**案例**:我用这个方法写了 [cc-safe](https://github.com/ykdojo/cc-safe)——扫描 `.claude/settings.json` 中的危险命令。 + +### 12. 审计已批准命令:防止 rm -rf 悲剧 + +有人因为 Claude Code 运行 `rm -rf tests/ patches/ plan/ ~/` 而丢失了整个 home 目录。 + +**cc-safe** 扫描: +- `sudo`, `rm -rf`, `chmod 777`, `curl | sh` +- `git reset --hard`, `npm publish`, `docker run --privileged` +- ... + +```bash +npm install -g cc-safe +cc-safe ~/projects # 递归扫描所有项目 +``` + +### 13. 简化过度复杂代码:问"为什么" + +Claude Code 有时会过度工程化。看到复杂的改动,问: + +- "为什么要加这行?" +- "这个函数能简化吗?" +- "这个抽象层有必要吗?" + +**记住**:通过 AI 写代码不代表你不需要理解它。问足够多的问题,你反而比以前理解得更快——因为你可以直接问。 + +## 五、高级玩法:扩展边界 + +### 14. Gemini CLI 作为 Fallback:访问被屏蔽的站点 + +Claude Code 访问不了 Reddit?用 Gemini CLI 作为代理: + +```bash +# reddit-fetch skill +# Claude Code 通过 tmux 调用 Gemini CLI +# Gemini 有网页访问能力 +``` + +### 15. GitHub Actions 自动诊断:`/gha ` + +CI 失败了?直接给 Claude Code URL: + +```bash +/gha https://github.com/owner/repo/actions/runs/123456 +``` + +它会自动: +1. 获取失败日志 +2. 分析根因 +3. 检查是否 flaky +4. 定位 breaking commit +5. 建议修复方案 + +### 16. dx 插件:一键安装所有技巧 + +不想逐个配置?安装 dx 插件: + +```bash +claude plugin marketplace add ykdojo/claude-code-tips +claude plugin install dx@ykdojo +``` + +包含 6 个 skills: +- `/dx:gha` — GitHub Actions 诊断 +- `/dx:clone` — 克隆对话 +- `/dx:half-clone` — 半克隆 +- `/dx:handoff` — 交接文档 +- `/dx:reddit-fetch` — Reddit 内容获取 +- `/dx:review-claudemd` — CLAUDE.md 审查 + +### 17. 一键配置脚本 + +```bash +bash <(curl -s https://raw.githubusercontent.com/ykdojo/claude-code-tips/main/scripts/setup.sh) +``` + +10 项配置一键部署: +- DX 插件 +- cc-safe 工具 +- 状态栏 +- 禁用自动更新 +- 懒加载 MCP 工具 +- Read(~/.claude) 权限 +- Read(/tmp/**) 权限 +- 禁用 attribution +- 终端别名 +- --fs 快捷键 + +## 六、心法:从工具到思维 + +### 18. 大问题拆小问题 + +Claude Code 无法一次性解决复杂问题?拆解它: + +``` +A → A1 → A2 → A3 → B +``` + +递归分解,直到每个子问题都可解。 + +### 19. 在未知中勇敢 + +我不熟悉 React,但用 Claude Code,我成功解决了 Daft 项目的前端问题。 + +关键是**迭代**: +1. Claude 提出方案 +2. 我实验 +3. 有些是死胡同,换方向 +4. 最终找到优雅解法 + +**在 AI 时代,即使是不熟悉的技术栈,你也能做出贡献。** + +### 20. 个性化软件时代 + +我为我自己写了: +- 语音转录工具(Swift) +- 状态栏脚本(Bash) +- Slack MCP 客户端(Node.js) + +这些工具 1-2 小时就能搞定。**现在,为每个人定制软件变得可行。** + +## 七、终极心法 + +### 21. billion token rule + +不要 10,000 小时规则。用 **billion token 规则**:想精通 AI,就大量使用它。 + +Opus 4.5 够强又够便宜,你可以同时开 3-4 个 tab,让 AI 处理你不愿做的繁琐任务。 + +### 22. 持续学习 + +- **问 Claude Code 自己**:它有专门的子 agent 回答关于自己的问题 +- **`/release-notes`**:查看最新功能 +- **社区**:[r/ClaudeAI](https://www.reddit.com/r/ClaudeAI/) +- **关注 Ado**:[@adocomplete](https://x.com/adocomplete) 的 Advent of Claude 系列 + +### 23. 分享与贡献 + +分享技巧不只是建立品牌。当你分享时,会收到反馈——有人告诉我 `--system-prompt` 标志的存在,让我重新思考了精简方案。 + +而且,Anthropic 团队反应很快。我在 GitHub issues 提的建议,几个版本后就实现了。 + +--- + +## 总结:从复制粘贴到自主运行 + +这 45 个技巧的核心思想:**从让 AI 给你代码,到让 AI 自主编程**。 + +- 效率工具(状态栏、语音、别名)让输入更高效 +- 上下文管理(压缩、精简、克隆)让 AI 保持最佳状态 +- 工作流优化(worktrees、容器、后台)让 AI 并行工作 +- 测试与质量(TDD、审计、简化)让输出更可靠 + +最终,Claude Code 成为你的**通用接口**——不只是 IDE,而是通往整个数字世界的入口。 + +--- + +## 快速开始 + +1. **克隆仓库**: +```bash +git clone https://github.com/ykdojo/claude-code-tips.git +``` + +2. **运行一键配置**: +```bash +bash scripts/setup.sh +``` + +3. **开始使用**:`c` 启动 Claude Code,试试 `/dx:gha` 诊断一次 CI 失败。 + +--- + +> 最好的学习方式就是使用它。打开终端,启动 Claude Code,开始你的 billion token 之旅吧。 + +**相关资源**: +- GitHub 仓库:[ykdojo/claude-code-tips](https://github.com/ykdojo/claude-code-tips) +- 作者 X:[@ykdojo](https://x.com/ykdojo) +- Newsletter:[Agentic Coding](https://agenticcoding.substack.com/)