【2026 最新】Recalc 教學：用 Claude Code 把三份文件做成可核對的比較表

你手上有三份活動方案，想比較日期與費用。把文件貼進聊天視窗後，答案很快出來；隔天插入一列，卻開始懷疑：「這個金額還對應原本那份文件嗎？」這篇 Recalc 教學帶你把文件、問題、答案與核對紀錄排在同一張工作板。

本文專為完全沒有技術背景、已有或準備使用 Claude Code 的讀者寫。你會用三份虛構文件、兩個問題，練習查引用、簽核、改題目、移動列與匯出。以下依 2026 年 11 月 10 日查閱的官方指南與原始碼整理；操作範例是給你跟做的練習，並未在 AlphaLab 本機執行 Recalc 的模型任務。

先說結論：可核對的比較表＝答案＋原文＋位置＋審查狀態

Recalc 像一張每格都能坐一位助理的試算表。Claude Code 負責讀文件，工作板把答案、引用與狀態放在你眼前。完成目標是六個答案都能回到正確文件，而非只讓六格填滿。

先用假資料。官方 README把專案列為 early beta，並提醒保留重要資料副本。這裡的「本機 App」描述介面與工作板的位置；使用 Claude Code 讀文件時，文件內容仍會進入它連接的模型服務。

一、Recalc 教學先懂三件事：格子、參照與簽核

第一，格子有分工：一般值像便條紙，= 開頭是公式，@claude(...) 是 Agent 格。Agent（會使用工具完成任務的 AI 助理）接到工作後，把結果寫回格子。Recalc 也有終端命令與動作格，本篇先用文件問答與簡單公式。

第二，參照像收件地址。{A2} 讀 A2 的值；{$A2} 在複製公式時固定 A 欄，{B$1} 固定第 1 列。這些大括號裡的地址會被系統識別，和在提示詞散文裡寫「請看第二列」有差別。

第三，Verify 是你簽名，不是模型自評。簽核後，Agent 的覆寫會變成待處理建議，填滿與 Run Selection 會略過該格。先核對，再簽；若問題改了，舊簽名也需要重新評估。想先理解這類執行層的作用，可接著讀Agent Harness 白話說明。

二、先裝好工具：把 Claude Code 接到工作板

① 安裝前，先看清來源與 beta 狀態

到官方 Releases下載對應 Mac 晶片的 .dmg：Apple Silicon 選 aarch64，Intel 選 x64，再拖入 Applications。查閱時最新發布為 v0.1.3。官方另提供安裝腳本；新手可先用下載頁，看清要安裝的版本。

這個 beta 尚未經 Apple 簽署。確認檔案來自上述官方發布頁後，可依 README 的方式先嘗試開啟，再到「系統設定 → 隱私權與安全性 → 仍要打開」。這一步是在放行你已核對的特定 App。開啟後選 recalc → Install Command Line Tool…，供稍後的連接指令找到 recalc。

② 先確認 Claude Code 能用，再連接

若還沒裝 Claude Code，先走Anthropic 官方安裝流程並完成登入。在 Terminal 輸入 claude --version，應看見版本號。接著在 Recalc 選 Agent → Connect an Agent…，確認找到既有的 Claude Code。這裡連接的是程式代理，和 Claude 聊天 App 是不同入口。

若你還要讓自己從 Terminal 開的 Claude Code操作同一塊板，在該練習專案資料夾執行下面指令。MCP 可以理解成工具插座，讓 Claude Code 讀寫工作板：

claude mcp add recalc -- recalc mcp

這是 Recalc 官方連接方式，也符合Claude Code 的本機 MCP 語法。設定後以 claude mcp get recalc檢查連線。App 內直接執行格子與外部聊天接入，是兩條使用路徑；第一次練習先在 App 完成。

三、Recalc 教學動手做：三份文件、兩個問題

③ 建立你自己知道正解的三份假文件

在新資料夾 recalc-practice 建三個 UTF-8 純文字檔。Mac 的文字編輯可先選「格式 → 製作純文字」，再存成下列檔名。逐一複製，檔案只放範例文字：

01-alpha.txt
方案：Alpha
活動日期：2026-12-10
基本費用：USD 1200
選購攝影服務：USD 300，不包含在基本費用內。

02-beta.txt
方案：Beta
活動日期：2026-12-12
基本費用：USD 1500
本文件未列選購服務。

