ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

Claude Code 入门:在笔记文件夹里整理资料并写好 CLAUDE.md

Claude Code 入门:在笔记文件夹里整理资料并写好 CLAUDE.md

适合人群:电脑里攒了一大堆 Markdown 笔记(比如用 Obsidian 或普通文件夹管理),想让 AI 帮忙整理、归类、写摘要,但从没用过 Claude Code 的同学。不会写代码也能跟着做,只需要会复制粘贴命令。需要说明:Claude Code 需要 Claude 的 Pro、Max、Team、Enterprise 订阅,或 Claude Console(API 预付费)账号才能使用;下文命令和按键以写作时 Claude Code 官方文档为准,界面文字可能随版本调整。

本文用一个场景贯穿:小周有一个名为 notes 的笔记文件夹,里面是两年来的读书摘录、课程笔记和零散想法,命名混乱、没有目录。目标是让 Claude Code 先读懂这个文件夹,再给出整理方案,确认后才动手,最后写一份 CLAUDE.md,让以后每次打开都记得这里的规矩。

一、动手前先备份

Claude Code 会直接读写你电脑上的文件。第一次用之前,先把笔记文件夹完整复制一份到别处。如果你会用 Git,在文件夹里执行一次git init并提交,以后回退会更方便。

官方文档也提到,Claude Code 不只能用于代码项目,在笔记库、文档文件夹等任何目录里都可以运行,用来搜索、编辑和整理 Markdown 文件。

二、安装并确认版本

官方推荐“原生安装”:macOS、Linux 和 WSL 在终端里运行一行 curl 安装命令,Windows 在 PowerShell 里运行对应的安装命令,具体命令请从官方 Quickstart 页面复制。也可以用包管理器:

brewinstall--caskclaude-code# macOS HomebrewwingetinstallAnthropic.ClaudeCode# Windows WinGet

装好后新开一个终端窗口,运行:

claude--version

能打印出版本号就说明安装成功。如果提示找不到 claude 命令,通常是安装目录还没加入 PATH,可以按官方“Troubleshoot installation”页面排查。另外,原生安装会在后台自动更新,Homebrew 和 WinGet 安装的版本需要自己手动升级。

三、在笔记文件夹里启动并登录

cd~/notes claude

第一次启动会提示登录,按提示在浏览器里完成授权即可,之后不用重复登录。看到输入框后,先问一个不会改动任何东西的问题:

用中文告诉我这个文件夹里大概有哪些内容,按主题分几类,各有多少篇

输入/help可以查看可用命令,输入/会列出所有命令。

四、看懂权限模式:先让它“只看不改”

输入框下方的状态栏会显示当前的权限模式。按 Shift+Tab 可以循环切换,官方文档列出的几种常见模式:

  • Manual(手动):除了读取文件,每个操作都要你点头;
  • accept edits:自动接受文件编辑和常见的文件操作命令;
  • plan:只读文件、给出方案,不做任何修改;
  • auto:较新版本在终端里默认可能就是这个模式,由分类器判断哪些操作可以直接执行。

对新手来说,建议整理笔记时先切到 plan 模式(状态栏显示 plan mode on),也可以直接用claude --permission-mode plan启动。

五、先出方案,确认后再动手

在 plan 模式下输入:

帮我设计一个笔记整理方案:按主题建文件夹,文件名统一成“日期-标题”格式, 列出每个文件准备移动到哪里、改成什么名字。先不要改任何文件。

Claude 会读文件并给出一份计划。按 Ctrl+G 可以在文本编辑器里直接修改这份计划,比如删掉你不想动的部分。确认没问题后批准计划,或按 Shift+Tab 退出 plan 模式,再让它执行。执行时注意看它请求的每一步操作,不确定的就拒绝。

六、写一份 CLAUDE.md

CLAUDE.md 是放在文件夹根目录的说明文件,Claude Code 每次启动都会读取。输入/init可以自动生成一份初稿;如果文件已存在,它会给出改进建议而不是直接覆盖。生成后打开它,补上你自己的规矩,例如:

- 所有回答和新建笔记使用中文 - 文件名格式:YYYY-MM-DD-标题.md - 不要删除任何笔记,需要合并时先列出方案等我确认 - 读书摘录放在 reading/,课程笔记放在 courses/

官方建议每个 CLAUDE.md 控制在 200 行以内,写得越具体、越简洁,遵循得越稳定。写完后可以运行/context确认文件已经加载。只是偶尔才用到的流程,适合以后做成技能,不必全部塞进 CLAUDE.md。

七、管理上下文和撤销修改

  • /clear:清空对话,切换到不相关的新任务时用。官方提到,同一个问题纠正两次还不对,就清空后换一个更具体的说法重来;
  • /compact:把长对话压缩成摘要,可以附上重点,例如“/compact 只保留整理规则”;
  • 连按两次 Esc 或输入/rewind:打开回退菜单,可以恢复对话、文件或两者。

注意:回退只覆盖 Claude 通过自己的编辑工具做的修改,通过命令行执行的改动(比如批量移动文件的命令)不会被记录,所以第一步的备份很重要。

八、常见问题 FAQ

Q1:免费账号能用吗?
官方 Quickstart 列出的账号类型是 Pro、Max、Team、Enterprise 订阅,或 Claude Console 等 API 方式,具体以官网说明为准。

Q2:和 Obsidian 同时打开会冲突吗?
官方说明.claude/目录和 CLAUDE.md 可以与其他工具的配置目录共存。Claude 每次读取文件时都会读最新内容,所以你在 Obsidian 里做的修改,它下次读取时就能看到。

Q3:不想用终端怎么办?
Claude Code 也提供桌面应用、网页版以及 VS Code、JetBrains 插件,基本概念相同。

九、小贴士

  • 第一次让它改文件时,先挑一个小子文件夹试,确认效果再扩大范围。
  • 提示词写清楚“不要删除”“先列方案”,比事后回退省事得多。
  • 日记、账号等隐私内容不要放进让 AI 处理的文件夹。
  • 不相关的任务之间用/clear隔开,回答质量会更稳定。

参考资料

  • Claude Code Docs:Quickstart
    https://code.claude.com/docs/en/quickstart
  • Claude Code Docs:Common workflows(Work in notes and non-code folders、Plan before editing)
  • Claude Code Docs:Choose a permission mode
  • Claude Code Docs:How Claude remembers your project
  • Claude Code Docs:Best practices for Claude Code
返回列表