0. 先记住一句话Claude Code 不是普通聊天窗口它更像一个「会读项目、会改文件、会跑命令的终端 AI 编程助手」。所以使用它时最重要的不是直接说帮我改一下而是先让它先分析不要修改代码。先告诉我你准备读哪些文件、改哪些文件、为什么改、有什么风险。这样会稳很多。1. 推荐的基础使用流程以后每次打开一个项目建议按照这个流程来cd D:\your-project claude进入 Claude Code 后先说请先读取项目结构不要修改代码。先告诉我这个项目的主要目录、入口文件、运行方式和风险点。如果是 Chrome 插件项目可以这样说请先读取 manifest.json分析这个 Chrome Manifest V3 插件的结构。 重点看 1. popup 入口在哪里 2. background service worker 在哪里 3. 是否有 content script 4. storage/cookies/proxy/webRequest 等权限怎么用 5. 是否有 Chrome / Edge 商店审核风险 先不要修改代码。2. 安装后第一次使用2.1 安装 Claude Code一般用 npm 安装npm install -g anthropic-ai/claude-code然后进入项目cd D:\your-project claude2.2 不要在用户根目录里乱开不要这样cd C:\Users\admin claude建议进入具体项目目录cd D:\projects\BrowseVeil claude这样 Claude Code 看到的范围更清晰也更不容易乱动无关文件。3. Windows 粘贴图片技巧3.1 截图后粘贴图片在 Windows 上按Win Shift S截图回到 Claude Code 终端按Alt V成功后会出现类似[Image #1]然后继续输入帮我分析这张图里的报错。3.2 如果 Alt V 不生效可以保存图片然后把路径发给 Claude Code请分析这张截图C:\Users\admin\Desktop\error.png或者参考这个 UI 截图帮我修改 popup 样式D:\project\screenshots\popup.png3.3 VS Code / Cursor 终端里不行怎么办如果在 VS Code / Cursor / Windsurf 终端中快捷键异常可以在 Claude Code 里执行/terminal-setup如果还是不行建议换成 Windows Terminal / PowerShell 运行cd D:\your-project claude4. 多行输入、外部编辑器、长需求4.1 换行不要直接按 Enter在 Claude Code 里Enter通常是发送消息。想输入多行用Ctrl J例如请完成下面任务 Ctrl J 1. 先分析代码 Ctrl J 2. 不要立刻修改 Ctrl J 3. 给出风险点4.2 长需求用外部编辑器长提示词不要在终端里硬敲可以用Ctrl G或者Ctrl X 然后 Ctrl E打开外部编辑器写完后保存退出。适合这种任务请重构 BrowseVeil 授权站点逻辑要求如下 1. 不影响已有授权站点 2. 不新增高风险权限 3. 不破坏 background service worker 4. 输出修改文件列表和测试步骤5. 常用快捷键速查快捷键作用Alt VWindows 粘贴剪贴板图片Ctrl J插入换行不发送Esc中断当前响应或工具调用Ctrl L重新绘制终端界面终端显示乱了时用Ctrl R搜索历史输入Ctrl O查看 transcript看看 Claude 读了哪些文件、跑了哪些命令Ctrl T显示/隐藏任务列表Ctrl B把 bash 命令或 agent 放到后台Ctrl G打开外部编辑器Alt P打开模型选择器Alt T开关 extended thinkingAlt O开关 fast modeShift Tab切换权限/模式例如 Plan Mode、Accept Edits 等不同终端可能快捷键略有差异。Windows / VS Code / Cursor 里如果快捷键异常优先试/terminal-setup。6. 重要的/命令Claude Code 里输入/可以看到可用命令。6.1/clear清空当前上下文适合话题已经乱了的时候/clear使用场景/clear然后重新说请读取 CLAUDE.md 和 manifest.json重新理解项目结构。6.2/compact压缩上下文适合会话很长但还想继续/compact也可以指定保留重点/compact 只保留当前修改方案、已修改文件、还没解决的问题。建议一个大功能完成后执行一次/compact聊乱了直接/clear长期项目最好配合CLAUDE.md6.3/config查看或修改配置/config常看权限模式模型编辑器模式是否启用某些快捷键终端显示相关设置6.4/terminal-setup适合 VS Code / Cursor / Windsurf 终端快捷键不好用/terminal-setup6.5/hooks查看或配置 Hooks/hooksHooks 可以用来自动执行固定动作例如每次改代码后自动跑npm run lint。7. 权限模式怎么选Claude Code 可以改文件、跑命令所以权限模式很重要。7.1 新手推荐场景推荐模式第一次分析项目Plan Mode让它先读代码给方案Plan Mode小范围改 UIAccept Edits涉及删除文件、改配置、打包发布Default需要手动确认新手不建议dangerously skip permissions7.2 Plan Mode 是什么Plan Mode 适合新手。它会先分析、列方案通常不会直接修改文件。你可以这样启动claude --permission-mode plan或者在会话中用Shift Tab切换到 Plan Mode。常用提示词请进入规划模式。先分析项目不要修改代码。请列出 1. 需要读取哪些文件 2. 可能要修改哪些文件 3. 修改原因 4. 风险点 5. 回滚方案8. 会话恢复和一次性提问8.1 继续上次会话回到同一个项目目录claude -c或者claude --continue8.2 恢复某个会话如果你知道会话名或会话 IDclaude -r browseveil-auth8.3 一次性问问题不进入交互模式适合快速分析一个文件claude -p 解释一下这个项目结构PowerShell 里把文件内容传进去Get-Content manifest.json | claude -p 分析这个 Chrome 插件权限有没有风险适合脚本化处理Get-Content package.json | claude -p 告诉我这个项目有哪些启动命令9. CodeGraph 怎么配合 Claude CodeCodeGraph 的作用是给项目建立本地代码图谱让 AI 更容易理解调用链、函数关系、模块关系。9.1 安装和初始化npm i -g colbymchenry/codegraph codegraph install cd D:\your-project codegraph init初始化后会生成.codegraph/这个目录一般不要提交到 Git。在.gitignore里加.codegraph/9.2 初始化后做什么检查状态codegraph status试着查一下codegraph query manifest或者codegraph query background然后重启 Claude Code再在项目里问请优先使用 CodeGraph分析这个项目的整体结构。Chrome 插件可以这样问请优先使用 CodeGraph分析 popup 点击按钮到 background service worker 执行逻辑的完整调用链。 先不要修改代码。9.3 代码改了以后一般会自动同步。如果感觉 Claude 看到的不是最新代码可以手动同步codegraph sync10. 一定要写CLAUDE.mdCLAUDE.md就像给 Claude Code 的项目说明书。放在项目根目录。例如D:\projects\BrowseVeil\CLAUDE.md10.1 浏览器插件项目模板可以直接复制# Project Notes 这是一个 Chrome / Edge 浏览器插件项目使用 Manifest V3。 ## 基本规则 - 输出中文说明。 - 修改代码前必须先说明将要修改哪些文件。 - 不要随便新增 manifest permissions。 - 新增 host_permissions 前必须说明原因。 - 不要为了省事使用 all_urls。 - 不要新增远程上传用户隐私数据的逻辑。 - 所有功能优先本地处理。 - 修改 manifest.json 前必须解释原因。 - 涉及 cookies、proxy、webRequest、browsingData 权限时必须说明审核风险。 - 修改完成后必须输出测试步骤。 ## 常见目录 - manifest.json插件声明文件 - background/后台逻辑 - src/popup/弹窗页面 - content/注入页面脚本 - assets/ 或 icons/图标资源 ## Chrome 插件审核注意 - 避免过度权限。 - 避免不必要的远程代码。 - 隐私相关功能要有明确说明。 - UI 文案不要强调灰色用途。 - 商店说明要强调隐私保护、本地处理、用户主动授权。10.2 为什么它重要有了CLAUDE.md你不用每次都重复说这是 Chrome 插件不要乱加权限。Claude Code 每次进入项目时都会更容易理解你的项目规则。11. Chrome 插件开发专用提问模板11.1 项目体检请对这个 Chrome Manifest V3 插件做一次体检。 重点检查 1. manifest.json 权限是否过度 2. background service worker 是否有生命周期问题 3. popup 和 background 通信是否稳定 4. storage 数据结构是否清晰 5. content script 是否只在必要站点注入 6. 是否有 Chrome / Edge 商店审核风险 7. 是否有隐私政策需要补充的点 先分析不要修改代码。11.2 分析调用链请先用 CodeGraph 和项目搜索分析 1. popup 页面有哪些入口 2. 哪些消息发给 background 3. background 里监听了哪些事件 4. 哪些地方会修改 chrome.storage 5. 哪些地方会使用 cookies / proxy / browsingData 6. 最后画出调用链 先不要修改代码。11.3 修改功能前我要修改这个功能但请先不要改代码。 请先输出 1. 当前功能实现位置 2. 相关文件列表 3. 修改方案 4. 可能影响的功能 5. 是否会影响 manifest 权限 6. 是否会影响 Chrome / Edge 审核 7. 回滚方案11.4 修改完成后自检修改完成后请自己检查 1. 是否破坏 Manifest V3 2. 是否新增不必要权限 3. 是否影响已有 popup UI 4. 是否影响 background service worker 5. 是否影响已授权站点逻辑 6. 是否有语法错误 7. 给出我需要手动测试的步骤12. 让它别乱改的技巧12.1 限制文件范围本轮只允许分析和修改 src/popup 目录。 不要修改 background、manifest.json、content script。更严格一点本轮只允许修改 - src/popup/App.vue - src/popup/style.css 其他文件只能读取不能修改。12.2 让它先列文件先不要修改代码。先列出你准备读取的文件、准备修改的文件、修改原因和风险点。12.3 让它给回滚方案修改前请先说明回滚方案如果改坏了我应该恢复哪些文件。12.4 让它总结 diff改完后说请基于 git diff 总结本次修改并检查有没有误改无关文件。你自己也可以跑git diff13. Git 配合 Claude Code13.1 改代码前先确认干净git status如果有未提交内容先保存或提交。13.2 改完看差异git diff然后让 Claude 总结请解释当前 git diff告诉我每个文件改了什么有没有不必要的修改。13.3 改坏了回退回退某个文件git checkout -- path/to/file回退全部未提交修改git checkout -- .注意这会丢掉未提交修改谨慎使用。14. Debug 报错时怎么问不要只发一句报错了帮我修更好的写法这是报错 粘贴报错内容 这是我刚才的操作 我点击了 popup 里的 xxx 按钮 这是相关环境 Windows 10 Chrome 插件 Manifest V3 开发模式加载扩展 请先判断最可能原因不要直接修改代码。如果有截图这是截图[Image #1] 请结合截图和代码分析原因。如果有路径请分析这张截图C:\Users\admin\Desktop\error.png15. 适合小白的任务拆分方法不要一次说帮我把整个插件优化一下应该拆成第一步先分析项目结构不改代码。第二步只分析 manifest 权限风险不改代码。第三步只分析 popup 到 background 的消息通信不改代码。第四步给出修改方案。第五步只修改一个小功能。第六步输出测试步骤。这样更稳。16. Skills / Subagents / Hooks 是什么这三个是高级功能新手先知道概念就行。16.1 SkillsSkill 是一个可复用的能力包。比如你经常让 Claude 检查 Chrome 插件就可以写一个 Skill。示例目录.claude/skills/chrome-extension-review/SKILL.md示例内容--- name: chrome-extension-review description: Review Chrome extension Manifest V3 permissions, privacy risk, store compliance, and code structure. --- 你是 Chrome 扩展审核助手。 请检查 1. manifest.json 权限是否过度 2. 是否符合 Manifest V3 3. background service worker 是否合理 4. 是否有隐私风险 5. 是否有 Chrome Web Store 审核风险 6. 给出修改建议 输出中文。以后可以直接调用相关能力。16.2 SubagentsSubagent 是子代理适合让不同 AI 分工。比如请用一个子代理专门分析 background/service-worker.js 的消息流主会话不要改代码。适合大项目一个子代理看 UI一个子代理看 background一个子代理看 manifest 权限一个子代理看审核风险16.3 HooksHooks 是自动化规则比如每次改代码后自动运行npm run lint禁止修改某些目录禁止执行危险命令每次任务结束自动提醒你测试示例需求帮我写一个 Claude Code Hook每次修改 JS/TS 文件后自动运行 npm run lint。新手建议后面再折腾 Hooks先把基础流程用熟。17. 推荐的固定工作流17.1 每次开始请先读取 CLAUDE.md、manifest.json 和项目目录结构。 先不要修改代码。 请告诉我项目入口、关键模块、可能风险。17.2 改功能前先不要修改代码。 请列出当前功能涉及的文件、调用链、修改方案、风险点和回滚方案。17.3 确认后再改按方案修改。只允许修改你刚才列出的文件不要改其他文件。17.4 改完后请输出 1. 修改了哪些文件 2. 每个文件改了什么 3. 是否影响 manifest 权限 4. 是否影响 Chrome / Edge 审核 5. 手动测试步骤 6. 如果有问题如何回滚17.5 做完一个大任务/compact 只保留当前功能的修改方案、已改文件、测试步骤和遗留问题。或者直接/clear18. 浏览器插件开发特别注意你做 Chrome / Edge 插件时下面几条尤其重要18.1 不要乱加权限危险或敏感权限包括cookies proxy webRequest browsingData declarativeNetRequest tabs scripting all_urls不是不能用而是要说明清楚为什么用。18.2 不要让 Claude 为了省事加all_urls要经常提醒不要为了省事新增 all_urls如果必须新增 host_permissions先说明原因和替代方案。18.3 background service worker 容易有生命周期问题Manifest V3 的 background 是 service worker不是一直常驻页面。问 Claude 时可以加请特别检查 Manifest V3 background service worker 生命周期问题例如异步任务、事件监听、storage 读写是否可靠。18.4 popup 关闭后状态会丢popup 页面不是一直存在。关闭 popup 后页面上下文会消失。可以问请检查 popup 页面是否把重要状态正确保存到 chrome.storage而不是只保存在内存变量中。18.5 审核文案要强调正向用途比如你的 BrowseVeil 这类插件推荐强调隐私保护本地处理用户主动授权站点级隔离防追踪不上传隐私数据不要突出灰色用途例如账号多开绕过检测规避风控19. 常见问题排查19.1 Claude Code 粘贴不了图片优先试Alt V不行就保存图片发路径C:\Users\admin\Desktop\error.png19.2 终端快捷键异常执行/terminal-setup或者换 Windows Terminal。19.3 Claude 越聊越乱执行/clear或者/compact19.4 它改了不该改的文件先看git diff然后让它解释请解释当前 git diff并指出有没有误改无关文件。19.5 它读了太多无关文件你要限制范围本轮只允许读取和修改 src/popup 目录其他目录不要动。19.6 它一直猜你要说不要猜。请先搜索项目代码找到真实实现位置后再回答。19.7 它直接开始改代码你要打断Esc然后说停止修改。请先给方案不要继续改代码。20. 给小白的 10 条核心口诀开始前先说先分析不要修改代码。改代码前先让它列要读哪些文件、要改哪些文件。大功能先用Plan Mode。聊乱了用/clear。会话长了用/compact。粘贴图片用Alt V。输入多行用Ctrl J。修改后一定看git diff。Chrome 插件不要乱加permissions / host_permissions /all_urls。每个项目都写CLAUDE.md。21. 一份可直接复制的总提示词以后你新开一个 Claude Code 会话可以直接复制下面这段你现在是一个谨慎的项目代码分析助手。 请先不要修改代码。 请先完成 1. 读取 CLAUDE.md如果存在的话 2. 分析项目目录结构 3. 找出主要入口文件 4. 如果是 Chrome 插件请重点分析 manifest.json、popup、background、content script 5. 列出当前项目可能的风险点 6. 列出你建议下一步读取的文件 7. 不要修改任何文件等我确认 输出中文适合小白理解。如果是 Chrome 插件再加特别要求 - 不允许随意新增 manifest permissions - 不允许为了省事使用 all_urls - 修改 manifest.json 前必须说明原因 - 涉及 cookies、proxy、webRequest、browsingData 时必须说明审核风险 - 所有功能优先本地处理不要新增上传用户隐私数据的逻辑22. 官方资料入口下面是整理时参考的官方文档入口。以后功能变化时优先看官方文档。Claude Code Interactive ModeInteractive mode - Claude Code DocsClaude Code CLI ReferenceCLI reference - Claude Code DocsClaude Code Common WorkflowsCommon workflows - Claude Code DocsClaude Code CommandsCommands - Claude Code DocsClaude Code Memory / CLAUDE.mdHow Claude remembers your project - Claude Code DocsClaude Code KeybindingsCustomize keyboard shortcuts - Claude Code DocsClaude Code Terminal SetupConfigure your terminal for Claude Code - Claude Code DocsClaude Code SubagentsCreate custom subagents - Claude Code DocsClaude Code SkillsExtend Claude with skills - Claude Code DocsClaude Code HooksHooks reference - Claude Code DocsClaude Code Best PracticesBest practices for Claude Code - Claude Code DocsClaude Code TroubleshootingTroubleshooting - Claude Code Docs