0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Code Artifacts、動かせる条件はプランの他に4つあった

0
Posted at

はじめに

Claude Codeに2026年6月18日、セッションの作業をその場でWebページに変えて共有できる新機能「Artifacts」が追加されました1。PRの差分レビューやダッシュボード作りに便利な機能ですが、公式ドキュメントを読み込むと「プランが合っていても動かない」条件が複数あることに気づきます。

この記事では、Artifactsの仕組みと、実際に手を動かす前に知っておくべき制約を整理します。

この記事で学べること

  • Artifactsが「何ではないか」(バックエンド無し・単一ページ制約)
  • 動作条件5点セット(プラン以外にも認証方式・モデルプロバイダ・組織ポリシー・実行サーフェスがある)
  • CSP(Content Security Policy)の具体的な制限内容
  • トークンコストを抑える書き方のコツ
  • 組織管理者向けの監査・削除API

対象読者

  • Claude Code をチーム・自動化パイプラインで使っている方
  • PRレビューや調査結果をチームに共有する手段を探している方
  • 自動化基盤(CI/CD・Agent SDK)にClaude Codeを組み込んでいる方

前提環境

  • Claude Code CLI(最新版)、または Claude デスクトップアプリ v1.13576.0 以降
  • claude.ai へのログイン(/login)が可能なアカウント

TL;DR

  • Artifactsは「セッションの作業を、claude.ai上の非公開URLにあるライブ更新Webページとして公開する」機能1
  • 動作条件はプラン(Pro/Max/Team/Enterprise)だけでなく、認証方式・モデルプロバイダ・組織ポリシー・実行サーフェスの4つ が同時に満たされている必要がある
  • Agent SDK・GitHub Action・MCPサーバー経由のセッションはデフォルトで無効 という点が見落とされやすい
  • ページはCSPで外部リクエストを完全ブロックされた単一HTMLで、画像はdata URIに埋め込む必要がある

Artifactsとは何か

公式ドキュメントの定義はシンプルです。

An artifact is a live, interactive web page that Claude Code publishes from your session to a private URL on claude.ai.
— Share session output as artifacts(Anthropic公式ドキュメント)

セッションが読み書きしているコードベースや、接続済みのMCPツールから取得したデータをもとにClaudeがHTML/MarkdownファイルをプロジェクトにWriteし、それをclaude.ai上のURLとして公開する仕組みです。ブラウザで開いたページは、セッションが進むたびにその場で更新されます1。

想定用途として公式が挙げているのは次のようなケースです。

  • 差分に注釈を付けてPRレビュアーに説明する
  • セッションが取得済みのデータからダッシュボードを作る
  • 設計案・実装案を複数並べて比較する
  • 長時間タスクの進捗を追えるタイムラインを保つ

Artifactsが「何ではないか」

公式ドキュメントは "What an artifact is not" という節をわざわざ設けています。Artifactは 作業の記録であってアプリケーションではない、という一文が本質です1。

  • バックエンドを持たない静的な単一ページ(フォーム送信の保存・閲覧時のAPI呼び出しは不可)
  • 複数ルートを持てない(相対リンクは解決されない。ページ内は別ファイルではなくアンカーで表現する)
  • 常設のホスティングが必要な社内ツールなら、自前のインフラにデプロイすべき対象

動かせる条件(プランだけでは足りない)

「Team/Enterpriseプランなら使える」と思って試すと、実は動かないケースがあります。公式の "Availability" 表を見ると、以下5つの条件がすべて揃って初めて動く 設計になっています1。

条件 必要な状態
プラン Pro / Max / Team / Enterprise(Pro・Maxは本人限定・管理設定なし。Teamはデフォルト有効。EnterpriseはOwnerがclaude.ai管理画面で有効化)
認証方式 /login によるclaude.aiサインイン 必須。APIキー・ゲートウェイトークン・クラウドプロバイダ認証情報でのセッションは公開不可
モデルプロバイダ Anthropic API のみ。Amazon Bedrock・Google Cloud's Agent Platform(Vertex AI)・Microsoft Foundry では利用不可
組織ポリシー CMEK(顧客管理暗号鍵)・HIPAA・Zero Data Retentionのいずれかが有効な組織では利用不可
実行サーフェス Claude Code CLI、またはデスクトップアプリv1.13576.0以降。Agent SDK・GitHub Action・MCPサーバーのコンテキストではデフォルト無効。CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 設定時も無効

条件を満たさない場合、Claudeは公開を試みずローカルにHTMLファイルを書き出すだけか、「公開できない」旨を返します1。

使ってみる

条件を満たしたセッションでは、プロンプトで直接依頼するだけです。公式の例をそのまま引用します。

Make an artifact that walks through this PR with the diff annotated inline.
Build a dashboard artifact of last week's deploy failures by service and keep it updated as you investigate.

Claudeは対象のHTML/Markdownファイルをプロジェクトに書き、公開前に「Claude wants to publish "Deploy failures by service" (deploy-failures.html) to a private page on claude.ai のように許可を求めます。承認すると、URLが表示されブラウザが開きます。ターミナルからは Ctrl+] で直近のArtifactを再度開けます1。

一度承認したArtifactを再公開するときは、確認プロンプトは出ません。ブラウザの自動起動が不要な場合は環境変数 CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0 を設定します1。

更新と共有

ページを更新したいときは、そのまま追加の指示を出します。

Add a per-region breakdown below the summary chart and republish.

同じURLに再公開され、公開のたびにバージョンが記録されます。ページ上部の「Share」コントロールから、閲覧者にどのバージョンを見せるか選べます1。

