何時使用 artifact
當終端文字不是 Claude 產生的內容的合適媒介時，請使用 artifact：輸出內容比逐行閱讀更容易查看和互動。Claude 從您的工作階段可以存取的任何內容建立頁面，包括您的程式碼庫和透過您的連接工具提取的資料，因此頁面可以顯示需要段落才能描述的內容。例如，要求 Claude：- 透過附註的差異引導審查者查看提取請求
- 從工作階段已提取的資料呈現儀表板
- 並排配置多個設計或實作選項
- 保持在長任務執行時填入的調查時間軸
- 傳送連結給隊友，而不是將輸出貼到 Slack
- 發佈狀態板，每次有人開啟時透過 MCP 連接器提取新鮮資料
artifact 不是什麼
artifact 是工作的擷取：一個自包含的頁面，沒有後端，因此無法提供多個路由。對於具有後端的託管內部工具，請改為在您自己的基礎設施上部署它。請參閱頁面限制以取得完整的限制集合。建立成品
Claude 可能會在輸出適合頁面時自動發佈成品，或者你可以直接要求建立一個。若要要求，請用純文字命名功能或描述你想要的視覺輸出。任何比以文字閱讀更容易看到的東西都是很好的候選，例如帶有內聯註解的差異、圖表或一組選項進行比較。下面的提示是兩個例子；請參閱你可以建立的內容以了解更多模式。- 重新開啟頁面：隨時按
Ctrl+]即可重新開啟此工作階段最近的 artifact - 查看此工作階段的 artifact：提示詞下方的
⧉標籤會顯示 artifact 的名稱，若工作階段有多個 artifact，則顯示數量。在全螢幕渲染中，按一下即可開啟/artifacts清單 - 避免開啟瀏覽器：在您的環境中設定
CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0 - Remote Control：如果您是從 claude.ai、Claude Desktop 或 Claude 行動應用程式透過 Remote Control 傳送提示詞，執行工作階段的機器上不會開啟任何分頁。下次 Claude 根據您在終端機輸入的提示詞發佈 artifact 時，瀏覽器就會在該機器上開啟
Artifacts need a claude.ai login，請參閱該錯誤的說明以了解如何登入。
Claude Code 何時會在發佈前詢問
Claude 根據您輸入的提示詞所發佈的新 artifact，會直接通過，不會出現權限提示或經過分類器審查。在下列情況中，Claude Code 會先詢問您，或在自動模式中交由分類器審查該發佈：
若要讓 Claude 在未經您核准的情況下讀取工作目錄以外的檔案，請在啟動時使用
--add-dir，或在工作階段中使用 /add-dir，將其資料夾新增為工作目錄。Claude 本來就會直接讀取這些目錄中的檔案，以及其寫入頁面的暫存目錄中的檔案，而不會詢問。
如果發佈提示中包含 Also makes 1 edit to that file on disk. 之類的句子，表示 Claude 正在一個步驟中變更 artifact 的檔案並將其發佈。當您核准該提示後，Claude Code 會先發佈頁面，然後將變更寫入您的檔案。
更新成品
要求 Claude 修訂頁面，或讓長時間執行的任務在進行時重新發佈。Claude 編輯基礎檔案並重新發佈到相同的 URL。/artifacts 附加它。如果兩者都沒有，新的工作階段會建立新的成品，而不是更新現有的。
再次尋找成品
在 Claude Code 中執行/artifacts，以列出您擁有的 artifact 以及與您共享的 artifact。目前工作階段的 artifact 會排在最前面，位於 This session 之下。
選擇一個 artifact，然後按下以下其中一個按鍵：
Enter：若該 artifact 已附加到目前的工作階段，則在瀏覽器中開啟它；若尚未附加，則將其附加到目前的工作階段o：在瀏覽器中開啟它c：複製其連結d：在雲端工作階段以外，經您確認後永久刪除您擁有的 artifact。其連結將對所有人失效，包括您自己
/artifacts 在新工作階段中以及執行 /clear 之後仍可運作。
分享成品
新的成品只有你能看到。若要分享，請在瀏覽器中開啟成品，並使用頁面標題中的分享控制項。標題也會連結到你的圖庫 claude.ai/code/artifacts，其中列出你建立的每個成品。 您組織中的檢視者可以看到誰發佈了該頁面：在組織內分享的 artifact 上，您的名稱會在標題選單中；在公開 artifact 上，已登入的組織成員檢視者會在頁面標題中看到您的名稱。未登入或來自組織外部的檢視者開啟公開連結時，會看到標籤Content is user-generated and unverified. 而不是您的名稱。
你可以分享給誰取決於你的方案：
- 在組織內：在 Team 和 Enterprise 方案上，授予組織中特定人員或所有人的存取權。檢視者以組織成員身分登入 claude.ai 以查看該頁面。
- 公開：分享一個連結，網際網路上的任何人都可以開啟，無需 claude.ai 登入。在 Team 和 Enterprise 方案上，公開分享處於關閉狀態，直到擁有者為組織啟用它。
連結到特定檢視
如果頁面有多個檢視，例如分頁或區段，您可以直接連結到其中一個。請向 Claude 索取連結：#overview。
讓某人與你一起編輯
與你分享的人預設為檢視者：他們可以看到你發佈的每個版本，但無法變更頁面。在 Team 和 Enterprise 方案上，你也可以讓某人成為編輯者。在分享對話中，新增一個人並將其角色從檢視者切換為編輯者。 編輯者發佈新版本的方式與你從另一個工作階段更新成品相同：他們提供成品的 URL 給 Claude，或從/artifacts 附加它，Claude 會提取目前內容並使用他們的變更重新發佈。所有開啟該頁面的人都會即時看到每個更新。
如果編輯者在 Claude 持有該頁面較舊副本時發佈，Claude Code 會拒絕以該副本為基礎的發佈。接著 Claude 會將其變更合併到較新的版本上，然後再次發佈。
閱讀與您共享的成品
當有人與您共享成品時，您可以讓 Claude 閱讀它：提供 Claude 其 URL，或從/artifacts 附加它。
Claude 閱讀他人撰寫的頁面的方式與它使用 WebFetch 閱讀網頁的方式相同：它取得所詢問內容的摘要，而不是原始頁面，摘要報告寫入頁面的指示，而不是轉達它們。Claude Code 也會將頁面的完整原始碼儲存到本機檔案，Claude 可以在需要確切內容時開啟該檔案，例如重新發佈成品作為 編輯器。
在以下情況下，Claude Code 會在 Claude 閱讀 artifact 之前要求您核准，此外還有您的權限模式或規則所要求的任何提示：
- 沒有網路存取權的雲端工作階段：對於 雲端環境，即 None 等級。在 自動模式 中，分類器可以代為核准；在 Cowork 工作階段中，核准只能由您進行。
- 其他組織的公開 artifact：即使在自動模式下，Claude Code 也會先詢問您。在 Claude Code 無法詢問您的情況下，例如在
bypassPermissions模式中，Claude 無法閱讀該 artifact。只有在 功能旗標擷取 開啟時，Claude 才能閱讀這些 artifact。 - 無法確認擁有者或網路設定：當 Claude Code 無法確認 artifact 的建立者，或無法確認雲端工作階段的網路設定時，它會詢問您，而您的核准僅適用於該次請求。在 自動模式 中，分類器可以核准或封鎖此次讀取，而不是詢問您。
- plan mode：在 plan mode 中，Claude Code 會在 Artifact 工具閱讀您組織中其他人建立的 artifact 之前詢問您。
收集成品上的評論
當您在組織內分享成品時，與您分享的人可以在頁面上留下評論，您可以讓 Claude 讀取這些評論並回覆。您需要 Claude Code v2.1.221 或更新版本。Claude 在兩種情況下會讀取評論：- 您要求 Claude 讀取評論：提供 Claude 成品的 URL 並要求查看評論。Claude 會列出每個執行緒，並標記可以編輯成品的人發送給它的評論。
- 可以編輯成品的人向 Claude 發送評論：在頁面上的執行緒中，他們使用傳送給 Claude 發送評論，或在其中提及
@claude。無論哪種方式，他們都會啟動該執行緒。
- 您執行的是 Claude Code v2.1.221 或更新版本。
- 您不在安裝 Claude Code 或從 v2.1.221 之前的版本升級後的第一個工作階段中。在安裝或升級後的第一個工作階段中，Claude 可能還無法讀取評論；開始新的工作階段並再次詢問。
- 您未關閉功能旗標擷取。
讓 Claude 自動回覆評論
在您的工作階段發佈 artifact 後，Claude Code 會監視該 artifact 的評論。當可以編輯 artifact 的人向 Claude 發送評論時，它會立即到達您的工作階段，Claude 可以讀取執行緒並回覆，而無需您詢問。 您需要 Claude Code v2.1.228 或更新版本。如果您關閉了功能旗標擷取，Claude Code 不會監視評論。 您的權限模式決定了當發送的評論到達時 Claude 的行為：- Claude 自動回覆：如果您處於允許 Claude 在不詢問您的情況下發佈回覆的權限模式，Claude 會讀取執行緒並回覆。您會看到
Auto-replied to comment thread on Artifact: <name>。 - Claude 等待您：在計畫模式外，當發佈回覆需要您的批准時，您會看到
Comments are waiting on Artifact: <name>。Claude 隨後會要求您批准讀取執行緒，然後再次批准發佈回覆。 - Claude 在計畫模式中暫停：您會看到
Comments are waiting on Artifact: <name>，Claude 不會回覆，直到您離開計畫模式並要求它讀取並回覆。
Comments are waiting on Artifact: <name> 一次，當該小時的評論過期時，Claude 會重新開始。
執行 /tasks 以查看您的工作階段正在監視的 artifact。/tasks 會將 Claude Code 自行啟動的監視歸類在 System tasks 列下。在該列上按 Enter 即可列出它們。您要求 Claude 啟動的監視會顯示在 Monitors 下。
您可以透過以下任何方式停止 Claude 自動回覆：
- 在閒置提示字元處按一次 Ctrl+C：Claude 暫停回覆您的工作階段正在監視的每個成品。在您發送下一條訊息後，回覆會重新開始。
- 在
/tasks中停止任務：Claude 停止回覆該成品，直到您要求它在那裡恢復回覆。重新發佈成品不會再次開始回覆，當您稍後恢復工作階段時，停止仍然適用。 - 在 3 秒內按兩次
Ctrl+X Ctrl+K：停止每個執行中背景子代理的和弦也會停止 Claude 在工作階段的其餘時間內回覆每個成品。要求 Claude 恢復回覆不會撤銷此停止。
使用 MCP 連接器拉取即時資料
每當有人檢視 artifact 時，artifact 可以呼叫 MCP 連接器，因此頁面會顯示目前資料，而不是建立該頁面的工作階段所收集的快照。來自 artifact 的連接器呼叫適用於 Pro、Max、Ultra、Team 和 Enterprise 方案，並需要 Claude Code v2.1.209 或更新版本。在較早的版本上，Claude 會發佈該頁面，其中包含工作階段在建立時收集的任何資料。 若要建立連接器支援的頁面，請在提示中命名連接器和您想要的資料：.mcp.json 的伺服器）可以在 Claude 建立頁面時提供資料，但已發佈的頁面無法呼叫它們。
該頁面在載入時會擷取資料，並可以按間隔重新整理或當檢視者在頁面上使用重新整理控制項時重新整理。回應會快取在檢視者的瀏覽器中，因此重新開啟的頁面會立即從快取的回應呈現，然後使用新鮮結果進行更新。
連接器呼叫如何為檢視者運作
當已發佈的頁面呼叫連接器時，該呼叫會使用檢視該頁面的人的帳戶，而不是發佈該頁面的人的帳戶：- 每個檢視者使用自己的連接器：呼叫會透過檢視帳戶的已連接工具進行，因此兩個人開啟相同的儀表板可能會看到不同的資料，取決於他們的帳戶可以存取的內容。該頁面永遠不會看到任何人的認證；claude.ai 代表該頁面進行呼叫。
- 檢視者先核准存取：claude.ai 在該頁面的第一個連接器呼叫之前會要求每個檢視者的許可。拒絕的檢視者或尚未連接該頁面使用的連接器的檢視者仍然可以看到該頁面，但沒有其即時區段。
- 動作也使用檢視者的帳戶：頁面可以提供控制項，這些控制項會叫用具有副作用的連接器工具，例如發佈訊息或更新問題。該動作會透過選擇該控制項的任何人的帳戶進行。
頁面對檢視者不顯示即時資料
當連接器支援的頁面呈現但其即時區段對您組織中的檢視者保持空白時，請檢查這些原因：- 檢視者尚未連接連接器：連接器是按帳戶的，因此每個檢視者都需要自己的連接到該頁面呼叫的每個連接器。他們可以在 claude.ai 上的 Customize > Connectors 下新增一個，然後重新載入頁面。
- 檢視者拒絕了許可要求：拒絕會持續到該頁面載入的其餘部分。重新載入頁面會帶回許可要求。
- 連接器呼叫已針對組織關閉：擁有者控制管理設定中的 Enable artifact connectors 切換。
- 頁面呼叫連接器未公開的工具名稱：受影響的區段對所有人（包括您）保持空白。當頁面命名閘道式連接器後面的個別工具，而該連接器只公開其自己的少數工具時，就會發生這種情況。要求 Claude 修正頁面呼叫的工具名稱並再次發佈。 當 Claude 發佈頁面且該連接器的工具在您的工作階段中可用時，Claude Code 會檢查頁面宣告的工具名稱與它們的對比，警告 Claude 不符合的名稱，並在沒有任何名稱符合時拒絕發佈。在 v2.1.265 之前，它會在不檢查它們的情況下發佈頁面。
提供檔案下載
成品可以向檢視者提供頁面生成的檔案，例如表格的 CSV 匯出或圖表的 PNG。檢視者透過頁面上的下載控制項（例如按鈕）來儲存檔案。檔案下載是 claude.ai 按帳戶啟用的執行時功能，因此 Claude 在建立控制項之前會檢查您的帳戶是否具有此功能。 檢視者無法從普通下載連結或頁面上的指令碼儲存檔案，因為 claude.ai 上的成品檢視器會阻止頁面本身啟動的任何下載，包括指向data: 或 blob: URL 的連結。如果頁面具有以這種方式建立的下載按鈕，請要求 Claude 使用下載功能重新建立它們。
若要提供檔案，請在您的提示中要求控制項和檔案格式：
您可以建立的內容
成品是單個 HTML 頁面，因此您可以用 HTML、CSS 和內聯 JavaScript 表達的任何內容都在範圍內。下面的模式最常出現。逐步查看變更
要求一個頁面，在相關行旁邊呈現差異或設計變更並帶有註解，以便審查者可以在程式碼旁邊閱讀您的推理，而不是從描述中重建它。比較替代方案
要求在一個頁面上有多個變體，以便您可以相互評估它們。這適用於佈局、複製、API 形狀或實現計劃。使用互動控制項進行調整
要求滑塊、切換或輸入欄位綁定到您正在調整的任何內容，以便您可以直接探索值，而不是描述它們。將結果帶回您的工作階段
成品可以充當輕量級編輯器，用於您隨後交給 Claude 的決定。要求匯出控制項，產生您可以貼到終端的文字，以便與頁面互動的結果流回工作階段，而不是停留在頁面上。追蹤進行中的工作
要求 Claude 在長任務執行時保持成品最新，以便任何有連結的人都可以跟進，而無需閱讀終端。改進視覺設計
Claude 在建立成品時會應用內建的設計技能，因此頁面會獲得經過深思熟慮的調色盤、排版和版面配置，無需額外提示。該技能也會在選擇自己的設計之前，先查看您專案中是否存在現有的設計系統。設計權杖是您設計系統重複使用的具名顏色、排版和間距值。為了保持成品與您產品品牌的一致性，請將它們記錄在 Claude 可以找到的地方，例如專案的 CLAUDE.md 或您儲存庫中的主題檔案：@font-face 資料 URI，並為每個字型提供備用堆疊，因此即使字型無法載入，頁面仍會呈現。若要使用特定字型，請在您的提示或設計系統中命名它。
從投影片、設計或文件範本開始
與其從頭開始建立頁面，Claude 可以從您 claude.ai 帳戶上的其中一個範本開始建立成品：Claude Slides 用於簡報、Claude Design 用於視覺設計，或 Claude Docs 用於其他人將閱讀和編輯的文件。每個都在 claude.ai 上的自己編輯器中開啟，您和您的隊友可以直接變更它或要求 Claude 變更，並將其匯出為 PowerPoint、PDF 或 Word 等格式。 若要從範本開始，請描述您想要的內容，例如「將遷移說明轉換為週四審查的投影片組」或「將此計畫寫成團隊的文件」。Claude 會選擇相符的範本，從您的要求和工作階段已有的內容填入，並提供您連結。對於投影片組或設計，您也可以使用簡介執行/slides 或 /design。
範本處於測試版。它們在 Pro、Max、Ultra 和 Team 方案上預設為開啟。在 Enterprise 方案上，擁有者會在 Organization settings > Artifacts 下開啟每個範本。如果您的組織已關閉 Slides 範本，
/slides 不會出現；如果它已關閉 Design 範本，/design 不會草擬設計。兩個命令都需要 Claude Code v2.1.265 或更新版本，以及 artifact 可用的工作階段。製作投影片組
使用簡介執行/slides，說明投影片組涵蓋的內容及其對象：
/slides 時沒有簡介，Claude 會在建立任何內容之前詢問投影片組應該涵蓋的內容。
草擬設計畫布
若要模擬 UI、螢幕流程、登陸頁面或海報，而不是建立頁面，請使用簡介執行/design。Claude 會在一個畫布上將設計草擬為美工板，並將畫布發佈為 Claude Design 成品。簡介會命名您想要繪製的內容：
使用 Claude Docs 撰寫文件
Claude Docs 作為 claude.ai 連接器而不是命令到達 Claude Code。連接後，/mcp 會將其列為 claude.ai Claude Docs。針對供其他人使用的文件的要求會進入 Claude Docs 而不是成品頁面：規格、提案或您在工作階段中進行的計畫寫法。Claude 會在草擬文件時提供文件的連結。
屬於程式碼庫的文件（例如 README）會保持為檔案。若要取得 Claude 否則會放在 Claude Docs 中的內容的檔案，請命名格式，例如 .docx 或儲存庫中的 Markdown 檔案。若只要關閉 claude.ai Claude Docs 連接器，請參閱停用 claude.ai 連接器。
頁面限制
每個成品是一個獨立的頁面。Claude Code 會將您發佈的檔案包裝在 HTML 文件殼層中，並在嚴格的內容安全政策 (CSP) 下提供服務，這會限制頁面可以執行的操作。
產生成品會像任何其他回應一樣使用輸出權杖，而樣式化頁面比相同內容作為終端文字更耗費權杖。內嵌 CSS、用於互動控制的 JavaScript，尤其是嵌入為資料 URI 的影像，是主要貢獻者。若要減少成品的權杖成本：
- 對於圖表，優先使用 SVG 或 HTML 和 CSS，而不是嵌入的光柵影像
- 省略您不需要的互動性
- 讓頁面摘要大型資料集，而不是完整內嵌它們
可用性
成品需要下面的每個條件。當不滿足其中一個時，Claude 寫入本地 HTML 檔案或說它無法發佈。
您的組織是否允許成品來自您組織的政策，Claude Code 從
api.anthropic.com 載入。當 Claude Code 無法載入政策時，成品不可用。當您要求一個時，Claude 會說明原因。
如果涉及代理、VPN 或網路篩選，請要求您的 IT 管理員允許 api.anthropic.com 通過。Claude Code 會在背景中持續重試，一旦政策載入並允許，成品就會變成可用。
停用 artifacts
若要關閉您自己工作階段中的 artifacts，無論您的組織設定為何，請使用以下任一方式：
一旦您在
--settings 檔案中或使用 CLAUDE_CODE_DISABLE_ARTIFACT 關閉 artifacts，或您的管理員在受管設定中關閉它們，就沒有設定檔能將其重新開啟。
您也可以在專案的 .claude/settings.json 或 .claude/settings.local.json 中設定 "enableArtifact": false，以關閉該專案中工作階段的 artifacts。任一檔案中的 "enableArtifact": true 都不會將其重新開啟。在專案和本機設定中接受此金鑰需要 Claude Code v2.1.242 或更新版本。
如果您新增 WebFetch deny 或 ask 規則但不含 domain: 部分，它不會關閉 artifacts 或阻止 artifact 讀取。permissions 中 deny 或 ask 內的 WebFetch(domain:claude.ai) 規則確實適用於 artifact 讀取。
為您的組織管理成品
Team 和 Enterprise 方案上的擁有者從 claude.ai 管理設定控制成品。成品內容儲存在 Anthropic 營運的基礎設施上，僅對發佈組織的已驗證成員可見，以及他們與之分享的人員，除非成品是公開分享。啟用或停用成品
要為整個組織啟用或停用成品，請前往 組織設定 > 成品並使用成品切換。在具有角色型存取控制的 Enterprise 方案上，您還可以將成品範圍限制為特定角色：前往 組織設定 > 角色、編輯角色，並設定成品許可。控制來自成品的連接器呼叫
來自成品的連接器呼叫有自己的切換，與開啟或關閉成品的成品切換分開。前往 組織設定 > 功能並使用啟用成品連接器切換。同一個切換控制在 claude.ai 對話中建立的成品的連接器呼叫。控制公開分享
在 Team 和 Enterprise 方案上，公開分享預設為關閉。要讓成員將成品發佈到任何人都可以檢視而無需登入的公開連結，請前往 組織設定 > 成品並在成品切換下開啟外部分享。將其關閉會阻止透過現有公開連結的存取，而不會變更每個成品的對象；如果您重新啟用它，存取將恢復。設定保留政策
要設定在自動刪除之前保留成品的時間，請前往 組織設定 > 資料和隱私。您可以為仍然是其作者私人的成品和已共享的成品設定單獨的保留期。檢查稽核日誌
發佈、分享和刪除成品各自出現在您組織的稽核日誌中，位於claude_artifact_* 事件類型下，與在 claude.ai 對話中建立的成品使用的相同系列。
允許列表檢視器網域
claude.ai 上的檢視器從沙箱化的*.claudeusercontent.com 來源載入每個成品。如果您的組織限制出站網路存取，請將該網域新增到您的允許列表中，以及 claude.ai。請參閱網路存取要求以了解完整清單。
從 Google Fonts 載入字型的成品也會要求 fonts.googleapis.com 和 fonts.gstatic.com。兩個主機都是選用的。如果您封鎖它們，成品會以備用字型呈現。使用快速拒絕而不是無聲丟棄來封鎖，以便字型要求立即失敗，而不是延遲頁面的首次呈現。
成品也可以從 cdnjs.cloudflare.com、cdn.jsdelivr.net、cdn.tailwindcss.com、code.jquery.com 和 unpkg.com 載入 JavaScript 程式庫（例如 React 或圖表套件），而不能從任何其他外部主機載入。如果您封鎖這些主機，成品中依賴程式庫的部分將無法運作，與被封鎖的字型不同，被封鎖的程式庫沒有備用方案。在這裡也使用快速拒絕，以便被封鎖的程式庫要求立即失敗，而不是掛起直到逾時。
使用 Compliance API 列出和刪除成品
Compliance API 提供端點來列出組織的成品、檢索特定版本的內容和刪除成品：
有關請求和回應 schema，請參閱 Compliance API 參考。
相關資源
- 瀏覽與成品配對的提示模式和工作流程
- 將您重複使用的成品提示轉變為技能，以便您可以將其作為命令呼叫
- 連接 MCP 伺服器，以便 Claude 可以將資料提取到成品中，同時建置頁面