嗨！一切都好嘛？我係 Lena。

幾個禮拜前，我坐喺我常去嘅咖啡店入面，想令 Claude Code 記住我上個禮拜解釋過嘅嘢。佢冇記得。我要將成段上下文重新打一次，我仲記得自己就咁盯住個 mon 諗——等等，啲嘢去咗邊？

嗰一刻將我帶入咗一個我冇諗過嘅兔洞。因為 Claude Code 入面個「local」，並唔係我以為嘅嗰個意思。而我以為我理解咗嘅嘢同實際發生緊嘅嘢之間嗰條縫——係……真係值得寫低嘅。

喺本地跑 Claude Code 究竟意味住咩

本地 CLI 執行 vs 雲端托管 session

當你喺本地跑 Claude Code，個 CLI 住喺你自己部機上——但真正嘅模型推理仲係發生喺 Anthropic 嘅雲上。你個終端係同 API 傾緊偈；做重活嗰個唔係你部手提。

係本地嘅：你嘅 file system、你嘅項目結構、你嘅命令歷史、Claude 創建嘅 output 文件。唔係本地嘅：模型權重、算力、同埋 Claude 喺 session 之間「識得」嘅任何嘢。

呢個區分好重要，尤其係當你喺搭 agent workflow，預期某種持久智能會喺本地累積起嚟。佢唔會——至少唔係自動咁。

喺 Linux、Mac、Windows 上面裝 Claude Code

截至 2026 年 3 月，Claude Code 透過 npm 分發，需要 Node.js 18+。各平台嘅安裝方式一樣：

Bash

npm install -g @anthropic-ai/claude-code

跟住認證：

Bash

claude login

喺 Linux 上面，如果裝完搵唔到 claude 命令，你可能要將 npm 嘅全局 bin 目錄加入 PATH。Windows 用戶跑 WSL2 就當個環境係 Linux 處理。原生 Windows PowerShell 支援存在，但喺文件路徑處理上有啲邊界情況——喺假設你個配置「應該冇事」之前，值得睇下 Anthropic 嘅 Claude Code 文檔。

本地 Skills 同記憶

CLAUDE.md 同項目級 skill 文件

呢段我讀咗兩次。

Claude Code 會喺每個 session 嘅開頭，由你嘅項目根目錄讀一個叫 CLAUDE.md 嘅文件。當佢係一份「交接備忘」——你將指令寫喺嗰度，每次你開呢個項目，Claude 都會拎出嚟。

Markdown

# My Project Context

- This is a Next.js 14 app using TypeScript
- Always use pnpm, not npm
- Component files live in /src/components
- Prefer functional components with explicit return types

呢個唔係記憶。呢個係「上下文注入」。個區別好微妙，但佢改變咗你睇呢件工具嘅方式。Claude 唔係喺度記得——佢係喺度讀。每一個 session 都係。

你都可以喺子目錄入面放 CLAUDE.md。Claude Code 會根據你而家喺項目入面工作嘅位置，載入相關嗰份。如果你 codebase 嘅唔同部分有唔同慣例，呢個機制有用。

本地上下文點樣跨 session 累積

我開始留意之後發現：上下文唔會自己累積。會累積嘅係 CLAUDE.md 呢份文件本身——前提係你每個 session 之後都手動去更新佢，將你學到嘅嘢或者行得通嘅 pattern 寫入去。

呢個係手工活。你就係嗰個記憶層。

有啲人會寫細細隻腳本，將 session summary 自動 append 入 CLAUDE.md。嗰個係合理嘅 workaround。但開箱狀態下，呢份文件係靜態嘅，直到你去編輯佢。

喺今日嘅 Claude Code 入面，「記憶」係咩意思

截至 2026 年初，Claude Code 冇好似一啲更新嘅 agent 框架嗰種原生持久記憶。冇一個後台 process 靜雞雞咁喺度起緊你偏好嘅知識圖譜。

存在嘅係呢啲：

