全新工具帶:Artifacts、Tasks 與型別化輸出
經官方查核的 Claude Code 輸出與協作工具導覽:live MCP artifacts、task output files、LSP,以及 Week 28–29 更新。
你將學到什麼
目前的 Claude Code 工具帶不只會讀寫檔案,也能發佈互動式輸出、協調可追蹤 tasks、呈現型別化 review findings、透過 language server 導航程式碼,並讓長時間工作在不阻塞 session 的情況下保持可見。
本課涵蓋:
- Artifacts:claude.ai 上預設私有、可原地更新的頁面
- Live MCP connector calls 與被阻擋的一般 external fetch 的精確邊界
- Task tools 與 deprecated
TaskOutput的替代方式 AskUserQuestion、ReportFindings、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 connector | Viewer 核准後,由 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 能在 60s、5m 或 10m 後自動繼續。此 timeout 只作用於 question dialog,永遠不會套用到 permission prompts 或 plan approval。
ReportFindings
自 2.1.196 起,啟用的 code-review instructions 能用 ReportFindings 回傳由 UI 呈現的清單,包含 file、summary 與 failure scenario。自 2.1.199 起,finding 還可帶 correctness、test-coverage 等 category。結構化呈現很有用,但不會把未驗證 claim 自動變成真實。
LSP
LSP tool 會向執行中的 language server 查詢 definitions、references、type errors 與 warnings。修改後 diagnostics 也可自動出現,減少只依賴文字搜尋;builds 與 tests 仍是最終的行為驗證。
隔離、Agents 與交付
EnterWorktree/ExitWorktree讓 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-reviewfinding 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 與清楚檢查路徑的最小機制。