> ## Documentation Index
> Fetch the complete documentation index at: https://docs.happycapy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CLAUDE.md

> 使用 CLAUDE.md 为 Happycapy 的 Project 设置稳定指令。

## CLAUDE.md 是什么？

`CLAUDE.md` 是一个项目指令文件。你可以用它告诉 Happycapy：在回到同一个 Project 时，需要记住什么、怎么工作、遵守哪些规则。

你不需要把它当成代码。可以把它理解成这个 Project 的长期 brief：受众、语气、输出规则、文件位置，以及后续 session 都应该延续的检查习惯。

Happycapy 可以帮你创建或更新 `CLAUDE.md`。你也可以打开 **Files**，选中文件，然后直接编辑。

创建 Project 并开始工作后，打开 **Files** 就能看到 Project workspace。`CLAUDE.md` 会和上传的源文件、生成的输出放在一起，所以后续 session 可以复用同一套指令。

<div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(240px, 1fr))', gap: '0', margin: '1.25rem 0 1.5rem', border: '1px solid rgba(46, 41, 41, 0.12)', borderRadius: '8px', overflow: 'hidden', background: '#fff' }}>
  <div style={{ borderRight: '1px solid rgba(46, 41, 41, 0.1)', background: '#fbfaf7', minHeight: '260px' }}>
    <div style={{ padding: '14px 16px', borderBottom: '1px solid rgba(46, 41, 41, 0.1)' }}>
      <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px', padding: '8px 12px', borderRadius: '8px', background: '#eeece9', color: '#2e2929', fontWeight: 650 }}>
        <span style={{ color: '#6f6a64', display: 'inline-flex', alignItems: 'center' }}>
          <svg aria-hidden="true" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" style={{ flex: 'none' }}>
            <path d="M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z" />
          </svg>
        </span>

        Files
      </span>
    </div>

    <div style={{ padding: '16px' }}>
      <div style={{ marginBottom: '12px', color: '#a09a93', fontSize: '0.78rem', fontWeight: 750, letterSpacing: '0.08em', textTransform: 'uppercase' }}>Project workspace</div>

      <div style={{ display: 'grid', gap: '4px', color: '#6e6861', fontSize: '0.95rem' }}>
        <div style={{ display: 'flex', alignItems: 'center', gap: '8px', padding: '6px 8px' }}><span>›</span><span>memory/</span></div>
        <div style={{ display: 'flex', alignItems: 'center', gap: '8px', padding: '6px 8px' }}><span>›</span><span>outputs/</span></div>
        <div style={{ display: 'flex', alignItems: 'center', gap: '8px', padding: '6px 8px' }}><span>›</span><span>uploads/</span></div>

        <div style={{ display: 'flex', alignItems: 'center', gap: '8px', padding: '7px 8px', borderRadius: '8px', background: '#f1efec', color: '#2e2929', fontWeight: 650 }}>
          <span style={{ color: '#6f6a64', display: 'inline-flex', alignItems: 'center' }}>
            <svg aria-hidden="true" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" style={{ flex: 'none' }}>
              <path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7Z" />

              <path d="M14 2v4a2 2 0 0 0 2 2h4" />

              <path d="M10 9H8" />

              <path d="M16 13H8" />

              <path d="M16 17H8" />
            </svg>
          </span>

          <span>CLAUDE.md</span>
        </div>
      </div>
    </div>
  </div>

  <div style={{ minHeight: '260px', background: '#ffffff' }}>
    <div style={{ display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: '12px', padding: '14px 18px', borderBottom: '1px solid rgba(46, 41, 41, 0.1)' }}>
      <span style={{ color: '#8a8178', fontSize: '0.9rem' }}>CLAUDE.md</span>
      <span style={{ padding: '3px 8px', borderRadius: '999px', background: '#edf7f3', color: '#14745f', fontSize: '0.74rem', fontWeight: 700 }}>可编辑</span>
    </div>

    <div style={{ padding: '22px 24px' }}>
      <div style={{ margin: '0 0 16px', color: '#111', fontSize: '1.55rem', lineHeight: 1.1, fontWeight: 650 }}>Project instructions</div>
      <p style={{ margin: 0, color: '#4f4a45', lineHeight: 1.65 }}>告诉 Happycapy 在这个 Project 中需要记住什么、遵守什么。</p>
      <div style={{ marginTop: '24px', paddingTop: '16px', borderTop: '1px dashed rgba(46, 41, 41, 0.22)', color: '#8a8178', fontSize: '0.92rem' }}>在这里添加稳定的项目规则。</div>
    </div>
  </div>
