Practical Guide

Claude Code
实操提效指南

此处默认受众已经拥有一定的 Claude Code 实操经验,在部分使用过程中接触到一些小麻烦,但不知道如何优化。以下内容或许总会有几条能对得上你的痛点。

§
1

安装和用量限制问题

主流安装方法

关于安装,这里默认你已经完成,这里只说明几种不同路径。

  1. 下载官方 Claude 桌面端,登录账号后使用(也可通过 CC Switch)
  2. 通过各类主流 IDE 插件(如 VS Code、Cursor 等)
  3. 安装到终端:
    • 先装 Node.js 和 Git → npm / winget(无须翻墙)安装
    • 接入模型:
      • 有 Claude 订阅,直接登录
      • 无 Claude 订阅:使用 CC Switch

        CC Switch 安装方法:https://github.com/farion1231/cc-switch/releases

        主页 → Claude Code(勿选 Claude Desktop,这个对应桌面端)→ 模型配置 → 选厂商,填入 API,改好配置

        打开终端,输入 claude 启动,进行初始化设置(以后也能改 /theme 命令即可),开始对话

注意:特别推荐在每次对话前,使用以下命令:

claude --dangerously-skip-permissions

能够打开 bypass permissions 模式,能够少点许多次确认,让项目运行更流畅(使用过程中可以 Shift+Tab 灵活切换 Plan Mode 等)

此外,一个使用小技巧:同时把 Claude Code 与记事本一起固定在任务栏,记事本中常开一个文档,存放常用命令、API Key 和一些配置,调取更方便,且直接是纯文本格式。

用量限制问题

1. 使用 CC Switch 的注意事项

部分早期版本 CC Switch 的代理与转换存在一定不足,消耗 tokens 相比与官方 API 存在较大幅度的畸高。建议使用 v3.16.0 以上版本,并在设置开启自动更新。

2. 使用订阅授权的用量限制

当前通过订阅使用 Claude Code,都会受到官方的三重限制:月使用总量、周总量、5h 用量限制。其中对我们项目运行最大的是 5 小时用量限制。通过以下办法,可以尽量降低 5h 滚动用量限制的影响:

🎯 5 小时滚动窗口机制详解

不管是 Codex 还是 Claude Code,它们的额度限制都不是每天重置或者每小时重置,而是一个 5 小时的滚动窗口

也就是你发第一条消息的那一刻,5 小时倒计时就开始了,这 5 个小时内你有一定的 Token 额度可以用,用完了,就得等这个窗口走完才能重置。

但这里有一个很多人不知道的细节。

5 小时窗口结束之后,系统并不会自动帮你开启下一个窗口,它会一直等,等到你发出下一条消息的那一刻,才重新开始计算新的 5 小时。

比如你每天下午 2 点到 6 点是集中用 Agent 工作的时间。

如果你 2 点才开始用 Codex,窗口就从 2 点开始算,到晚上 7 点才重置。中间如果用的比较猛,3 点半额度就见底了,你得干等到 7 点,这基本就要当 3 个半小时的原始人了。

但如果你在 上午 11 点的时候,提前给 Codex 发一条消息,哪怕就随便说一句话,窗口就从 11 点开始计算了,等于下午 4 点就重置了。

你 2 点开始干活,干到 4 点额度刷新了一波,4 点以后,你又有一整个新窗口可以用。也就是说在 2 点到 6 点的核心工作时间里,你能享受的 5 小时额度窗口,直接从一个窗口变成了两个。

变相让你的额度变成了两倍。

原理就这么简单,提前触发窗口,让重置时间刚好落在你干活的中间。很多人用了大半年 agent,每次撞限了就硬等,因为可能确实不知道这个重置时间是可以自己控制的。

所以你只要理解了窗口的重置是可以人为控制的这一点,玩法就打开了,只要搭配上自动化,你就可以享受两倍额度窗口了。

设置方法

