世界從未停止變化。RSS
BIG CHANGE.
BIG CHANGE，輕觸即達
BIG CHANGE，輕觸即達

拉開視野。

將 BIG CHANGE 加入主畫面或桌面。它會在自己的視窗中開啟，並在您上線時顯示最新報導。

iPhone 與 iPad
在 Safari 中開啟 bigchange.ai。點一下「分享」，再點一下「加入主畫面」。如果顯示「以網頁 App 開啟」，請將其開啟，再點一下「加入」。
Android
在 Chrome 中開啟 bigchange.ai。開啟瀏覽器選單，選擇「安裝應用程式」或「加入主畫面」。
桌面裝置
在 Chrome 或 Edge 中，使用網址列中的安裝圖示或瀏覽器的應用程式選單。在 Mac 上的 Safari 中，選擇「檔案」→「加入 Dock」。

Markdown 版本

AI-translated from English; not yet reviewed by a fluent editor.

# 檢查兩個客戶專案中的 Claude Code 指令作用範圍

> 比較兩個全新 Claude Code 專案工作階段載入的指令，再驗證獲准讀取檔案後，巢狀指令檔案何時加入上下文。

By BIG CHANGE Editorial

Published: 2026-10-20T00:44:54.031Z
Updated: 2026-10-20T00:44:54.031Z
Canonical: https://bigchange.ai/blog/claude-code-client-project-instruction-scope-guide