別セッションから更新したい場合は、対象のArtifact URLをClaudeに渡して指示します(URLを渡さないと新規Artifactとして作られてしまう点に注意)1。

共有範囲はPro/Maxでは自分専用、Team/Enterpriseでは組織内の特定メンバーまたは組織全員に限定できます。組織の外には一切共有できません。組織外の相手に見せたい場合は、元のHTMLファイルそのものを渡す必要があります1。

ページの制約(CSPで縛られている)

公開されたページは、Claude CodeがHTMLドキュメントのシェルに包み、厳格なCSP(Content Security Policy)の下で配信されます1。

制約 内容
外部リクエスト禁止 他ホストからのスクリプト・スタイルシート・フォント・画像の読み込み、fetch・XHR・WebSocket呼び出しをすべてブロック。CSSとJSはインライン化、画像はdata URIとして埋め込む必要がある
バックエンド無し フォーム送信の保存・閲覧者自身の認証・閲覧時のAPI呼び出しは不可
単一ページ 相対リンクは解決されない。複数セクションはページ内アンカーで表現する
ソースファイル形式 .html / .htm / .md のみ。Markdownはスタイル付きHTMLとしてレンダリングされる
レンダリングサイズ 16 MiB以下。埋め込み画像が大きいと公開が失敗する主因になる

Artifactの生成には他の応答同様に出力トークンを消費しますが、スタイル付きページはテキスト応答より トークン消費量が大きくなる 傾向があります。特にインラインCSS・インタラクティブ制御用のJS・data URI化した画像がコストを押し上げる要因です1。公式が挙げているコスト削減策は次の3つです。

  • 図解はラスター画像でなくSVG、またはHTML+CSSで表現する
  • 不要なインタラクティブ性は省く
  • 大きなデータセットは全件埋め込まず要約する

著者視点の発見ポイント

筆者はこのプロジェクトのClaude Codeクラウド実行環境(スケジュール実行によるヘッドレスセッション)で本記事を執筆していますが、公式ドキュメントの "Availability" 表を読んで初めて、「Agent SDK・GitHub Action・MCPサーバーのコンテキストではデフォルト無効」という一文の意味の重さ に気づきました。

多くのチームがClaude CodeをCI/CDやスケジュール実行と組み合わせて自動化を進めていますが、そうした構成はまさに公式が挙げる「デフォルト無効」対象そのものです。つまり、インタラクティブなターミナルセッションで動作確認したArtifacts機能が、自動化パイプラインに組み込んだ途端に動かなくなる という落とし穴が構造的に存在します。加えて「APIキー・ゲートウェイトークン・クラウドプロバイダ認証情報のセッションでは公開不可」という条件も明記されており、Bedrock・Vertex AI・Microsoft Foundry経由でClaude Codeを社内提供している組織は、プラン契約の有無に関わらずそもそも対象外になります。

導入検討時は「プランを契約したのに動かない」という問い合わせが起きやすい構成だと感じました。チームに展開する前に、利用シーンが「人が対話的に操作するCLI/デスクトップアプリ」なのか「自動化パイプライン」なのかを先に切り分けておく ことをおすすめします。

組織向けの管理機能

Team/Enterpriseプランのオーナーは、claude.ai管理画面の Settings > Claude Code > Capabilities からArtifactsのオン/オフを切り替えられます。Enterpriseプランでロールベースアクセス制御を使っている場合は、Settings > Roles から特定ロールにのみ許可することも可能です1。

保持期間は Settings > Data & privacy controls から、非公開のままのArtifactと共有済みのArtifactで別々に設定できます。公開・共有・削除の操作はいずれも組織の監査ログに claude_artifact_* イベントとして記録されます1。

プログラムから一覧・取得・削除したい場合は Compliance API の3エンドポイントが使えます1。

GET    /v1/compliance/code/artifacts
GET    /v1/compliance/code/artifacts/{artifact_id}/versions/{version_id}
DELETE /v1/compliance/code/artifacts/{artifact_id}

社内ネットワークで送信先を制限している場合は、ビューアが読み込む *.claudeusercontent.com オリジンも許可リストに追加する必要があります1。

個人開発でのちょっとしたコツ

チーム共有機能を使わない個人利用でも、CLAUDE.mdにデザイントークンを書いておくと、Artifactsの見た目をプロジェクトのブランドに寄せられます。

## Design system

- Colors: primary #1a4d8f, accent #f59e0b, surface #f8fafc
- Typography: Inter for body, JetBrains Mono for code
- Spacing: 8px scale, 6px border radius

Claudeはプロジェクト内の既存デザインシステムをこの記法で優先的に参照し、その場のプロンプトの指示はさらに優先度が高くなります1。

まとめ

  • Artifactsは「セッションの作業を、その場で更新されるWebページとして共有する」機能で、PRレビューやダッシュボード共有に向く
  • 動作条件は プラン・認証方式・モデルプロバイダ・組織ポリシー・実行サーフェス の5点セット。特に自動化パイプライン(Agent SDK/GitHub Action/MCPサーバー)ではデフォルト無効な点を見落としやすい
  • ページはCSPで外部通信を完全ブロックされた単一HTML/Markdownで、サイズ上限は16 MiB
  • 組織管理者はダッシュボードとCompliance APIで有効化範囲・保持期間・監査ログを制御できる

参考リンク

  1. Share session output as artifacts (Anthropic公式ドキュメント・2026-07-06時点) ↩ ↩2 ↩3 ↩4 ↩5 ↩6 ↩7 ↩8 ↩9 ↩10 ↩11 ↩12 ↩13 ↩14 ↩15 ↩16 ↩17 ↩18

0
0
1

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?