</div>

## 什么时候使用它

当某条说明能帮助同一个 Project 的后续 session 时，就适合把它加入 `CLAUDE.md`。

常见情况包括：

* 你已经不止一次纠正 Happycapy 同一个问题。
* 这个 Project 有你不想每次重复说明的规则。
* 后续工作需要同样的受众、语气、文件位置或审核标准。
* 其他人打开这个 Project 时，也需要这些上下文才能得到有用结果。

一次性的任务细节留在当前消息里。稳定的 Project 上下文放进 `CLAUDE.md`。

## 编写 Happycapy 能遵循的指令

`CLAUDE.md` 会指导 Happycapy，但它不是强制开关。清晰、具体的说明比宽泛偏好更容易被稳定遵循。

| 模糊写法        | 更好的写法                |
| ----------- | -------------------- |
| 把文案写好一点。    | 用简洁、清楚的中文写面向客户的文案。   |
| 把文件存到合适的地方。 | 把最终文件保存到 `/outputs`。 |
| 检查一下工作。     | 结束前列出修改过的文件和剩余风险。    |
| 遵循品牌风格。     | 以已上传的品牌指南作为语气和术语的准则。 |

有用的 `CLAUDE.md` 通常较短，用标题分组，并且容易扫读。

```text theme={null}
把以下内容加入这个 Project 的 CLAUDE.md：

## Writing
- 用清晰、简洁的中文写面向客户的文案。
- 避免空泛宣传，除非它和具体用户任务有关。

## Files
- 把最终交付物保存到 /outputs。
- 报告和导出文件名中包含日期。

## Review
- 修改价格、法律或公开发布文案前先询问我。
- 结束前列出修改过的文件和剩余风险。
```

你也可以让 Happycapy 检查这个文件：

```text theme={null}
Review this Project's CLAUDE.md. Tell me what instructions are unclear, stale, or too broad.
```

## Project 和全局指令

大多数 Project 只需要在 Project workspace 中放一个 `CLAUDE.md` 文件。只有在确实需要区分作用范围时，才使用更广的路径。

| 位置                             | 用途                                                       | 不适合放                   |
| ------------------------------ | -------------------------------------------------------- | ---------------------- |
| Project 中的 `CLAUDE.md`         | 单个 Project 的指令                                           | 会影响每个 Project 的个人默认设置  |
| `/home/node/.claude/CLAUDE.md` | 你希望 Happycapy 在多个 Project 中复用的个人默认设置，例如语言、语气、摘要风格和进度更新方式 | Project 事实、客户数据和临时任务细节 |

<Tip>
  想让同一个偏好适用于多个 Project？直接让 Happycapy 更新 `/home/node/.claude/CLAUDE.md`。例如：“Set my global CLAUDE.md so Happycapy defaults to Chinese, keeps progress updates concise, and asks before changing public-facing copy.”
</Tip>

如果不确定某条内容该放在哪里，先从 Project 的 `CLAUDE.md` 开始。让这个文件只关注会影响该 Project 后续大部分工作的指令。

## 相关资源

* [Projects](/zh/features/projects)：围绕长期工作组织 sessions 和文件
* [Files](/zh/features/files)：管理上传文件和生成文件
* [Skill Store](/zh/features/skill-store)：安装可复用的工作流
* [Automations](/zh/features/automations)：安排重复任务