说下怎么设置。

  • 1Codex:比较简单,在左边菜单找到自动化,点进去以后新建一个,触发条件选「每天」,时间填你主要干活前的 3 小时,动作就是随便发一条短消息,内容无所谓,写个"允公允能,日薪越亿"都行。设好之后就不用管了,每天到点它会自动跑一下,帮你把窗口提前激活。
  • 2Claude 客户端:也是一样的,设置一个 Routines 自动化就行。
  • 3CLI 版(Mac):直接跟你的 Agent 说:"帮我设一个 crontab 定时任务,每天上午 11 点自动给 Claude Code 发一条消息'允公允能,日薪越亿'触发 5 小时窗口"
  • 4CLI 版(Windows):用任务计划程序,也可以直接让 Agent 帮你配。

不过这里要提醒一下,5 小时窗口是一层限制,但上面还有一个周额度的上限,所以不用贪心,让重置时间跟你的工作节奏对上就够了。

3. 注意设置用量预警

终端跑大型项目消耗 tokens 的量级较大,此时诸如 API Key 泄露等导致的 tokens 异常消耗往往容易被忽视。在对应模型厂商的 API 平台设置用量预警提醒,在余额见底之前通过邮件等提醒,利于及时止损~

2

上下文与记忆管理问题

写好、管理好 CLAUDE.md

一定程度上,会写 CLAUDE.md 文件,是学会启动 CC 之后,第一件该做的事情。它不应该被理解成 AI 给当前在做的事情写的「简介」,而是应该被理解成一个从上往下分层穿透的约束体系

CLAUDE.md 架构图
CLAUDE.md 分层穿透约束体系架构图

下面我们简单介绍主要的两层:全局 CLAUDE.md 和简单的项目 CLAUDE.md(复杂的项目可以逐层让 CC 创建 CLAUDE.md 文件)。

1. 全局 CLAUDE.md

全局 CLAUDE.md,放在用户总目录的 Claude Code 根目录下面,~/.claude/CLAUDE.md。只要你打开 Claude Code,不管你进的是哪个项目,它都会被自动加载和遵守。这是它的顶层规范。它可以解决的是你是谁、你做事的原则、你希望它用什么方式跟你协作这一层次的问题。(这一部分内容,一定精炼,宁缺毋滥)(具体指标:超过 80 行,Claude 开始遗漏部分内容,最多最多一定不要超过 200 行(毕竟相当于要叠加到所有项目的上下文))

一个优秀的全局 CLAUDE.md 示例(可以直接复制给你的 CC,让它改写):

## 关于我
[你的名字 / 身份 / 职业背景,非程序员的话一定要写出来]。我用 Claude Code 做 [具体用途 1] 和 [具体用途 2]。

## 思维原则
所有决策从问题本质出发,不因「惯例如此」照搬。回到问题本身:要解决什么?
最直接的路径是什么?从零设计会怎么做?不要谄媚。不要夸我的想法好、
不要说「这是个很好的问题」、不要开头加「当然可以」。给我真实判断,
方案有问题直接指出来。发现更好的做法直接说,不用等我问。

## 约束先行
无论开发项目还是知识管理项目,第一步永远是建规则:新项目先写 CLAUDE.md,
新目录先定结构约定(什么放哪、怎么命名、何时清理)。没有规范的工作空间不动手。
已有规范的项目,严格遵守其 CLAUDE.md 中的约定。需要调整规范时先改文档、
再改实践,不要反过来。

## 沟通方式
- 默认中文,代码、命令、变量名用英文
- 结论先行,再给理由,不要先铺垫背景
- 遇到模糊需求,先给最合理的方案,再问要不要调整
- 不要问「你确定要这样吗」,除非命中下方红线

## 自主边界(红线,必须先问我)
以下操作即使在 auto-accept 模式下也必须停下来问我:
- 删除文件、目录或 git 历史
- 修改 .env、密钥、token、CI/CD 配置
- 数据库 schema 变更或数据迁移
- git push、git rebase、git reset --hard、强制推送
- 安装新的全局依赖或修改系统配置
- 公开发布(npm publish、部署到生产、发文章等)

## 通用工程纪律
- 改完主动跑验证(具体命令见各项目 CLAUDE.md),不要只改不验
- 不要为了让代码跑起来注释掉报错或加绕过标记,找根本原因
- 密钥、token、密码不进代码、不进 commit、不进日志
- 大改动前先在 Plan Mode 出方案,我确认后再动手

2. 项目 CLAUDE.md

