> ## 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 Traditional Chinese, keeps progress updates concise, and asks before changing public-facing copy.」
</Tip>

如果不確定某條內容該放在哪裡，先從 Project 的 `CLAUDE.md` 開始。讓這個檔案只關注會影響該 Project 後續大部分工作的指令。

## 相關資源

* [Projects](/zh-Hant/features/projects)：圍繞長期工作組織 sessions 和檔案
* [Files](/zh-Hant/features/files)：管理上傳檔案和產生檔案
* [Skill Store](/zh-Hant/features/skill-store)：安裝可重用的工作流程
* [Automations](/zh-Hant/features/automations)：安排重複任務