Claude Code 到底是什么一句話定位模型驅動的本地終端 agent——你說它做它直接在你電腦上讀寫文件、跑命令、改代碼。不是聊天機器人是有手有腳的執(zhí)行者。一、設計哲學模型不動工具在外Anthropic 的核心判斷與其訓練一個專門寫代碼的模型會過時、會僵化不如把通用模型配上工具讓 agent 能力隨模型升級自動變強。所以 Claude Code下稱 CC是一個薄客戶端本地程序只做一件事——當模型的手、眼和記憶。智能留在云端的 Claude 模型里。CC 從發(fā)布到現(xiàn)在沒換過架構但每次 Claude 模型升級CC 免費跟著變強。二、整體架構云端你本機HTTPS終端界面輸入 / 渲染 / 確認彈窗Agent 核心循環(huán)編排引擎權限網關攔截危險操作工具執(zhí)行器Read / Write / Bash / Grep…文件系統(tǒng) / Shell / Git / MCP 服務Claude 模型推理注權限網關放在工具執(zhí)行器之前——所有寫操作先過權限檢查才被真正執(zhí)行。本地只有三樣東西界面、編排循環(huán)、工具執(zhí)行器。模型在云上。三、核心機制Agent 循環(huán)整個 CC 的心臟是一個循環(huán)每輪四步打包上下文—— 系統(tǒng)提示詞 對話歷史 工具定義 相關文件內容發(fā)給模型推理—— 模型返回思考 工具調用請求結構化 JSON本地執(zhí)行工具—— CC 解析請求真正讀寫文件、跑命令結果回填—— 執(zhí)行輸出塞回上下文回到第 1 步循環(huán)什么時候停模型不再請求工具、只輸出文字時就是最終答復。你看到 CC “自己干了 20 分鐘活”本質是這個循環(huán)轉了幾十上百圈。關鍵認知模型不能碰你的電腦。它輸出的只是請調用 Write 工具把這段內容寫到這個路徑的 JSON 指令CC 本地執(zhí)行后再把結果告訴模型。四、七個關鍵設計1. System Prompt系統(tǒng)提示詞CC 的人格和技能全寫在一段很長的系統(tǒng)提示詞里每次請求都帶上角色定義、安全紅線、行為規(guī)范改文件前先讀、驗證后再匯報、輸出格式。值得學的點模型的行為不是訓練死的是提示詞編程出來的。你還可以用 CLAUDE.md 往里追加項目級指令等于給 CC 做二次編程。2. 工具集設計暴露給模型的工具高度精煉就十來個Read、Write、Edit、Bash、Glob、Grep、WebFetch、Task 等。每個工具的描述不只是參數(shù)格式還有使用建議如優(yōu)先用 Grep 而不是 Bash 里跑 grep。原則工具寧少勿多但每個描述到極致。工具太多模型會選錯。3. 權限網關安全的根基所有工具調用先過權限檢查分三檔只讀操作Read/Glob/Grep→ 自動放行寫操作和命令Write/Edit/Bash→ 默認彈確認高危模式 → settings.json 里配置允許/拒絕規(guī)則--dangerously-skip-permissions就是把網關整個拆掉。設計洞察是風險不對稱讀文件搞不壞系統(tǒng)寫操作才需要人盯著。4. 上下文工程真正的護城河模型上下文窗口有限約 200K token怎么塞進最有用的信息是核心競爭力按需加載不預讀整個倉庫模型用 Glob/Grep 搜索只把相關文件讀進上下文CLAUDE.md 分層注入全局記憶 → 項目記憶啟動時自動拼接自動壓縮上下文快滿時把舊對話摘要成總結騰空間輸出截斷命令輸出太長只留頭尾和人的工作方式一樣你不會背下整個代碼庫而是用到哪查到哪。5. 子 AgentTask 工具主 agent 遇到可拆分的任務時派生子 agent子 agent 拿一份干凈的上下文獨立跑自己的循環(huán)完成后只交回結論。動機是上下文隔離——探索一個模塊可能要讀 50 個文件主 agent 自己讀會撐爆上下文讓子 agent 讀主 agent 只收 200 字總結。6. MCP插件協(xié)議Model Context Protocol 是一套標準協(xié)議外部程序只要按協(xié)議提供工具/數(shù)據源就能被 CC 調用數(shù)據庫、監(jiān)控、內部平臺……。Anthropic 把它開源成了行業(yè)標準OpenAI、Google 后來也都接了。7. Hooks生命周期鉤子在固定事件點工具調用前/后允許用戶掛自己的腳本比如每次 Write 后自動跑 eslint。給本地執(zhí)行器留擴展點。五、值得記住的設計決策薄客戶端 強模型本地刻意做薄能力隨模型升級自動增強終端優(yōu)先終端是開發(fā)者主場且能被腳本化claude -p塞進 CI/CD權限確認而非沙箱本地跑 每步確認換來對真實環(huán)境的完整訪問上下文即產品CC 團隊大部分迭代都在優(yōu)化給模型看什么而不是堆功能六、橫向對比同類工具怎么選工具形態(tài)核心差異適合場景Claude Code終端 CLI工具調用 本地執(zhí)行復雜任務、自動化、多文件操作CursorAI 編輯器編輯器內實時補全 對話沉浸式寫代碼WindsurfAI 編輯器多 agent 并行團隊協(xié)作、多模塊改動ClineVS Code 插件開源免費可換任意模型預算有限、想自定義Aider終端 CLI極簡結對編程自動 commit命令行愛好者CopilotVS Code 插件深度綁定 GitHubGitHub 用戶、輕量輔助OpenAI Codex云端異步扔任務自己跑批量任務Devin全自主號稱完全自主爭議大別太指望Bolt.new瀏覽器生成應用一鍵部署快速原型本質區(qū)別就兩個維度交互方式對話式 / 編輯器嵌入 / 異步自主和自主程度幫你寫 → 你說它做 → 你說它全干。CC 卡在中間最舒服的位置有自主能力但不瞎跑。Devin 那種完全自主目前不成熟CC 這種人機協(xié)作才是現(xiàn)階段最實用的。七、自己造一個簡化版 Agent核心代碼量很小幾百行就能跑一個循環(huán)讀用戶輸入 → 拼 messages 數(shù)組 → 調 Claude API帶 tools 定義解析返回的 tool_use 塊 → 本地執(zhí)行先實現(xiàn) Read/Write/Bash 三個就夠把工具結果以 tool_result 消息追加回去 → 再調 API直到模型返回純文本循環(huán)退出理解了 CC 的原理等于理解了市面上所有 agent 產品Cursor 的 agent 模式、Cline、Devin——它們全是同一個范式的不同包裝。八、為什么中國大陸用不了Anthropic 自 2025 年 9 月起將中國大陸及港澳列入不受支持地區(qū)同類還有俄羅斯、伊朗、朝鮮這是政策限制而非技術故障。官方理由法律監(jiān)管風險擔心受限地區(qū)企業(yè)被迫配合情報要求、防止模型能力經蒸餾加速當?shù)?AI 研發(fā)、以及確保變革性 AI 服務于民主利益。執(zhí)行上分兩條線公司看股權——中資直接或間接持股超 50% 一律禁用無論注冊在哪個國家個人看地區(qū)——身處支持地區(qū)即可用與國籍無關身處大陸則不可用代理偽裝 IP 屬于違反服務條款檢測到就封號2026 上半年封了 1140 萬賬號申訴成功率約 10%。這是美國對華科技管制從芯片延伸到模型的大環(huán)境的一部分。國內替代路徑開源的 Cline/Aider 配國產模型DeepSeek、Qwen 等agent 原理完全相同。附日常使用速查入口說明單次任務用claude -p 任務復雜多輪任務建議直接claude進交互式會話。claude# 交互式會話最常用claude-p任務# 單次執(zhí)行claude--resume# 恢復上次會話claude --dangerously-skip-permissions# 免確認慎用