CLAUDE.md，用嚟存項目級上下文
單個 session 入面嘅對話歷史
Claude 創建或者修改嘅文件——佢哋能持久，係因為佢哋就係文件

最尾嗰一點其實比聽落勁。如果 Claude 生成咗一個可複用嘅 utility function 並儲存到你嘅 repo 入面，嗰個能力而家已經入咗版本控制。呢個係以盡可能最可靠嘅方式喺度持久。

本地執行係咪令能力持久化變得更容易？

優勢——持久化文件、版本控制、本地 skill 庫

喺本地跑會喺搭持久能力上面俾你真實嘅優勢——只係唔係我一開始以為嗰種。

咩嘢會持久	點樣持久
Claude 寫嘅代碼	存到你嘅 file system，由 git 追蹤
項目慣例	寫喺 CLAUDE.md 入面
可複用 pattern	以真實文件形式存入你嘅 repo
Workflow 腳本	Shell 腳本、Makefile 等等，Claude 幫你一齊寫

版本控制係呢度嘅殺手鐧。Claude 幫你搭嘅每一個 pattern 都變成一個 commit。你嘅 git 歷史就變成一條累積能力嘅時間線。呢個係真正嘅持久化——只係唔係自動化嘅。

限制——仲係單 agent、仲係冇跨 agent 繼承

Claude Code 作為一個 agent 跑喺一個 session 入面。冇任何內建機制令一個 Claude Code session 可以將佢學到嘅嘢分享俾另一個 session——即使嗰個另一個 session 係喺同一個項目、另一個終端窗口入面。

呢個係硬邊界。你冇辦法令 Project A 上嘅 Claude Code 自動通知 Project B 上嘅 Claude Code。學習唔會傳播。每個 session 都係由你手動寫入 CLAUDE.md 嘅嘢，同項目入面已有嘅文件重新開始。

對團隊嚟講，呢個造成咗一個有意思嘅挑戰。如果一個開發者將你哋共享 codebase 嘅 CLAUDE.md 磨到好靚，其他人就要用同一份文件。協作係人牽線嘅，唔係 agent 牽線嘅。好似 LangGraph 嘅多 agent 協調 pattern 咁嘅項目喺度探索跨 agent 協調會係點樣，但 Claude Code 而家仲未原生實現到。

本地狀態同網絡層可複用資產之間嗰條縫

呢條縫我一直諗緊。本地狀態係你嘅——佢住喺你嘅 file system、你嘅 git repo、你嘅 CLAUDE.md 入面。呢啲都好。但佢唔參與比呢啲更大嘅嘢。

網絡層嘅可複用資產意味住：Claude 喺幫你嘅過程入面學到嘅嘢，能夠以某種被驗證過嘅形式，變成其他 agent 喺做類似問題時可以用嘅資源。本地 Claude Code 坐喺呢條縫嘅其中一邊。呢條縫會唔會閂埋、點樣閂埋，係我仲喺度睇緊嘅嘢。

本地 agent 作為能力工程嘅起點

喺發佈到網絡之前，先喺本地搭可複用 pattern

有一個 framing 對我有幫助：本地 Claude Code 係一個適合打磨 pattern 嘅地方——喺佢哋準備好分享去任何地方之前。

你迭代、你打磨、你將行得通嘅版本編碼入文件同 CLAUDE.md。當一個 pattern 企得穩——一個 prompt template、一個 code generation workflow、一種 debug 路徑——佢就已經文檔化、可測試。嗰個就係任何未來「能力分享系統」嘅原材料。

OpenAI 嘅 Swarm 項目做過輕量級多 agent 協調嘅實驗，其中一個 takeaway 係：定義良好嘅單 agent 行為，係有效協作嘅前提。本地優先唔係限制——佢係工作真正發生嘅地方，喺佢規模化之前。

點解「本地優先」唔等於「只有本地」

我早期犯嘅錯大概係：將「本地」當成一個永久狀態，而唔係一個起點。