03-gamma.txt
方案：Gamma
活動日期：2026-12-15
基本費用：USD 900
備註：活動日期不等於付款期限；付款期限為 2026-12-01。

這組教材故意安排兩個容易讀錯的地方：Alpha 的選購費用，以及 Gamma 的付款期限。檢查標準來自你寫下的文字，AI 答案便有一把現成的尺。資料夾裡先放這三份文件，避免把其他檔案也帶進練習。

④ 開文件表格，先跑一格

選 File → New Board… → Document grid from a folder，指定剛才的資料夾。每份文件會成為一列。按 Add Question Column…（⇧⌘Q）新增兩欄：

• B 欄問題：「活動日期是哪一天？回傳 YYYY-MM-DD，排除付款期限。」答案型別選日期。
• C 欄問題：「基本費用是多少美元？只回傳數值，不含任何選購項目。」答案型別選數字。

這樣形成三份文件乘兩題的六格練習。先選 B2，按 ⌘↩執行；確認有答案與引用，再選其餘答案區按 ⇧⌘↩。不要第一輪就擴大到大量文件：先從 Inspector 看單格耗用，再決定規模。

若你想看底層怎麼配對，官方指南的寫法是 @claude('Question: {B$1}. Document: {$A2}')。往下複製時換文件，往右複製時換問題。第一次使用由 Add Question Column 建立即可，避免手動打錯參照。

四、先開引用，再按 Verify：一格的完整核對路線

⑤ 把「引文存在」和「回答正確」分開查

選 Alpha 的費用格，先看 Inspector，再按 Show Source（⌥⌘S）。依官方文件表格指南，來源面板會標示引文。現在逐項看：文件是否為 Alpha？引文是否寫基本費用 USD 1200？答案是否把 USD 300 的選購項目加進去了？

Recalc 的檢查會核對檔案裡是否有那段引文。一段真實存在的話，仍可能被拿來回答錯誤問題；所以費用格即使有引用，也要與題目一起讀。另依其 cite_cell 工具文件，HTTP 網址來源不會被抓回來檢查，本篇練習限定於本機檔案。

核對正確後，按 Cell → Verify / Unverify（⌘Y）簽核。若答成 1500，先用 Flag（⇧⌘Y）留下「基本費用排除攝影服務」的筆記，再重跑該 Agent 格。官方指南說明，旗標筆記會成為重新回答的指引。

日期欄也用同一條路線：Gamma 的活動日期應對照 2026-12-15，不要取到付款期限。你可按 Review Answers（⌥⌘R）逐格巡閱：V 簽核、F 標記、J 跳過。六格核對完成後，再往下一步。

五、改題目與移動列：先確認答案還在回答同一件事

⑥ 改題目要重看簽核，移動列要先停止工作

先做一個控制變因練習：只把費用問題改成「基本費用加上文件明列的選購項目，合計多少美元？」Alpha 的教材正解便由 1200 變成 1500。先記下舊值與原題；用 ⌘Y取消相關答案的 Verify，再執行該欄，重開引用核對。

改了輸入，不等於 Agent 已自動重答。官方把 Agent 格設計為由你明確啟動；Run Selection 又會略過已簽核格。因此題目變了，請先處理舊審查狀態，再重跑、再核對，最後重新簽核。別把保留舊值當成新問題的答案。

接著測位置。先按 Stop All Runs（⇧⌘.），若仍有互動 session，選對應格再用 Agent → End Session結束。發布版 v0.1.3 已阻擋格子執行中或排隊中的列欄移動；查閱時的 main 又新增 live session 防護，見這筆尚未包含在 v0.1.3 的修正。因此即使用下載版，也先手動結束互動 session；關掉側邊 Terminal 視窗不等於 session 已結束。

• 插入前：記下 Alpha 的文件在 A2、費用在 C2，以及 C2 的文件參照。
• 選第 2 列，按 Edit → Insert Row Above。教材預期：Alpha 整列移到第 3 列，對文件的參照應跟著改到 A3。
• 重新開 Alpha 費用格的 Inspector 與來源，核對檔名、問題、數值、引用及 Verify 狀態仍對得上。
• 按 ⌘Z 還原。再選文件欄的資料列，用 Edit → Sort Rows Z → A，核對整列資料一起移動，表頭留在排序區外。

