我們在 Anthropic 怎麼用 Claude Code（第 1/3 段）

🧑‍🏫 這支是 Anthropic 內部人員親自示範「我們自己怎麼用 Claude Code」的工作坊，第一段講三個核心觀念：讓 Claude 反過來問你需求、用 HTML 取代 Markdown 寫規格，以及把驗證放進成果裡。這些做法不只工程師用得上，只要你會叫 AI 幫你做事，都能拿來改善溝通方式。

• 00:19 講者 Arno 是 Anthropic Applied AI 團隊的 architect，這場 workshop 要分享 Anthropic 內部怎麼使用 Claude Code
  ↳ 講者 Arno 在 Anthropic 的 Applied AI 團隊擔任架構師（architect）。這場要分享公司內部怎麼用 Claude Code，也就是 Anthropic 做的、能幫你寫程式的 AI 工具。
• 00:49 這是一場可以跟著一起寫 code 的 workshop，現場掃 QR code 可以拿到 credits，遇到技術問題有工作人員協助
  ↳ 這是 workshop（工作坊），觀眾可以邊聽邊實際操作。掃 QR code 能領 credits，也就是使用 Claude 的額度；操作卡住有工作人員幫忙。
• 01:19 附有一個可以 clone 的 repo，內容分成三個階段；裡面的驗證設定寫得很細，建議之後再自己深入研究
  ↳ 講者準備了一個 repo（放程式碼的專案資料夾），可以 clone（整份複製）到自己電腦。練習分三階段，驗證的設定寫得很細，現場看不完，建議之後再慢慢研究。
• 01:51 內容改編自 Tariq 大約一週半前在舊金山的演講，他把內容寫成部落格文章〈The Unreasonable Effectiveness of HTML files〉
  ↳ 這場內容改編自同事 Tariq 約一週半前在舊金山的演講。他後來寫成部落格文章，標題大意是「HTML 檔案好用到不合理」。
• 01:51 Tariq 的主張是：不再用 Markdown 檔案，改用 HTML 檔案；今天會示範其中一部分
  ↳ Markdown 是用 #、* 等符號標格式的純文字；HTML 是網頁用的格式，能放表格、顏色、版面。Tariq 主張給 AI 的文件改用 HTML，今天會示範一部分。
• 02:21 agent 越來越強，是因為模型越來越強；所以 agent 能跑得更久、接更複雜的任務，我們的工作習慣也得跟著改
  ↳ agent 指能自己連續做好幾步任務的 AI。模型變強，agent 就能自己做更久、更複雜的事，人也不能再用一句一句盯著的舊習慣帶它。
• 02:58 agent 跑得越久，如果方向錯了就會燒掉很多 token，最好在一開始就避免
  ↳ token 是 AI 處理文字的計量單位，也等於用量和成本。agent 一跑就很久，如果一開始理解錯，就會白燒大把 token 和時間，所以要在起跑前對準方向。
• 02:58 因此把人原本在 spec 裡要做的驗證提前，放進 HTML 檔案。HTML 內容比較豐富，人讀起來也比較順手
  ↳ spec 就是規格書。以前要等做出東西才確認「是不是我要的」，現在把這步提前，用 HTML 呈現規格，畫面豐富，人比較容易一眼看出對不對。
• 03:34 Anthropic 官網有很多 engineering blog 和一般 blog，談 harness、long-running agent 等主題，值得去讀
  ↳ Anthropic 官網有工程部落格，談 harness（包在模型外面、讓它能用工具做事的那套架構）和 long-running agent（能長時間自己跑的 agent），想深入可以去讀。
• 03:34 今天分三個層次：比較基礎的、再進一步的、比較深入的
  ↳ 今天的內容由淺到深分三層，從基礎用法一路講到比較進階的做法。
• 04:06 第一個觀念：模型越強，越要忍住不去限制它
  ↳ 直覺上模型越強，越怕它亂來、越想多訂規則。講者要你反過來：模型越強，越要少綁手綁腳，讓它自己發揮。
• 04:06 Richard Sutton 是強化學習之父，提出 the bitter lesson：與其靠人的能力事先寫死、限制系統，不如投入更多資料和算力，最後能力更強
  ↳ reinforcement learning（強化學習）是讓 AI 從試錯中學習的方法。Sutton 的 bitter lesson 是說：人事先寫死的規則，長期會輸給投入更多資料和算力的做法。
• 04:38 類比到這裡：你要接受一件事，模型從你身上挖出需求的能力，可能比你自己定義需求還好
  ↳ 套到日常使用上：與其你自己絞盡腦汁寫出完整需求，不如讓模型來問你。它挖出你真正要什麼的能力，可能比你自己想還強。
• 04:38 需求潛藏在你心裡。就像使用者「看到才知道要什麼」卻講不清楚，你也一樣，所以 Claude 來挖需求比你自己寫給它更有效
  ↳ 就像裝潢時你講不出想要什麼風格，看到樣品屋才說「對，就這種」。需求其實在你腦裡，只是需要有人來問、把它引出來。
• 05:10 主題一：消除模糊，讓 Claude 反過來 prompt 你、訪問你
  ↳ 第一個主題：別讓 Claude 用猜的。你的要求常常很模糊，所以讓 Claude 當訪問者，一題一題問你，把模糊的地方問清楚。