项目级 CLAUDE.md,放在每个项目的根目录下,路径就是 项目目录/CLAUDE.md。它只在你打开这个项目的时候才会被加载。它解决的是这个具体的项目要怎么干,有什么特殊约定这一层的问题。(内容也不宜太长)

实际上这个文件其实也完全不用你自己写,你就直接打开那个文件夹,然后和 Claude Code 聊就行,你直接把你的需求,和你在意的事情,和它探讨,让它给你写一份就 OK 了。

管理好上下文与记忆

1. 用好 /compact 指令

当上下文使用率达到 50%–70% 时,就不要等待系统自动触发上下文压缩了,建议主动运行 /compact 命令,这个命令会将冗长的对话历史压缩成一个摘要,保留关键决策,同时极大地释放上下文空间。对需要长期运行的复杂任务来说,它非常有用。

要在终端查询上下文使用率使用 /context 命令。这会显示当前上下文的详细分类,让你一眼看出哪些部分(如读取的文件、对话历史)占用了最多的 token。

  • 类似地,使用 /cost 命令实时查看当前的 token 用量和费用估算
  • 使用 /usage 查看账户级别配额,如果是使用官方订阅,这个命令会显示你的账户订阅计划整体的使用限额和速率限制

如果有进一步的可视化需要,可以进行以下操作:

🎯 安装 claude-hud 插件:这种方式能为你提供一个底部的实时状态栏,像一个 HUD(抬头显示)一样,让你时刻掌握上下文使用百分比、当前模型和订阅额度,且有绿、黄、红三色进度条预警。尤其适合需要持久关注上下文状态的开发者,三色预警能让你对用量危机一目了然。

🛠️ 配置 statusline 自定义状态栏:如果 claude-hud 的信息量还不能满足你,可以通过 statusline 功能创建一个信息密度极高的自定义状态栏,除了基础的上下文和费用,甚至可以显示缓存命中率、5 小时滚动用量重置倒计时等关键指标。这适合对成本控制有极致要求、希望全面掌握各项数据的用户。

⚡️ 使用 ccusage 第三方工具:如果你想在终端外部快速查看用量报告,可以考虑 npx ccusage 这类第三方工具,它提供每日、月度、甚至按会话统计的详细用量报告。这适合需要周期性复盘整体消费的分析型用户。

2. 推荐一个好用的「洁癖」Skill

直接上链接:https://github.com/KKKKhazix/khazix-skills/tree/main/neat-freak

直接在终端复制给 CC 让它帮你安装即可(网络环境需要有魔法)。

简单但实用,实际上是结构化整理上下文。做的事大概就是,每次你在 Agent 里,做完一个功能或者又解决了一个 BUG,就调用这个洁癖 Skill,然后说一声帮我全面审查一下或者直接就 /Neat 一下,它就会自动审查你整个项目的文档体系和记忆文件,然后根据这次对话,把该改的文档、记忆、CLAUDE.md 进行迭代,确保非常干净之后,最后,再给你一份变更摘要,让你知道改了啥东西。

3. storage-analyzer 解决内存占用问题

直接上链接:https://github.com/KKKKhazix/khazix-skills/tree/main/storage-analyzer(同样的安装方式)

/storage-analyzer 或者说"帮我看看存储"就可触发,谁用谁说好。

4. 更直接准确的提示词,减少 CC 去「遍历」的消耗

  • 使用 @ 精准引用:使用 @文件名@目录名/ 来精确地将需要的文件或整个目录加入上下文,避免让 Claude 不必要地搜索或猜测
  • 优先使用 ! 执行 Bash:需要执行 git statusls 等命令时,在命令前加 !(例如 ! git status),会直接在 Shell 中运行并将结果返回,省去了模型处理"理解并执行"这一步骤的 token
  • 使用 /memory 命令编辑记忆:需要临时告诉 Claude 一些偏好或记住某件事,但不想把它写入永久文件时,可以使用 /memory 命令来编辑会话的短期记忆
  • 使用 /clear 清除会话:当发现 Claude 出现明显的"上下文腐烂"迹象(如重复之前说过的话、忘记刚做的决定),或者需要切换到一个完全不相关的任务时,果断使用 /clear 命令清空当前对话历史,开启一个全新的会话
3

项目管理与延伸拓展

管理好 Workspace(这一块儿其实 Codex 更有优势)

