Claude Code 是什麼

Claude Code 的關鍵不是“Claude 會寫程式碼”，而是“Claude 進入了你的工程現場”。它能看到專案檔案、執行命令、修改程式碼、根據結果繼續判斷，這才是它和普通聊天式 AI 的分界線。——翔宇

1. 先別把它當“程式碼聊天框”

很多人第一次理解 Claude Code，會把它放進熟悉的框架裡：

ChatGPT / Claude.ai 能回答代码问题
Claude Code 也能回答代码问题
所以 Claude Code = 更懂代码的聊天框

這個理解會害你用得很淺。

聊天框的典型工作方式是：你複製程式碼、貼上錯誤、等待回答、自己回到專案裡改。AI 只是一個在專案外面的顧問。

Claude Code 的工作方式不同。官方 概覽頁（overview） 把它定義為智慧體式程式設計工具（agentic coding tool）：它能讀取程式碼庫、編輯檔案、執行命令，並和你的開發工具整合。換成中文開發者更好理解的話：

這就是第一章要建立的心智模型。

2. “進入工程現場”到底意味著什麼

假設你有一個登入 bug。

用普通聊天式 AI，你通常這樣做：

复制报错
复制相关代码
问 AI 为什么错
把答案搬回 IDE
再跑测试
再复制新的报错

用 Claude Code，你可以在專案目錄裡啟動：

cd your-project
claude

然後直接說。比如你可以用中文提出一個足夠具體的任務：

过期银行卡用户的结账流程现在有问题。
请检查 src/payments/ 里的支付逻辑，重点看 token refresh（令牌刷新）相关部分。
先写一个能复现问题的失败测试，再修复它。

這類提示詞不需要很長，但要同時說明問題現象、排查範圍和驗收方式。

它的工作鏈路會變成：

flowchart TD
    Ask["你描述目標"]
    Read["Claude 讀專案上下文"]
    Plan["推理下一步"]
    Act["改檔案 / 跑命令"]
    Verify["看測試或命令結果"]
    Adjust["繼續修正"]

    Ask --> Read --> Plan --> Act --> Verify --> Adjust
    Adjust --> Read

    style Read fill:#e0f2fe,stroke:#0284c7,stroke-width:2px
    style Act fill:#fef3c7,stroke:#f59e0b,stroke-width:2px
    style Verify fill:#dcfce7,stroke:#22c55e,stroke-width:2px

官方 工作原理頁（How Claude Code works） 把這個過程叫智慧體迴圈（agentic loop）：獲取上下文（gather context）、執行動作（take action）、驗證結果（verify results）。三步不是線性跑一遍，而是會反覆迴圈。

這張圖的重點不是節點名，而是角色分工：

3. 它能訪問什麼

Claude Code 能做事，是因為它有工具。

官方工作原理文件（how-it-works）裡把工具分成幾類：檔案操作、搜尋、執行命令、Web（網頁能力）、程式碼智慧。新手先記這張表：

在終端裡執行 claude 後，它主要能看到：

• 當前專案：當前目錄和子目錄裡的檔案。
• 終端環境：你能跑的構建工具、Git、包管理器、指令碼。
• Git 狀態：當前分支、未提交改動、最近提交歷史。
• CLAUDE.md：專案規則、約定、偏好。
• Auto memory（自動記憶）：它在工作中自動儲存的專案經驗。
• 擴充套件能力：MCP、Skills（技能）、Subagents（子 Agent）、Hooks（鉤子）、外掛等。

4. 它可以做哪些事

官方概覽頁列了很多用法。不要把它理解成“生成程式碼”，更準確是“推進開發任務”：

• 探索專案：這個專案是做什麼的？
• 修 bug：找出 session 過期時登入失敗的原因並修復
• 加功能：給使用者登入檔單加輸入校驗
• 補測試：給 auth 模組寫測試，跑測試，並修復失敗用例
• 整理文件：更新 README，讓它和當前的安裝/啟動流程一致
• Git 工作流：幫我把改動 commit 一下，寫一條描述清楚的 message
• 批次維護：修復全專案的 lint 錯誤
• 程式碼審查：檢查這幾個改動檔案有沒有安全問題

第一輪不適合直接交給它的任務也要說清：

• 沒有驗收標準的大範圍重構。
• 需要生產許可權、真實客戶資料或支付操作的任務。
• 你自己還沒想清楚邊界，卻要求它“一次性全自動做完”的任務。

關鍵不是命令寫得多漂亮，而是給出目標、約束和驗收。

弱提示（不要這樣寫）：

修一下。

更好的提示：

先读 src/auth 和 tests/auth。
bug 是：已过期的 session 没有跳到登录页。
请先写一个能复现问题的失败测试，再实现修复，然后跑相关测试命令。
不要改数据库 schema。

5. 入口不止終端，但終端最完整

官方概覽頁當前列了多個入口：Terminal（終端）、VS Code、Desktop app（桌面應用）、Web（網頁）、JetBrains，也提到 CI/CD、Slack、Chrome、Mobile（移動端）、Remote Control（遠端控制）等整合。