• 05:10 主題二：理解與規劃。以前用 Markdown 檔，現在也還在用；有同事說 Markdown 是「AI native 軟體開發生命週期的共通語言（lingua franca）」
  ↳ 第二個主題是先搞懂、再規劃。目前大家多半用 Markdown 寫計畫，還有同事稱它是 lingua franca，也就是人和 AI 在開發流程裡通用的共同語言。
• 05:40 但 Markdown 格式有侷限，檔案越寫越長、要讀的行數太多；HTML 可以塞進更多資訊，今天就要用 HTML
  ↳ 但 Markdown 只能一行行往下寫，計畫一長就讀不完、抓不到重點。HTML 能用表格、區塊、版面排列，同樣篇幅裝得下更多資訊，讀起來也快。
• 05:40 主題三：驗證。這裡講的是驗證（verify），不是測試（test）；要讓驗證內建在產出物本身
  ↳ 第三個主題是驗證。講者特別強調是「驗證」不是「測試」：重點不是事後另外寫一套檢查，而是讓做出來的東西本身就帶著確認方式。
• 05:40 這樣 agent 可以跟人一起驗證，最後也可以不需要人、以 headless 方式自己跑
  ↳ headless 指沒有畫面、不需要人在旁邊操作。一開始 agent 跟你一起檢查成果，之後可以放手讓它自己跑驗證，不用人盯。
• 06:10 趨勢是 agent 會越來越原生地做這些事，所以要把產出物設計成本身就能用你需要的方式測試、驗證
  ↳ 講者判斷 agent 會越來越擅長自己做驗證，所以現在就該把成果設計成「方便被檢查」的樣子，它才能照你的標準自己確認。
• 06:10 示範例子：做一個分帳 app，和朋友出去玩時算出誰欠誰多少錢
  ↳ 示範題目很生活：做一個分帳 app，跟朋友出去玩之後，自動算出誰該付誰多少錢。
• 06:41 不好的 prompt：只打「Make it better」或「make no mistakes」。講者看到很多人用 Claude Code 就是這樣打
  ↳ 很多人只打「弄好一點」或「不要出錯」。但 Claude 不知道「好」是指什麼、怎樣算錯，這種話等於沒給它任何資訊。
• 07:11 好的 prompt：引導 Claude 從你身上問出具體細節；講出你在意的領域，但不要把結果規定得太死
  ↳ 好的做法是告訴 Claude 你在意哪些面向，請它來問你細節；但不要把答案先寫死，留空間讓它提出你沒想到的選項。
• 07:11 例如點出要關注受眾，或用開放式的方式提問、不要事先定好答案，這樣 Claude 就會一輪一輪地訪問你
  ↳ 例如說「請考慮誰會用這個 app」，或用開放式問句、不預設答案，Claude 就會一輪一輪訪問你，慢慢把需求問清楚。
• 07:41 現場用 fast mode 的人不多；講者強烈建議一定要用 auto mode，說用了會輕鬆很多
  ↳ fast mode 讓 Claude 回得比較快；auto mode 讓 Claude 不用每一步都停下來等你按同意。講者強烈建議開 auto mode，會省很多事。
• 08:11 effort 參數：建議設 X high，也可以設 max effort；講者這次示範維持 X high
  ↳ effort 參數決定 Claude 每次花多少力氣思考。講者建議設在 X high，也可以開到最高的 max；這次示範維持 X high。
• 08:11 指令：/effort 設定 effort 參數，/fast 開 fast mode（講者已開啟），按 Shift+Tab 切換到 auto mode
  ↳ 在 Claude Code 裡輸入 /effort 調整思考力道、輸入 /fast 開快速模式，再按 Shift+Tab 切到 auto mode，設定就完成了。
• 08:41 分帳 app 的 prompt 在 repo 裡。貼上後 Claude 會丟出問題讓你逐題點選；講者選「給朋友用」、沒有次要受眾
  ↳ 分帳 app 的 prompt 放在 repo 裡，直接複製貼上。Claude 會跳出選擇題讓你點選，講者選了「給朋友用」，也沒有其他使用族群。
• 09:19 關鍵：要在 prompt 裡明確叫 Claude 使用 ask user question tool，這個流程才會啟動；prompt 寫得越清楚，結果越好
  ↳ ask user question tool 是讓 Claude 跳出選擇題來問你的功能。要在 prompt 裡點名叫它用，才會進入這種問答流程；指示越清楚，結果越好。
• 09:49 回答完問題後，Claude 會寫出 spec，之後可以從 spec 發展出好幾種建構 app 的方式
  ↳ 問完之後，Claude 會把你的回答整理成規格書；接下來可以依照這份規格，試好幾種不同的做法把 app 做出來。
• 09:49 有了 plan 之後，Claude 能一輪一輪問出你真正要什麼，你不必一開始就把所有事情講清楚
  ↳ 有了計畫之後，你不用一開始就把所有事想清楚。先有個大概，讓 Claude 透過一來一往的提問，幫你拼出真正的需求。
• 10:23 接著要檢查這是不是你要的：HTML 檔資訊密度高很多，比較容易看出成品會長什麼樣子，甚至可以用截圖（本段字幕到此截斷）
  ↳ 最後要確認這是不是你要的。HTML 版規格資訊密度高，比純文字更容易想像成品的樣子，甚至能搭配截圖來看。（本段字幕到此中斷）

講者對 Claude Code 的 effort 參數建議設成哪個等級？