在终端使用 CC,workspace 就是对应的文件夹。在安装完 CC 最后就应该去进行合理的排布。尤其是使用笔记本电脑等内存相对有限的载体跑 CLI 时,这项工作就更有必要性。

我自己的习惯是在 D 盘新建一个文件夹并置顶在文件资源管理器,以便随时打开。在这之下,按照不同项目类型分出一个一级的 workspace(如日常创作、研究、知识管理等)。涉及到具体的项目需求,再在这一级之下新建文件夹。

当然,如前所述,在新建每一层 workspace 时,最好先在对应文件夹打开 CC,来撰写这一层的 CLAUDE.md。

一个邪修招数:「国产替代」

Claude Code 的特性使得其在保持较高性能的同时保持在单位产出下有较高的 tokens 消耗。这个时候,可以适当地进行"国产替代",来运维一些简单、周期性的项目,能够节省不少 tokens。另外,在进行一些诸如将长篇幅英文著作进行翻译的工作,用国产的产品,效果上反而有更"地道"的表现。

  • 就我自己的使用体验而言,Qwen Code 算是最有性价比的选择。就切换的学习成本而言,Qwen Code 从安装到操作到常用指令,与 Claude Code 不能说完全一样,只能说有九分相像,切换时几乎不怎么需要换脑子。就我自己 Qwen Code + DeepSeek V4 Pro 的使用体验,基本可以达到 CC 八成的功力。
  • Qwen Code 对大多数 CC 的 skills 和 plugins 也可以直接共享,不需要反复装配,省时省力。
  • Qwen Code 的 API 调用,也可以薅阿里云的羊毛,适当节省一些支出。

熟用活用 Skills,并善于创造 Skills

1. 介绍几个「装机必备」Skills
1. skill-creator
用来造 Skill 的 Skill,在 Claude Code v2.1+ 中默认启用,直接 / 调用即可。这个 Skill 可以带你走完正确构建自己 Skill 的全过程——描述工作流、提出一份 SKILL.md、跑 3-5 个测试 prompt、根据失败结果精化指令。能让所有其他 Skill 变得更好的元 Skill。
对于在第一次尝试时,兜了大量圈子的或者整个流程非常复杂的工作,都可以通过这个 Skill 进行复盘,创造为 Skill。在下一次遇到同样的工作时主动调用,能够节省 tokens,并让你的 CC 越用越"聪明"。
2. huashu-nuwa(女娲)
前段时间爆火的蒸馏同事/员工/名人变成 Skill 的元 Skill。女娲 Skill 可以自动完成调研、提炼、验证全流程,在资料足够的情况下,近似地蒸馏任何人的思维方式。
安装:npx skills add alchaincyf/nuwa-skill
项目链接:https://github.com/alchaincyf/nuwa-skill
3. neat-freak
前面已有叙述。
4. storage-analyzer
前面已经有叙述。
5. ui-ux-pro-max(优化视觉设计)
50+ UI 风格、97 种配色方案、57 种字体搭配、99 条 UX 指南、25 种图表类型、9 套技术栈。自带 Python CLI 可查询设计数据库。从空白 Figma 开始的时候装。
项目链接:https://github.com/nextlevelbuilder/ui-ux-pro-max-skill
附带一个暴论:给人看的效果:HTML > MD > Word

运用好无论是 CC 还是任何一个 AI 编程环境,用 HTML 去"封装"内容的成本极低。

在"给人看"方面 HTML 有个最大的优点,即极强的适应性和稳定性。只要一台电脑有浏览器,就算是特别老的 IE,就能打开 HTML 文件,不需要像 MD 需要有特定的编辑器渲染。而与 PPT 文件相比,只要嵌入得当,任何图片、字体格式都不会受影响,稳定性更强,又能同时保证美观性。

但需要说明的是,HTML 和 Markdown 从来也不是替代关系,是分工关系。Markdown 是信息的底层载体,负责在人和 AI 之间高效流转。HTML 是信息的最终呈现层,负责给人看的时候好看。

"在 AI 时代里,已经可以大略抛弃 Word、PDF 之流了。因为 Word 和 PDF 是面向打印时代的格式。而 Markdown 和 HTML 一起,是面向屏幕时代的格式。一个负责存储与流转,一个负责展示。所以,如果有人问我,AI 时代应该用什么格式保存文件。我的回答也只有两个字:.md"

