什么是项目制

用过网页版 ChatGPT 或 Claude.ai 的人习惯了'打开一个对话窗 → 输入问题 → 拿到答案 → 关掉就没了'。Claude Code 不一样：它始终在一个具体的文件夹里工作，这个文件夹就是一个项目。所有交互都围绕这个文件夹展开。

项目制 = Claude Code 锁在一个文件夹里干活

终端

han@mac ~ %

你的电脑

Claude 的工作范围

（Claude Code 未启动，没有锁定的工作目录）

范围以外（看不到）

~/papers/another-project/

~/Documents/2024-tax-return.pdf

~/Downloads/random-stuff.zip

~/photos/2025-trip/

默认状态：Claude Code 还没启动

你的电脑里有很多文件夹：耐心资本项目、其他论文、税务文档、下载、照片。Claude Code 还没启动，它现在什么都看不到。

1/6

一个项目就是一个文件夹

在 Claude Code 里，'项目'不是一个抽象概念，就是你硬盘上的一个文件夹。本指南用一个具体的实证项目'耐心资本对企业 ESG 表现的影响'贯穿，它的文件夹叫 ~/papers/pc-esg/。如果你同时手上还有一个 meta 分析项目，就在 ~/papers/meta-analysis/ 另开一个。两者完全独立。

你启动 Claude Code 之前先 cd 进入这个文件夹，再敲 claude。Claude Code 启动后，整个会话的工作目录就锁在这个文件夹里。它能读这个文件夹下的所有文件，可以在这个文件夹里创建新文件，可以跑这个文件夹下的 .do 脚本。文件夹外的东西它看不到——除非你明确指定路径让它去读，比如 /Users/han/Demonstration_Data/EmpiricalWiki/。

这种'锁在文件夹里工作'的特性叫工作目录（working directory）。是 Claude Code 跟网页版聊天工具最大的区别。

耐心资本 → ESG 这个项目的文件夹长什么样

~/papers/pc-esg/
├── CLAUDE.md                       ← 给 Claude 的项目说明（保护清单 + A2 主测度等）
├── checkpoint.md                   ← 跨会话进度记录
├── 01_文献/                        ← 文献 PDF + 8 框架索引
├── 02_变量字典/                    ← 测算方法说明.md / 变量对照表.xlsx
├── 03_原始数据/                    ← CSMAR + 华证 ESG + 管理者短视主义
├── 04_中间数据/
│   ├── main_panel.dta              ← 主面板 26874 obs, 3608 firms
│   ├── csmar_panel.dta
│   └── 耐心资本_七合一_WZY.dta
├── 05_分析代码/
│   └── 耐心资本-全套代码.do        ← do0_setup → do10_robust
├── 06_结果输出/
│   ├── tables/                     ← Table 1–10 (RTF)
│   └── tables_tsv/                 ← Table 1–10 (CSV 可读版)
├── 07_论文写作/
│   ├── 01_主表/
│   └── 02_文献综述/
└── .git/                           ← git 版本历史

为什么用文件夹做项目边界

把所有项目相关的东西放在同一个文件夹里，意味着 Claude Code 在这个会话里只关心耐心资本 → ESG 这一件事。它不会去你的另一篇论文里翻东西，也不会读你的浏览器历史。研究上你同时手上有 3-4 个实证项目很正常，每个一个文件夹，对应 3-4 个独立的 Claude Code 会话，互不干扰。

文件夹边界也是天然的隔离边界。某一天你想试一种新的 PC 测度（比如把 A2 换成 B1）但怕弄坏主回归，你 cp -r ~/papers/pc-esg ~/papers/pc-esg-experiment 复制一份，再在新文件夹里启动 Claude Code 折腾。原始项目完好。

git 版本历史天然属于这个文件夹。每次 commit 都记录这个项目当时的状态。需要回到 phase 1 刚结束的版本，git checkout 一下就回去了。Claude Code 跟 git 配合得非常紧——它会主动建议你定期 commit，也能帮你看 git log 回忆当时改了什么。

项目文件夹里要放什么、不要放什么

放进去：论文源文件（.tex / .docx）、数据（.dta、原始 .xlsx、CSMAR zip）、脚本（do、R、Python 都可以）、参考文献库（.bib）、给 Claude 的说明文件（CLAUDE.md）、进度文件（checkpoint.md）、跟导师讨论的会议记录。这些都是项目本身的一部分，Claude 干活时需要随时看到。

不要放进去：体积很大的中间产物（比如几 GB 的 Bootstrap 全部置换样本），可以放在文件夹外用绝对路径引用。不要放敏感数据（受试者隐私、未脱敏的微观调查数据），如果必须放，请加密或放进 .gitignore 防止被 git 跟踪。也不要放跟这个项目完全无关的文件，会污染 Claude 的工作上下文。

实操建议：你不确定要不要放进去的东西，先放着；只要 Claude Code 偶尔会需要查到它，放进项目里就是合理的。Claude 不会主动读所有文件，它只在你提示需要时才去读，所以放多了不会浪费。

项目模式的好处一句话总结

网页聊天工具一问一答，关掉就没。Claude Code 一直待在你的耐心资本 → ESG 项目文件夹里，看得见你过去几个月跑完的 do0–do10、12 张三线表、phase 1 与 phase 2 的所有 Stata log，知道你定的 PC_A2 主测度，知道 KZ 是 WW 的替代。下次打开 Claude Code 进入同一个文件夹，它从你上次离开的地方接手。状态全在这个文件夹里：文件内容、git 历史、CLAUDE.md、checkpoint.md。模型本身不留任何东西。

新手最容易犯的几个坑

在错的文件夹里启动

在 ~/Downloads 里 claude 启动就会让 Claude Code 把 ~/Downloads 当成项目根目录。一定要先 cd 到 ~/papers/pc-esg 这种项目文件夹再启动。检查方法：启动后输入 pwd 看一下工作目录是不是对的。

在桌面随便开会话

桌面或 home 目录下启动会让 Claude 看到一堆零散文件，分不清哪些跟当前任务相关。把每个实证项目放在独立的命名清楚的文件夹里，启动 Claude 前先 cd 进去。

把项目文件夹搬来搬去

项目文件夹的路径变了，CLAUDE.md 里写死的绝对路径、.do 文件里用的相对路径都可能失效。搬动前先 git commit 保存当前状态，搬完后启动 Claude Code 检查一遍它能不能正常读到 main_panel.dta 等主要文件。