Claude Code 上手指南

Appearance

第 7 章：技巧与 FAQ ​

7.1 几个一定要知道的小技巧 ​

技巧 1：把 CLAUDE.md 当作"AI 的小抄" ​

在你常用的工作文件夹里新建一个文件 CLAUDE.md，写上：

我在 XX 公司，岗位是 XX，主要负责 XX 业务方向。
我们公司主营产品是 XX，年营业额规模在 XX 级。
所有面向上级 / 集团的输出请使用克制、数字优先、避免空洞表态的风格。
所有日期使用 YYYY-MM-DD 格式。
所有金额单位统一为人民币（万元）。
对外文章中涉密信息按既定脱敏规则处理。

之后在这个文件夹里跟 Claude Code 对话，它会自动遵守这些规则，不用你每次重新交代。

这一招效果最大

CLAUDE.md 是个被严重低估的功能。建议在常用工作目录下花 10 分钟写一份，之后每次对话的产出质量都会显著提升。

技巧 2：不放心的事先用"计划模式" ​

在 Claude Code 输入框里按一次 Shift+Tab，会切到 Plan Mode（计划模式）。这种模式下它只会先告诉你打算怎么做，不会真的修改文件。你看一遍觉得没问题再让它执行。

适合： 第一次让它处理重要客户文件、第一次跑批量改写任务、要动多个文件的复杂指令。

技巧 3：用 "@" 快速引用文件 ​

在对话框里输入 @，会弹出当前文件夹里的所有文件让你选。比手动打文件名更快、不容易出错。

/月度摘要 @周报素材.txt

技巧 4：对话太长就开新窗口 ​

同一个对话窗口聊太久（比如几十轮），它会越来越慢、越来越容易跑偏。点击对话面板顶部的 "+" 开一个新会话即可。

重要的中间结论记得让它先存到 md 文件里，新会话时再把文件喂回去。

技巧 5：用"工作文件夹"组织日常 ​

工作文件夹组织建议：

~/work/
├── 每月例行/
│   ├── CLAUDE.md          ← 月度任务的统一规则
│   └── 周报素材-202X-XX.txt
├── 客户A/
│   ├── CLAUDE.md          ← 客户背景、负责人、注意事项
│   ├── 拜访记录.md
│   └── 案例文章草稿.md
├── 行业大会-2026 上海/
│   ├── 演讲稿.md
│   └── PPT 大纲.md
└── 我的指令库/
    ├── 研报压缩.txt
    └── KOL邀请.txt

每个项目 / 客户一个文件夹，里面放一份 CLAUDE.md。打开哪个文件夹，AI 就自动进入那个上下文。

技巧 6：把高频任务封装成插件 ​

如果一件事每月做 3 次以上，就值得把对应的指令模板封装成插件 / 自定义命令（参考第 5 章）。一次投入 10 分钟，未来一年用 30+ 次。

7.2 常见问题 FAQ ​

Q1：我电脑配置很差，能跑吗？ ​

完全没问题。Claude Code 真正干活的是 Anthropic 云端的大模型，你电脑只负责发指令、收结果，性能消耗几乎为零。

Q2：网络要怎么配？公司不能直连 Anthropic 怎么办？ ​

联系公司 IT 或管理员，他们会发给你一个 ANTHROPIC_BASE_URL（公司内部网关地址）和 ANTHROPIC_AUTH_TOKEN，按 第 3 章 的方式写到 settings.json 即可。

Q3：我的客户资料 / 内部数据能丢给它吗？会不会泄露？ ​

默认情况下，对话内容会发送到 Anthropic 服务器。强烈建议遵循公司数据合规要求：

  • 涉密客户合同、人员身份证、未公开财务数据等敏感资料不要直接喂
  • 公司如果部署了内部网关（见 Q2），按要求走内部通道
  • 涉及客户信息的对外内容，默认走脱敏处理（见第 6 章 6.5 客户案例的占位规则）
  • 不确定的资料先咨询合规 / IT 部门

Q4：装完后 VS Code 找不到 Claude Code 图标？ ​

依次检查：

  1. 第 2 章的扩展是否真的安装成功（扩展页搜索 Claude Code，看是否显示"已安装"）
  2. 是否需要重启 VS Code
  3. 在扩展页找到 Claude Code，点齿轮图标 → "禁用" → 再"启用"
  4. 仍然不行：联系 IT，可能是网络 / 权限问题

Q5：每次打开 VS Code 都要重新登录？ ​

用 第 3 章方式 A 中"持久化"小节的方法，把 Key 写到 settings.json 里，登录信息就会持久化，永远不用再登录。

Q6：插件装了，但 /命令 怎么不出现？ ​

依次检查：

  1. 在对话面板输入 /plugin → "Installed plugins"，确认插件确实在列
  2. 在对话面板执行 /reload-plugins 强制重新加载
  3. 关闭重开 VS Code 试一次
  4. 检查命令文件是否真的在 ~/.claude/commands/ 下，且文件名以 .md 结尾

Q7：我能不能让它分析图片 / 截图？ ​

可以。直接把图片文件（.png / .jpg）拖进对话面板，或者让它读取文件夹里的图片：

读 [发布会现场.jpg]，描述这场发布会的核心信息：主题、关键数字、台上人物的层级

Q8：可以让它读 Excel 吗？ ​

可以。.xlsx / .csv 都能直接读。处理大型 Excel 时建议先和它说清楚"我只关心 X / Y / Z 列"，避免它把所有列都读一遍浪费时间。

Q9：它有时回答得不对，怎么办？ ​

三步排查：

  1. 指令是否够具体？ "整理一下"太模糊；改成"按 A / B / C 三段、每段不超过 5 条"会立刻准确
  2. 资料是否完整？ 它没读到的东西就不知道。检查需要的文件是不是都已经放进当前文件夹
  3. 直接告诉它哪里错了。 不用客气，"第 3 条数字写错了，应该是 200 万不是 200 元，重写"

Q10：能不能让它自己发邮件 / 自己开微信发消息？ ​

标准安装下不能。这类自动化能力需要额外配置 MCP（一种连接外部系统的协议），属于进阶用法。

建议先用熟基础功能（前 6 章场景），再考虑接入 MCP。如果团队有强需求，可以让 IT 协助统一部署。

7.3 一页式速查表 ​

✅ 安装顺序：VS Code → Claude Code 扩展 → API Key
✅ 启动方式：左侧活动栏点击 Claude Code 图标
✅ 引用文件：在对话框里输入 @ 选择
✅ 让它先想清楚再做：Shift+Tab 切到 Plan Mode
✅ 给 AI 立规矩：在工作文件夹里写 CLAUDE.md
✅ 高频任务：封装成插件 / 自定义命令（第 5 章）
✅ 安全红线：API Key 不外发；客户敏感数据按合规要求处理

7.4 下一步推荐学习 ​

培训目标达成标志

你能在 5 分钟内，独立完成"打开一份工作素材 / 长篇文档 → 让 Claude Code 整理输出 → 保存成可向上汇报的文档"全过程；并且至少创建过 1 个属于自己的 /命令。

如果暂时还做不到，回头去做第 4 章的练习——只看不练永远学不会。

至此，整份《Claude Code 上手指南》全部学完。祝你用得顺手，业务长虹。