這些入口連線的是同一個 Claude Code 底層能力。差別不在“哪個才是真的 Claude Code”，而在程式碼執行在哪裡、你用什麼介面審查 diff、能不能離開本機繼續任務。

官方還在持續擴充套件跨裝置、定時和外部觸發能力：

• 定時任務三種粒度：Routines（雲端常駐，電腦關機也跑）/ Desktop scheduled tasks（本機直訪本地檔案）/ /loop（CLI 會話內重複一段提示）。
• 跨裝置會話：Remote Control（手機或瀏覽器接管本地會話）/ Dispatch（手機派發任務到桌面應用）/ claude --teleport（把 web 或 iOS 長任務拉回終端）/ /desktop（終端會話轉到桌面應用做 diff 視覺審查）。
• 外部觸發：Channels（Telegram / Discord / iMessage / 自定義 webhook 推送進會話）/ GitHub Actions / GitLab CI/CD（PR 評論或 issue 觸發 Claude Code）/ Slack @Claude（團隊 chat 轉 PR）。

第一章只建立入口判斷，細節放到平臺章節。

新手先按這張表選：

6. 第一輪會話該怎麼開始

官方快速開始頁（quickstart）建議從一個真實專案目錄開始，而不是空目錄。

最小路徑是：

cd your-project
claude

第一次會要求登入。登入後，不要馬上讓它大改程式碼。先問一個探索問題：

这个项目是做什么的？

然後問更具體的結構問題：

认证流程是在哪里实现的？

再讓它提出計劃：

请给我一个计划：在注册表单上加输入校验。先不要动文件。

最後才允許執行：

按计划实施。跑相关测试。提交前先给我看 diff。

這條路徑背後的原因很簡單：Claude Code 是 Agent，Agent 會自己探索和行動。你越早讓它理解專案邊界，後面越少返工。

flowchart TD
    Start["進入真實專案目錄"]
    Explore["先問專案是什麼"]
    Locate["定位相關模組"]
    Plan["先要計劃"]
    Execute["批准執行"]
    Verify["執行測試 / 看 diff"]

    Start --> Explore --> Locate --> Plan --> Execute --> Verify

    style Plan fill:#fef3c7,stroke:#f59e0b,stroke-width:2px
    style Verify fill:#dcfce7,stroke:#22c55e,stroke-width:2px

這條最小路徑的價值在於降低誤操作：

7. 它不是全自動替你負責

Claude Code 很強，但它不是“交出去就不用管”的按鈕。

官方工作原理頁裡強調，你可以隨時打斷並調整方向（interrupt and steer）。它會自主推進，但仍然響應你的輸入。這個設計很重要：Claude Code 不是替你做最終判斷，而是把機械探索、改動和驗證加速。

你仍然要負責：

• 判斷任務是否該做。
• 審查關鍵 diff。
• 審查許可權彈出視窗和高影響命令。
• 判斷測試是否足夠。
• 確認是否提交、推送、部署。

按動作風險劃分，可以這樣看：

• 搜尋檔案通常可以自動放行，因為它是隻讀操作。
• 改普通原始碼可以給條件信任，因為能看 diff，也能回復。
• 跑測試 / lint 通常可以自動放行，因為風險低且可驗證。
• 改 .env / secrets 不應該自動放行，因為涉及憑據。
• git push / deploy 應該人工確認，因為會影響遠端狀態。
• 資料庫寫入 / 刪除應該嚴格限制，因為可能不可逆。

8. 這章和後面章節的關係

這一章只解決一個問題：Claude Code 到底是什麼。

後面的入門篇會逐步落到操作：

• 安裝和更新：怎麼把 CLI 裝到本機，並保持版本正確。
• 登入與認證：用訂閱、Console、企業雲或第三方提供商登入。
• 選擇平臺與整合：CLI、Desktop、IDE、Web、Mobile 怎麼選。

理解篇會繼續補底層概念：

• 上下文：Claude 一次能看到多少東西。
• 記憶：跨會話怎麼記住專案習慣。
• Skills（技能）/ Subagents（子 Agent）/ MCP：能力怎麼擴充套件。
• Hooks（鉤子）/ Permissions（許可權）：自動化和安全邊界怎麼管。

9. 本章自檢

試著用自己的話回答：

1. Claude Code 和普通聊天式 AI 的核心差別是什麼？對應 §1-§2。
2. 智慧體迴圈（agentic loop）的三步是什麼？為什麼它會迴圈？對應 §2。
3. Claude Code 在終端裡主要能訪問哪幾類上下文？對應 §3。
4. 為什麼新手應該先從終端命令列入口開始，而不是一上來混用所有入口？對應 §5。
5. 哪些動作適合自動放行，哪些動作應該人工確認？對應 §7。

官方來源

• Claude Code overview
• Quickstart
• How Claude Code works

接下來去哪

如果只記一個判斷：Claude Code 的起點不是“問 AI 一段程式碼”，而是“讓 Agent 進入專案現場，在你的邊界內完成開發迴圈”。