> ## 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

> Use CLAUDE.md to give Happycapy stable instructions for a Project.

## What is CLAUDE.md?

`CLAUDE.md` is a project instruction file. Use it to tell Happycapy what to remember, how to work, and what rules to follow when it returns to the same Project.

You do not need to treat it like code. Think of it as the standing brief for a Project: the audience, tone, output rules, file locations, and review habits that should stay true across sessions.

Happycapy can create or update `CLAUDE.md` for you. You can also open **Files**, select the file, and edit it directly.

After you create a Project and start working, open **Files** to see the Project workspace. `CLAUDE.md` sits alongside uploaded source files and generated outputs, so future sessions can reuse the same instructions.

<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 }}>Editable</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 }}>Tell Happycapy what to remember and follow when it works in this Project.</p>
      <div style={{ marginTop: '24px', paddingTop: '16px', borderTop: '1px dashed rgba(46, 41, 41, 0.22)', color: '#8a8178', fontSize: '0.92rem' }}>Add stable project rules below this line.</div>
    </div>
  </div>
</div>

## When to use it

Add something to `CLAUDE.md` when it should help future sessions in the same Project.

Good reasons include:

* You corrected Happycapy for the same thing more than once.
* The Project has rules you do not want to repeat every time.
* Future work needs the same audience, tone, file location, or review standard.
* Someone else opening the Project would need this context to get useful results.

Keep one-off task details in the current message. Put stable Project context in `CLAUDE.md`.

## Write instructions Happycapy can follow

`CLAUDE.md` guides Happycapy. It is not a hard safety switch, so clear and specific instructions work better than broad preferences.

| Vague                           | Better                                                                         |
| ------------------------------- | ------------------------------------------------------------------------------ |
| Write better copy.              | Write concise customer-facing copy in plain English.                           |
| Save the file somewhere useful. | Save final files in `/outputs`.                                                |
| Check your work.                | Before finishing, list changed files and remaining risks.                      |
| Follow the brand.               | Use the uploaded brand guide as the source of truth for voice and terminology. |

A useful `CLAUDE.md` is usually short, grouped with headings, and easy to scan.

```text theme={null}
Add this to this Project's CLAUDE.md:

## Writing
- Write customer-facing copy in clear, concise English.
- Avoid hype unless it is tied to a concrete user task.

## Files
- Save final deliverables in /outputs.
- Include the date in filenames for reports and exports.

## Review
- Ask before changing pricing, legal, or public launch language.
- Before finishing, list changed files and any remaining risks.
```

You can also ask Happycapy to review the file:

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

## Project and global instructions

Most Projects only need one `CLAUDE.md` file in the Project workspace. Use broader locations only when the distinction matters.

| Location                       | Use it for                                                                                                                 | Keep out                                                 |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| `CLAUDE.md` in a Project       | Instructions for one Project                                                                                               | Personal defaults that should affect every Project       |
| `/home/node/.claude/CLAUDE.md` | Personal defaults you want Happycapy to reuse across Projects, such as language, tone, summary style, and progress updates | Project facts, customer data, and temporary task details |

<Tip>
  Want the same preference to apply across Projects? Ask Happycapy to update `/home/node/.claude/CLAUDE.md`. For example: "Set my global CLAUDE.md so Happycapy defaults to Chinese, keeps progress updates concise, and asks before changing public-facing copy."
</Tip>

If you are unsure where something belongs, start with the Project `CLAUDE.md`. Keep the file focused on instructions that should apply to most future work in that Project.

## Related resources

* [Projects](/en/features/projects): organize sessions and files around ongoing work
* [Files](/en/features/files): manage uploaded and generated files
* [Skill Store](/en/features/skill-store): install reusable workflows
* [Automations](/en/features/automations): schedule recurring work