6. Frontend Design Skills
解决如上所说的 HTML 生产成本问题,解决绝大多数 AI 做前端的品味问题。能力越差的模型,改善效果越好(bushi)。
项目链接:https://github.com/anthropics/skills/tree/main/skills/frontend-design
7. 办公牛马必备四件套:docx、xlsx、pdf、pptx
项目链接:https://github.com/anthropics/skills/tree/main/skills
如果是 Claude Desktop,直接在 Cowork 使用,这些能力是内置的,开箱即用,如果是在终端使用,需要检查装了没有。
有了它,你的 AI 就能读取你各种格式的文件了。Word、PPT、Excel、PDF 全都能读,全都能写,全都能改(不装虽然也能读取,但每次 agent 开始处理,都是自己现写代码摸索,效果就纯赌运气)。
8. Web Access Skill(联网搜索 + 浏览器操控)
(但注意搜索频率,不要过高触发反爬机制引起封号,建议最好开小号使用)
项目链接:https://github.com/eze-is/web-access
可以通过 Chrome DevTools Protocol 直接连你本地的 Chrome 进程,带着你的登录状态,来进行网络检索,范围能广得多。
甚至贴心的出于节省 token 考虑,还选择了 Jina 作为一个可选中间层,可以和 WebFetch、Curl 组合使用,能把网页正文预先转成干净的 Markdown 再读,大幅节省 token 消耗。
设计的相当优雅。不过有一个前提条件是需要 Chrome 更新到最新版。并且还需要允许远程调试,可以在地址栏输入 chrome://inspect/#remote-debugging,进行勾选。
9. PUA Skill(专治 AI 摆烂)
项目链接:https://github.com/tanweai/pua
这个 Skill 解决的是一个很多人都体感过但不太好描述的问题,那就是 AI 摆烂。你让它修个 bug,它试了两三次没搞定,就开始跟你说"建议您手动检查一下""这个问题可能需要更多上下文"。PUA 这个 Skill,就是专治这种摆烂的。当比如你的项目,改来改去实在改不好的时候,直接 /pua,开干。它会有四级压力升级,如果 Agent 在同一个思路上原地打转,PUA 会强制打断它,让它执行一个 7 项检查清单,逼它换思路。
10. Claude-mem
项目链接:https://github.com/thedotmack/claude-mem
或直接输入指令:
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
很多人觉得,OpenClaw 比 Claude Code 越用越聪明,其实本质上就是记忆机制,OpenClaw 直接把 Memory 给封装了。而 Claude Code 或者 Codex,一直都没这套东西。所以就有大佬专门做了个。名字就叫 Claude-mem,解决的就是记忆持久化问题。
2. 关于 Skill「本质」的一些说明

Skill 其实就是分类学。一个好的 Skill,它的核心就两个词:分类和触发。Skill 怎么触发、能不能正确触发、触发以后能干什么,才是最核心的事。之前有一篇论文发过实验数据,就是当 Skills 数量在 20 个以下时,准确率保持在 90% 以上,几乎不会错。超过 30 个准确率就不行了。到了 200 个的时候,准确率就剩 20% 了,而且速度极慢,Token 消耗还爆炸。Skill 从来不是只分的越细越好,是找到最合适的颗粒度。

比如封面图和 PPT 配图之间的差异,不值得在最顶层各自占一个独立的 Skill,它们只是图片生成这个类别内部的变异。但图片生成和服务器管理之间的差异,那是真的大到需要各自占一个独立的 Skill。判断一个 Skill 值不值得存在,标准就三条:1. 它对应的场景有没有明确的边界。2. 它对应的场景是不是会高频复现。3. 它能不能归属进已有的 Skill 里。

以及,奥卡姆剃刀原则,如无必要,勿增实体。

获取更多的拓展性(跑路 Codex)

  1. 通过 plugins 获得更多能力延伸(Codex 中可以直接装配和创建,实际使用中可以直接 @ 调用,对开发 App 帮助比较大)
  2. 更完善的交互方式:结合 Chat 与 AI IDE
  3. 更便利的记忆与上下文管理
  4. 更便利的跑路方式(可以直接导入 Claude Code 与 Cowork 的所有项目)