本地執行俾你控制、速度，同埋同你真實 file system 嘅整合。嗰個係你做細活嘅地方——慢慢將「一個好嘅 workflow 究竟長咩樣」搞清楚。一旦嗰件事諗通，點樣分享佢——同隊友、同其他項目、同其他 agent——就變成一個獨立、有意思嘅問題。

Google 發佈嘅 A2A（Agent-to-Agent）協議規範係將「agent 之間點樣跨系統溝通能力」正式化嘅其中一次嘗試。Claude Code 會唔會同呢啲正在成型嘅標準整合，係一個值得繼續留意嘅問題。

邊界同 trade-off

幾件我希望有人喺我開始之前講俾我聽嘅嘢：

CLAUDE.md 有上下文上限。 如果佢太長，佢會開始將其他有用嘅上下文擠出窗口。令佢保持聚焦。定期修剪。

本地文件嘅好壞睇你嘅 git 衛生。 如果你冇持續咁 commit Claude 嘅輸出，當你換機或者重置環境嗰陣，嗰種「持久化」就冇咗。

API 仲係有 rate limit。 喺本地跑唔會令你免於使用約束。重度 agentic session——尤其係帶文件操作同 tool use 嗰種——比對話式使用更快撞到上限。Anthropic 嘅 rate limit 文檔有而家 tier 嘅詳情。

Claude Code 嘅 tool use 每個 session 都係 sandbox 嘅。 文件讀寫、終端命令喺呢個 session 入面生效。除非結果落到某個文件入面，否則冇嘢會帶到下一輪。

呢啲邊界我都唔敢話完全摸清咗。但呢個就係我而家對佢嘅理解。

FAQ

我點樣喺本地裝 Claude Code？

透過 npm 安裝：npm install -g @anthropic-ai/claude-code，然後跑 claude login 嚟認證。需要 Node.js 18 或以上。喺 Linux / WSL 上，確認你嘅 PATH 包含 npm 嘅全局 bin 目錄。

Claude Code 有冇持久記憶？

冇嗰種「自動」意義上嘅持久記憶。每個 session 都係由頭開始。持久性嚟自 CLAUDE.md（由你手工維護）同 Claude 喺你項目入面創建、並提交到版本控制嘅文件。

CLAUDE.md 係咩，佢點樣運作？

佢係一個放喺你項目根目錄（或者可選地放喺子目錄）嘅普通 markdown 文件。Claude Code 喺每個 session 嘅開頭會讀佢。你用佢嚟記錄項目上下文、慣例同偏好。當佢係一份交接備忘，而唔係一個記憶系統。

Claude Code 嘅 skills 可唔可以喺項目之間遷移？

唔可以自動遷移。你可以手動將你嘅 CLAUDE.md 同任何可複用文件由一個項目 copy 或者改寫到另一個項目，但冇內建嘅跨項目能力分享。呢個係目前呢種「本地優先」架構有意義嘅其中一條邊界。

對 agent workflow 嚟講，本地 Claude Code 好過雲端托管嘛？

睇你喺優化咩。本地俾你直接嘅 file system 訪問、喺項目特定上下文上更快嘅迭代，同對你文件完整嘅控制。雲端托管（例如 Claude.ai Projects）俾你更容易嘅分享同協作。對本地 codebase 複雜嘅個人開發 workflow，本地通常贏。對團隊 workflow 或者非技術用戶，雲端功能可能更重要。

Previous Posts:

如果你想更好咁理解 Claude Code 喺底層點處理 skills 同上下文：Claude Code Skills Feature Explained
如果你喺研究點樣跨項目搭建、複用同擴展 skills：Claude Code Skills: Build, Share, Extend Guide
如果你喺試搞清 skill 文件同真正嘅 agent 能力之間嘅分別：Claude Skills: skill.md vs Agent Capability
如果你喺諗點樣將行為串埋、搭更結構化嘅 agent workflow：Agent Hooks: AI Execution Chains Explained
如果你喺將 MCP 當成將 Claude Code 擴展到本地限制之外嘅方法：How MCP Servers Work

Claude Code 本地化：Skills、記憶同持久化