跳至主要內容
模組 5:Fable 5 時代 8 / 8
進階 S32 Artifacts Tasks Tools Fable 5

全新工具帶:Artifacts、Tasks 與型別化輸出

經官方查核的 Claude Code 輸出與協作工具導覽:live MCP artifacts、task output files、LSP,以及 Week 28–29 更新。

2026年7月8日 16 分鐘閱讀
已校驗 課程最近校驗: 2026年7月20日

你將學到什麼

目前的 Claude Code 工具帶不只會讀寫檔案,也能發佈互動式輸出、協調可追蹤 tasks、呈現型別化 review findings、透過 language server 導航程式碼,並讓長時間工作在不阻塞 session 的情況下保持可見。

本課涵蓋:

  • Artifacts:claude.ai 上預設私有、可原地更新的頁面
  • Live MCP connector calls 與被阻擋的一般 external fetch 的精確邊界
  • Task tools 與 deprecated TaskOutput 的替代方式
  • AskUserQuestionReportFindings、LSP、worktrees 與可 resume agents
  • 2026 年 Week 28、Week 29 的相關更新

Artifacts:把輸出變成 Live Page

Artifact 是 Claude Code 發佈到 claude.ai 私有 URL 的單頁 HTML 或 Markdown。它適合 annotated diffs、dashboards、設計比較、timelines 等比 terminal prose 更適合視覺閱讀的輸出。

基本生命週期如下:

session data → .html/.htm/.md file → private artifact URL

                                      ├─ 原地更新
                                      └─ 適合時分享

第一次發佈前 Claude Code 會詢問權限。後續修訂會在同一 URL 更新,每次 publish 都形成一個版本。另一個 session 只要取得 artifact URL,也能更新它。

Artifacts 需要 Claude Code 2.1.183 以上(或支援的 Desktop app)、符合資格的 Pro/Max/Team/Enterprise plan,以及透過 /login 驗證的 session;API key 或 cloud-provider credential 不符合發佈條件。

Static External Fetch 與 Live MCP Connector

Artifact 仍是沒有 backend 的單一 self-contained page。Content Security Policy 會阻擋一般 outbound networking:

  • 遠端 scripts、stylesheets、fonts 與 images;
  • fetch 與 XHR;
  • WebSocket connections。

CSS 與 JavaScript 必須 inline,圖片需嵌入為 data URI,rendered page 也必須小於官方規定的 16 MiB。

MCP connector calls 是明確例外。 自 Claude Code 2.1.209 起,artifact 能在發佈時宣告 claude.ai MCP connectors,並在 viewer 開啟或刷新頁面時請 claude.ai 代為呼叫。Dashboard 因此能顯示當前資料或提供 connector actions,但頁面並未獲得一般網路權限。

信任邊界如下:

路徑發佈後 artifact 的行為
一般 external API/fetch/XHR/WebSocket被 CSP 阻擋
發佈時宣告的 claude.ai MCP connectorViewer 核准後,由 claude.ai 代為呼叫
Local .mcp.json server建置時可提供資料;發佈頁面無法 live 呼叫

每位 viewer 都使用自己的 connector account,並在第一次呼叫前核准,因此兩位 viewers 可能看到不同資料。Connector-backed artifacts 不能公開分享;Team/Enterprise 可保持私有或組織內分享,Pro/Max 則只能保持私有。

Build a dashboard artifact of open pull requests that pulls the live list
through my GitHub connector when the page loads. Include a fallback message
for viewers who have not connected GitHub.

Tasks:Session 的操作視圖

TodoWrite 預設已停用,改用 Task tools:

TaskCreate ──► 建立 task
TaskUpdate ──► 更新 state、details、dependencies 或 owner
TaskList   ──► 查看操作 queue
TaskGet    ──► 查看單一 task

background task ──► TaskStop
                └─► Read(output file path)

Tasks 可為 pending、in progress 或 completed,也能設定阻擋與相依關係。

TaskOutput 已 deprecated

TaskOutput 仍列在 reference 中,但已棄用。新流程應使用 Read 讀取 background task 的 output file path。Claude Code 會在 background-task details 與 completion/move-to-background 訊息中提供 output path,該檔案才是持久的檢查介面。

TaskStop 只用來停止執行中的 background task,不能取代用於管理 task-list state 與 dependencies 的 TaskUpdate