官方的設計是結構化參照隨格子改寫；刪除被參照格則成為 #REF!。上面是你要驗收的預期，並非「任何排列都已證明安全」。每次只做一種移動，保留改前改後紀錄，才找得出哪一步對不上。

Named Cells 適合放共同規則，不是替整列加護身符

選 Edit → New Named Cell…（⌥⌘N），建立名為 practice_rule 的命名格，內容可寫：「依指定文件回答，區分活動日期與付款期限，引用支持答案的原文。」在要練習的 Agent 提示詞中加上 {practice_rule} 讀取；保留原本的 {instructions}，因為文件問答會自動建立它，提供既有的閱讀與引用規則。

命名格位於表格地址之外，適合共用規則與常數，省去記住它放在第幾列。文件與答案的配對仍要靠 {$A2} 等參照與人工檢查；原文中隨口寫的「第二份文件」也不會因此變成可靠的動態地址。

六、加一道檢查、看 Needs You，再帶著備份交件

改題目練習結束後，先恢復「基本費用」原題並重答、重核。若 Alpha 基本費用在 C2，可在旁邊加 = {C2} == 1200；移動過列就以當下位置為準。這是教材的已知答案檢查，不是所有新文件都應等於 1200。也可在日期旁加 = {B2} == "2026-12-10"。

公式讀尚未回來的 Agent 答案時會等待；答案回來後，檢查格才有可比較的值。這像在交件旁附上一條驗收線：它能抓出本例數值不符，卻不替你判斷引文是否支持結論。

按 ⌘J開 Needs You。這是集中待辦清單，包含問題、錯誤、旗標、輸入變更與新完成答案。逐項打開處理；當前 Claude headless 任務若要求未授權工具，也會在這裡顯示具體請求。看到命令先讀用途，文件比較並不需要順手批准刪檔或部署。

最後做兩種交付：File → Export Excel Workbook…用於分享表格，官方指南說引用與標記會保留為儲存格註解；另用 File → Export Board…保存 .recalc.zip，帶走工作板與其引用的外部文件副本。匯出後打開 Excel 看六個答案與註解，再開工作板副本確認文件可讀。

預算方面，Recalc 的用量面板呈現 Agent 回報、按 API 價格估算的成本；它與你帳戶實際計費方式要分開。Agent → Set Agent Budget…到上限會讓排隊的 Agent 格等待，但你手動執行的格仍能啟動。它適合節制排隊工作，別當成供應商帳單的硬上限。要擴大規模，先看Claude Code 的用量與費用說明與Token 節省教學。

常見問題：八個先講答案的判斷

1. 一定要懂程式嗎？

不用先寫程式。這篇主要靠選單、文件與兩個簡單公式；你需要能辨認檔案路徑、讀懂問題，並開啟來源核對。

2. Recalc 免費，就代表問文件免費嗎？

不代表。Recalc 是免費開源工具；Claude Code 的執行仍使用你自己的帳戶用量與計費安排，多格任務會累積模型使用。

3. 有引號圖示，就能按 Verify 嗎？

先核對再按。引號帶你找來源；請同時確認檔名、日期種類、金額範圍與問題，避免把真引文用在錯結論。

4. 為什麼改了問題，答案還是原來那個？

先查狀態。Agent 格由你明確執行，Run Selection 也會略過 Verify 格；取消相關舊簽核、重跑並核對後再簽。

5. Agent 正在跑時可以排序嗎？

執行或排隊中的格子會阻擋結構編輯。互動 session 也請先手動結束；其額外防護在查閱時的 main 已加入，尚未包含在 v0.1.3。

6. Named Cells 會自動替所有文件防止錯位嗎？

它的用途是穩定命名共用值。三份文件仍靠各自參照與整列移動維持配對，移動後應再開引用核對。

7. 本機介面就代表文件全程離線嗎？

不是。這套 Claude Code 路徑會把讀取內容送到其模型服務；本篇只放假資料。要改成本機模型，另有官方 LOCAL.md 配置，那是另一套執行條件。

8. Excel 匯出可以取代原工作板嗎？

兩者各留一份。Excel 用來閱讀與分享結果及註解，工作板封存用來保留後續操作與文件副本；交件前各打開一次。

給新手的三個重點

• 先把三份文件乘兩題做對，再擴大文件數。
• 每格都沿「答案 → 原文 → 問題 → Verify」走完一次。
• 變更問題要重核，移動列前要停工，交付時同時留 Excel 與工作板封存。