> ## 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` は Project の指示ファイルです。同じ Project に戻ったときに、Happycapy が何を覚え、どのように作業し、どのルールに従うべきかを伝えるために使います。

コードとして扱う必要はありません。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 }}>この Project で Happycapy が覚えて従うべき内容を書きます。</p>
      <div style={{ marginTop: '24px', paddingTop: '16px', borderTop: '1px dashed rgba(46, 41, 41, 0.22)', color: '#8a8178', fontSize: '0.92rem' }}>安定した Project ルールをここに追加します。</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 に 1 つの `CLAUDE.md` があれば十分です。より広い場所は、範囲を分ける必要がある場合だけ使います。

| 場所                             | 用途                                                          | 入れないもの                        |
| ------------------------------ | ----------------------------------------------------------- | ----------------------------- |
| Project 内の `CLAUDE.md`         | 1 つの 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 Japanese, keeps progress updates concise, and asks before changing public-facing copy."
</Tip>

どこに置くべきかわからない場合は、Project の `CLAUDE.md` から始めます。その Project の今後の大半の作業に適用される指示に絞ってください。

## 関連リソース

* [Projects](/ja/features/projects): 継続的な作業ごとに sessions とファイルを整理する
* [Files](/ja/features/files): アップロード済みファイルと生成ファイルを管理する
* [Skill Store](/ja/features/skill-store): 再利用できるワークフローをインストールする
* [Automations](/ja/features/automations): 繰り返し作業をスケジュールする