![Conceptual charcoal illustration of two open filing drawers with separate blank folders; a smaller orange-edged folder is nested in the right drawer.](https://bigchange.ai/api/media/file/client-project-instruction-scope-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE; no actual client files, Claude Code interface or tested result is depicted.

Claude Code 可以同時從多個位置載入專案指令。如果你維護兩個客戶專案，在各自目錄啟動全新工作階段，就能查看哪些指令檔案實際進入各自的上下文。有用的結果是兩份記錄下來的檔案清單，而不是假定同層資料夾就能隔離客戶資訊。

## 關鍵改變

**改變了什麼：** 本指南將 Claude Code 文件中的指令階層，轉為可重複執行的比較，針對兩個現有且已授權的專案目錄。先記錄啟動時載入的檔案，再檢查獲准讀取檔案後是否出現巢狀指令檔案。

**為何重要：** 共同的上層目錄、個人指令、匯入、規則或設定都可能影響兩個專案。`/context`會顯示執行中工作階段已載入哪些記憶檔案，因此可以在處理客戶工作前調查意外路徑。

**應留意什麼：** 載入的指令不會限制 Claude 可以存取哪些檔案，也不保證它遵守每條指令。向選定供應商傳送客戶內容前，請審查實際帳戶、權限、匯入、hook 與資料使用條款。

## 所需條件

本流程適用於有權檢查兩個**現有**客戶儲存庫及其 Claude Code 設定的開發者。還須另行取得授權，才能把打算使用的具體專案內容傳送到所選 Claude 帳戶或供應商。只有本機檔案編輯權限，並不代表允許傳送。你需要終端機存取、已安裝的 Claude Code、符合條件的帳戶或供應商，以及某個專案子目錄中現有且不含敏感資訊的檔案。請查閱 Anthropic 的[安裝](https://code.claude.com/docs/en/setup)、[費用](https://code.claude.com/docs/en/costs)與[資料使用](https://code.claude.com/docs/en/data-usage)文件，確認所用存取途徑的要求。

下方目錄結構顯示要確認的路徑，並非要求新建客戶專案。請將指令中的每個示意路徑換成真實且已授權的路徑。上層目錄的`CLAUDE.md`是選用項目，只應包含兩個專案都核准的指令。巢狀檔案與無敏感資訊的文件，必須已適合所選帳戶的資料處理途徑。

```text
AUTHORIZED_PARENT/
  CLAUDE.md                 optional shared instructions
  project-A/
    CLAUDE.md               A's project instructions
  project-B/
    CLAUDE.md               B's project instructions
    subdir/
      CLAUDE.md             B's nested instructions
      README.md             authorized, nonsensitive read target
```

## 1. 解析兩個專案路徑

請**擇一使用** PowerShell 或 Bash。將變數設為兩個實際目錄。檢查要求路徑已存在、比較解析後的路徑字串，並確認 B 的讀取目標存在。PowerShell 的`Resolve-Path`可能保留符號連結或目錄接合的別名；字串不同，還不足以證明是兩個實體不同的專案。檢查兩個啟動路徑及所有上層目錄中的連結與接合，追蹤目標，確認 A、B 確實不同後再繼續。將路徑、目標檢查及後續上下文清單保存在私人工作紀錄。

```powershell
$a = (Resolve-Path -LiteralPath 'C:\actual\authorized\project-A' -ErrorAction Stop).Path
$b = (Resolve-Path -LiteralPath 'C:\actual\authorized\project-B' -ErrorAction Stop).Path
if (-not (Test-Path -LiteralPath $a -PathType Container)) { throw 'A must be an existing directory' }
if (-not (Test-Path -LiteralPath $b -PathType Container)) { throw 'B must be an existing directory' }
if ($a -eq $b) { throw 'A and B must be different directories' }
$target = Join-Path $b 'subdir/README.md'
if (-not (Test-Path -LiteralPath $target -PathType Leaf)) { throw 'Choose an existing authorized nonsensitive file in B/subdir' }
$a
$b
$target
```

```bash
a=$(realpath -- /actual/authorized/project-A) || exit 1
b=$(realpath -- /actual/authorized/project-B) || exit 1
test -d "$a" || { printf '%s\n' 'A must be an existing directory' >&2; exit 1; }
test -d "$b" || { printf '%s\n' 'B must be an existing directory' >&2; exit 1; }
test "$a" != "$b" || { printf '%s\n' 'A and B must be different directories' >&2; exit 1; }
target="$b/subdir/README.md"
test -f "$target" || { printf '%s\n' 'Choose an existing authorized nonsensitive file in B/subdir' >&2; exit 1; }
printf '%s\n' "$a" "$b" "$target"
```

若兩個專案不是同層目錄，請分別記錄實際上層目錄鏈。不要依示意圖推論存在共同父目錄。

## 2. 開啟專案前審查可能載入的來源

針對**每個**解析後的啟動目錄，檢查`CLAUDE.md`、`.claude/CLAUDE.md`、`CLAUDE.local.md`、`AGENTS.md`與`.claude/AGENTS.md`，包括該目錄與一路到檔案系統根目錄的各層上層目錄。也要檢查作業系統的受管理指令、`~/.claude/CLAUDE.md`、使用者規則與專案的`.claude/rules/`檔案。[記憶手冊](https://code.claude.com/docs/en/memory)說明找到的`CLAUDE.md`檔案內容會串接；較近的檔案不會清除上層文字。巢狀的`CLAUDE.md`通常會在 Claude 讀取、寫入或編輯同目錄的其他檔案後載入。限定路徑的規則，可在存取符合條件的檔案時載入。

這些指令只列出路徑，提供上層目錄清單，不顯示檔案內容。審查找到的檔案時，須有相關擁有者授權。兩個變數都要檢查；Bash 迴圈會自動處理兩者。

```powershell
foreach ($start in @($a, $b)) {
  $dir = [System.IO.DirectoryInfo]::new($start)
  while ($null -ne $dir) {
    Get-Item -LiteralPath $dir.FullName -Force | Select-Object FullName,LinkType,Target
    foreach ($name in @('CLAUDE.md', 'CLAUDE.local.md', 'AGENTS.md', '.claude/CLAUDE.md', '.claude/AGENTS.md')) {
      $candidate = Join-Path $dir.FullName $name
      if (Test-Path -LiteralPath $candidate -PathType Leaf) { $candidate }
    }
    $dir = $dir.Parent
  }
}
```

```bash
for start in "$a" "$b"; do
  dir=$start
  while :; do
    for name in CLAUDE.md CLAUDE.local.md AGENTS.md .claude/CLAUDE.md .claude/AGENTS.md; do
      test -f "$dir/$name" && printf '%s\n' "$dir/$name"
    done
    test "$dir" = / && break
    dir=$(dirname -- "$dir")
  done
done
```

閱讀實際指令檔案及其`@path`匯入；相對匯入從包含它的檔案位置解析。追蹤每個 PowerShell 啟動路徑與上層目錄鏈中的符號連結或目錄接合，再同時審查命名階層和目標階層中可能影響工作階段的來源。檢查指令檔案的符號連結目標，以及`claudeMdExcludes`模式。檢查`.claude/settings.json`、`.claude/settings.local.json`、使用者與受管理設定、任何`--settings`或`--setting-sources`啟動選項、已設定的 hook 和各專案信任狀態。`CLAUDE_CONFIG_DIR`可能改變使用者設定資料夾位置，因此不要直接假定是`~/.claude`。接受工作區信任前，查看 hook 可能執行的指令。工作目錄外的匯入可能要求核准；遭拒的匯入不會如預期出現。[設定手冊](https://code.claude.com/docs/en/settings)解釋每個設定來自哪一層，以及哪些專案設定須等待信任。

檢查**Project instructions**在`/config`中的選項，或對應的使用者／受管理外掛設定。目前 Claude Code 文件將`AGENTS.md`描述為有條件的備援：當專案或上層目錄沒有符合條件的`CLAUDE.md`或`CLAUDE.local.md`時使用；`claude-md-and-agents-md`會同時載入兩者。直接支援`AGENTS.md`取決於版本與啟用的外掛。舊版及某些設定可能略過它，BIG CHANGE 的[AGENTS.md 功能旗標報導](https://bigchange.ai/blog/claude-code-agents-md-telemetry-feature-flags)就涵蓋特定版本的問題。請使用實際版本、設定與`/context`結果，不要假定一律載入。

分別記錄`--add-dir`引數與`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD`。`--add-dir`會擴大檔案存取範圍，但預設不載入額外目錄的`CLAUDE.md`。環境開關會啟用新增目錄的指令載入。透過`/memory`把自動記憶當成獨立管道檢查：同一儲存庫的 worktree 和子目錄可能共用它，儲存位置也可被覆寫。解讀比較前，檢查實際位置與內容。切勿把憑證或未公開客戶事實放入範例指令或公開紀錄。

啟動前，在將使用的同一 shell 中查看這些環境值。Bash 值為空表示未設定或空值；PowerShell 只列出已存在的變數。shell 值不能排除設定檔中的值，因此每個工作階段內還要確認生效設定。

```powershell
Get-Item Env:CLAUDE_CONFIG_DIR,Env:CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD -ErrorAction SilentlyContinue | Select-Object Name,Value
```

```bash
printf 'CLAUDE_CONFIG_DIR=%s\n' "${CLAUDE_CONFIG_DIR-}"
printf 'CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=%s\n' "${CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD-}"
```

## 3. 在專案 A 啟動全新工作階段

記錄`claude --version`及確切啟動指令。從 A 啟動新程序，不使用`--resume`或`--continue`。審查設定與 hook 後才接受信任。執行`/context` **之後再**要求 Claude 開啟 B 或任何巢狀檔案。記錄記憶檔案與規則下的確切路徑；清單用於核對包含哪些檔案，不能推論注入順序。使用`/memory`查看顯示的個人、專案與自動記憶項目和儲存位置，然後離開工作階段。

```powershell
claude --version
Set-Location -LiteralPath $a -ErrorAction Stop
claude
```

```bash
claude --version
cd -- "$a" && claude
```

在 Claude Code 內，`/status`識別生效設定的來源，`/permissions`顯示目前工具規則與來源。將它們與指令清單一起記錄：

```text
/context
/memory
/status
/permissions
/exit
```

依已審查設定和排除項目，應該出現適用於 A 和共同上層目錄的指令。B 專屬檔案不應屬於 A 的啟動階層。如果經匯入、連結、新增目錄或其他管道出現，請記錄機制。未出現不代表 B 的檔案無法存取。

## 4. 在 B 啟動獨立工作階段，再讀取巢狀檔案

在 B 使用**全新**Claude Code 程序，維持相同安裝版本與帳戶／供應商途徑。任何巢狀讀取前先記錄`/context`與`/memory`。只要求 Claude 讀取確切、已核准且無敏感資訊的檔案。在工作階段確認確實讀取後，再執行`/context`，比較包含的路徑。[手冊的載入規則](https://code.claude.com/docs/en/memory)預期 B 的`subdir/CLAUDE.md`會在 Claude 存取同目錄的另一檔案後加入上下文，除非設定、排除項目或特定版本行為改變結果。

```powershell
Set-Location -LiteralPath $b -ErrorAction Stop
claude
```

```bash
cd -- "$b" && claude
```

在 Claude Code 內，只有授權目標使用不同相對路徑時，才替換讀取要求：

```text
/context
/memory
/status
/permissions
Read only subdir/README.md. Tell me whether that exact file was read; do not open other files or display its contents.
/context
/exit
```

Claude Code 可能要求工具權限或提出其他動作。只核准明確授權的讀取，並確認工具真的開啟該檔案。光憑回覆宣稱讀過，並不足以作證。

## 5. 比較清單並釐清差異

建立私人表格，記錄解析後 A、B 路徑、儲存庫根目錄、Claude Code 版本、帳戶／供應商途徑、啟動指令、信任狀態、設定來源、額外目錄、指令與規則路徑、匯入、自動記憶位置，以及三份實際觀察的`/context`清單：A 啟動時、B 讀取前、B 讀取後。把每個預期檔案標為存在、缺少或未解釋。不要將客戶指令文字複製到公開報告。

若缺少預期檔案，先確認啟動目錄和實際檔案路徑。再檢查 Project instructions 設定、外掛／版本、`claudeMdExcludes`、`--setting-sources`、匯入及外部匯入核准、規則路徑模式、符號連結和已確認的巢狀讀取。出現意外檔案時，追蹤上層目錄、使用者或受管理指令、匯入、規則、hook、額外目錄記憶載入與自動記憶。共同上層目錄或個人指令可能是有意安排；是否適用兩個專案，取決於來源與內容。

只有取得相關客戶授權才能修改指令或設定。檢查提議差異，保留現有限制，變更後重新執行兩次全新工作階段觀察。若無法解釋某路徑，或無權查看某個來源管道，請暫停客戶工作，讓擁有者或管理員解決該具體疑點。

取得兩份啟動清單、B 已確認的巢狀讀取前後清單，並解釋所有重要意外路徑後，練習才完成。它確認的是這些工作階段觀察到的指令成員，而不是保密邊界、檔案存取隔離、保證服從，或模型使用指令的確切順序。若要查看並繼續現有對話，請參閱我們的[Claude Code 工作階段上下文指南](https://bigchange.ai/blog/claude-code-session-context-continue-guide)。

帳戶費用與用量限制取決於方案、驗證方式與供應商。Anthropic 的[費用指南](https://code.claude.com/docs/en/costs)提供目前條款。本文依文件編寫：BIG CHANGE 未查看客戶檔案、執行 A/B Claude 工作階段、測試模型結果，也未測量時間或費用。

## 來源與延伸閱讀

- [Anthropic：《Claude 如何記住你的專案》](https://code.claude.com/docs/en/memory)：指令作用範圍、匯入、巢狀載入、`AGENTS.md`、規則、排除項目、新增目錄、自動記憶與`/memory`。實際選項可能隨 Claude Code 版本變更。
- [Anthropic：《設定檔與優先順序》](https://code.claude.com/docs/en/settings)：使用者、專案、本機與受管理設定，包括`/status`、信任與 hook 設定。
- [Anthropic：《設定權限》](https://code.claude.com/docs/en/permissions)：`/permissions`顯示生效工具規則與來源；指令文字本身不會強制限制工具存取。
- [Anthropic：《探索上下文視窗》](https://code.claude.com/docs/en/context-window)：`/context`顯示即時工作階段已載入的記憶檔案；顯示的成員關係不能證明注入順序。
- [Anthropic：安裝、費用與資料使用](https://code.claude.com/docs/en/setup)：確認安裝和帳戶前提；另外閱讀所用途徑的[費用](https://code.claude.com/docs/en/costs)與[資料使用](https://code.claude.com/docs/en/data-usage)條款。

## Sources

- [Anthropic：Claude 如何記住你的專案](https://code.claude.com/docs/en/memory) — 受管理、使用者、專案和本機指令的主要手冊，涵蓋上層與巢狀載入、檔案累加、匯入、規則、AGENTS.md 備援與版本／設定限制、排除項目、額外目錄存取和記憶載入的差異，以及自動記憶。它描述文件規定的行為，不是兩個客戶工作階段的實際觀察結果。
- [Anthropic：設定檔與優先順序](https://code.claude.com/docs/en/settings) — 設定層級、CLAUDE_CONFIG_DIR、透過 /status 查看設定來源、本機設定、信任和 hook 的主要手冊。讀者須查看實際設定與既有 hook；本文未檢查客戶設定。
- [Anthropic：設定權限](https://code.claude.com/docs/en/permissions) — 說明 /permissions 可查看生效工具規則及其設定檔來源。指令檔本身不會強制控制工具存取；讀者只應核准已授權的巢狀檔案讀取。
- [Anthropic：探索上下文視窗](https://code.claude.com/docs/en/context-window) — 說明以 /context 即時查看已載入記憶檔案，並用 /memory 查看記憶。清單成員是本文提議的觀察內容；顯示順序不被當成模型注入順序。
- [Anthropic：進階設定](https://code.claude.com/docs/en/setup) — 供讀者自行操作 Claude Code 工作階段的安裝與帳戶／供應商前提。BIG CHANGE 未進行安裝或工作階段操作。
- [Anthropic：有效管理費用](https://code.claude.com/docs/en/costs) — 計費與限制隨方案、驗證和供應商而異。本指南不宣稱練習有固定價格、配額、節省時間或實測用量。
- [Anthropic：資料使用](https://code.claude.com/docs/en/data-usage) — 消費、商業和供應商途徑的資料處理不同。向模型提交具體專案內容前，必須有客戶授權；本文不宣稱通用隱私保證。
- [BIG CHANGE：如何檢查上下文並繼續 Claude Code 工作階段](https://bigchange.ai/blog/claude-code-session-context-continue-guide) — 關於繼續現有工作階段的相關報導。其任務不同於兩個專案全新工作階段的指令比較，也不是新增步驟的來源。
- [BIG CHANGE：關閉遙測時 Claude Code 可能略過 AGENTS.md](https://bigchange.ai/blog/claude-code-agents-md-telemetry-feature-flags) — 關於特定版本功能旗標的相關報導。本文使用目前官方手冊與讀者實際版本、設定及查看結果，絕不無條件宣稱 AGENTS.md 必定載入。