結構化互動與輸出

AskUserQuestion

AskUserQuestion 以 multiple-choice questions 釐清需求或歧義。問題預設會持續等待;可選的 askUserQuestionTimeout 能在 60s5m10m 後自動繼續。此 timeout 只作用於 question dialog,永遠不會套用到 permission prompts 或 plan approval。

ReportFindings

自 2.1.196 起,啟用的 code-review instructions 能用 ReportFindings 回傳由 UI 呈現的清單,包含 file、summary 與 failure scenario。自 2.1.199 起,finding 還可帶 correctnesstest-coverage 等 category。結構化呈現很有用,但不會把未驗證 claim 自動變成真實。

LSP

LSP tool 會向執行中的 language server 查詢 definitions、references、type errors 與 warnings。修改後 diagnostics 也可自動出現,減少只依賴文字搜尋;builds 與 tests 仍是最終的行為驗證。

隔離、Agents 與交付

  • EnterWorktreeExitWorktree 讓 main session 使用隔離的 git worktree。
  • 適合獨立處理的 subagents 預設在背景執行,caller 會收到最終結果。
  • SendMessage 可透過 ID 或 name resume 已完成的 subagent;被停止的 subagent 無法用此方式 resume。
  • SendUserFile 可把產生的檔案送到連接的 Remote Control client 或 managed cloud environment。
  • ShareOnboardingGuide 會從 /team-onboarding 上傳 ONBOARDING.md,供符合資格的 claude.ai plans 使用。

這些功能各有不同的 plan、authentication 與 provider 邊界。不要把任何一項視為普遍可用;應先查 Tools Reference。

Week 28:更安全的 Surfaces 與更好的診斷

Releases 2.1.202–2.1.206 帶來幾項相關更新:

  • Desktop app 加入 sandboxed、可設定的外部網站 browser。
  • /doctor 成為可採取行動的 setup checkup:診斷安裝健康、未使用的 skills/MCP/plugins、重複或過大的 CLAUDE.md、slow hooks,並在修改前詢問。
  • EnterWorktree 進入 .claude/worktrees/ 之外的路徑前會要求確認。
  • Background-task notifications 會明確表示沒有 human input,避免把 transcript 文字誤認為使用者核准。
  • Opus 4.8 各 effort levels 的 /code-review finding quality 改善。

Week 29:Live Artifacts 與長時間工作

Releases 2.1.207–2.1.212 再次擴充工具帶:

  • Published artifacts 支援 live MCP connector data 與 actions。
  • claude --ax-screen-reader 提供線性、適合 screen reader 的 terminal mode。
  • /fork 現在把 conversation 複製到新的 background session;原本的 in-session 行為改為 /subtask
  • 執行超過兩分鐘的 MCP calls 會自動移至背景,threshold 可調整。
  • Web searches 與 subagent spawns 各自加入預設每 session 200 次上限,可用官方環境變數調整。

建立可分享的 Review Artifact

1. 在背景執行 review workers,並用 tasks 追蹤。
2. 收集 ReportFindings records;把 unverified 項目明確分開。
3. 建立一個 CSS、JavaScript 都 inline 的 self-contained HTML page。
4. 只有 viewer 需要 fresh data 時才加入已宣告 MCP connectors。
5. 先私下發佈與檢查,再選擇允許的分享 audience。
6. 後續版本重新發佈到同一 artifact URL。

若頁面只需要 session 中已取得的資料,就維持 static 且較容易分享。若需要 live connector data,就接受較嚴格的 private/organization sharing 邊界,並為沒有 connector 的 viewers 提供清楚 fallback。

核心洞見

現在的工具帶把工作、證據、呈現與交付分開。 Tasks 追蹤執行、typed tools 結構化結果、Artifacts 呈現內容,MCP connectors 則能刷新經核准的 live data。邊界與功能同樣重要:live connector 不是一般網路存取,而 deprecated task-output tool 不應留在新流程中。

第 5 模組總結

第 5 模組結束時,系統已能選擇 model 與 effort、腳本化多代理工作、保留 memory、延遲載入 tools、排程工作,並把結果呈現在 terminal 之外。長期原則不是一次使用所有功能,而是選擇能保留 evidence、permissions 與清楚檢查路徑的最小機制。

官方來源