2026 年 10 月 28 日に、GitHub が issue artifacts のパブリックプレビューを発表しました。Issue に Markdown、HTML、リンクを添付できる機能です。Claude Code のようなエージェントが作る計画や調査結果を、作業と同じ場所に残せるのではと思い、手元で試しました。この記事では、試した内容と分かったことをまとめます。
結論
- Claude Code は、Issue の artifact 一覧から調査ログを見つけて読み、続きを追記できた
- HTML のモックはプレビューで見られる。JavaScript は動かないので、動きをつけたいなら CSS だけで作る
- tsx はテキストとして表示される。見た目を見せるなら、描画済みの HTML に書き出しておく
issue artifacts とは
Issue の本文やコメントとは別に、ファイルやリンクを artifact として添付できます。種類は 3 つです。
- Markdown。計画、調査、根本原因分析などの文書
- HTML。図やフローチャート。プレビューとソースを切り替えて見られる
- リンク。Slack や Teams のスレッド、プロトタイプなど
GitHub Actions の artifact とは別物です。操作は github.com の画面か、gh issue artifactコマンドでできます。
使い始めるまで
手元の gh は 2.100.0 で、gh issue artifact がありませんでした。brew upgrade gh で 2.103.3 に上げると使えました。
注意したい点が 1 つあります。changelog は公開プレビューと書いていますが、gh v2.103.0 のリリースノートは「プライベートプレビューで、対象のリポジトリのみ動く」と書かれています。私の環境では、個人アカウントの非公開リポジトリで、設定をせずに作成まで通りました。ほかのリポジトリでは動かない可能性があります。
試したこと
Issueを立てて実際に試してみます。
Markdown と画像
本文に画像の参照を書き、--attach で画像を渡すと、次のように作れます。
gh issue artifact create 8 research.md --attach "flow.png#流れの図"
保存すると、本文中の flow.png が `https://github.com/user-attachments/assets/…` の URL に書き換わりました。画像は Markdown の中に埋め込まれる形になります。
Issue の画面では、本文の下に「Artifacts」の一覧が出ます。開くと右側のパネルに Markdown が描画され、画像も表示されました。

非公開リポジトリの画像は、ログインしていない状態で URL を開くと 404 でした。公開範囲はリポジトリに従うようです。
HTML
.html のファイルを渡すと、種類が embedded_html の artifact になりました。
画面では、既定でソースが表示されます。上部には「プレビューはコードを実行し、内容を外部サイトに送る可能性がある」という警告があり、切り替えボタンで描画に変わります。

図2: HTML の artifact は既定でソースが表示され、上部に警告が出る

プレビューに含めた JavaScript のボタン(「詳細を表示」)は、3 回クリックしても動きませんでした。外部への通信が CSP で止められたという警告がコンソールに出ています。動きのある図を載せたいときは、静的な HTML にしておくほうが確実です。
画面のモックを載せる
HTML が使えるなら、画面のモックも artifact に置けます。Issue に「こういう画面にしたい」という案を、文章ではなく見た目で残せます。
試しに、artifact の一覧と、版の切り替えを持つ小さなモックを作りました。最初は JavaScript で一覧の行やタブを切り替える作りにしたところ、プレビューでは右側が空のままで、行をクリックしても変わりませんでした。前の節の「詳細を表示」ボタンと同じ結果です。
そこで JavaScript をやめ、CSS だけで書き直したところ、表示の切り替えはプレビューでも動きました。

tsx は見られるか
画面のモックを React で作ることも多いので、tsx も試しました。結論として、tsx のモックは描画済みの HTML に書き出しておくと、見た目を確認できます。tsx のままではテキストになり、バンドルした HTML では中身が空になります。
次の 3 つを同じ Issue に置いて比べました。
card.tsxをそのまま渡すと、ただのテキスト文書になりました。プレビューの切り替えボタンはなく、コードがそのまま並びます。- esbuild で 1 つの HTML に固めたもの(428KB)は、プレビューを開いても中身が空でした。React が描画されなかった理由までは調べていません。上の JavaScript が動かなかった結果と同じ流れで、スクリプトが実行されていないと考えています。
renderToStaticMarkupで描画済みの HTML だけを書き出して渡すと、表示されました。ただしボタンは押しても変わらず、静止した見た目として使う形になります。


ソースの tsx は、別の artifact か Git に置き、見た目の確認用に HTML を添えます。
リンクと標準入力
URL を渡すとリンクの artifact になり、--name で名前を付けられます。標準入力から作ることもできるので、ログをそのまま添付する使い方ができます。
printf 'gh 2.103.3: artifact あり\n' | gh issue artifact create 8 --body-file - --name 'gh バージョン確認'
編集と版の管理
edit のたびに版が増えます。--restore-version 1 で戻すと、履歴が巻き戻るのではなく、v1 の内容で新しい版(v4)が追加されました。download --version 2 --output - で、旧版の本文も取り出せます。view --json versions を使うと、各版の本文と更新者、時刻をまとめて取れます。
まとめて取り出す
download 8 --dir ./artifacts で、Issue の artifact を 1-plan.md、2-demo.html、4-changelog-....url のようなファイルとして書き出せました。
Claude Code と組み合わせる
調査ログを artifact(#7)として Issue に置きました。分かったことと未確認の項目を書き、最後に「次にやること: 同時編集の挙動を、別々のシェルから edit を打って確かめる」と書いています。
そのうえで、作業ディレクトリが空の Claude Code に次のように頼みました。許可したコマンドは gh issue artifact などに絞っています。
GitHub のテスト用リポジトリの Issue #8 に、前回の調査の続きがあります。 gh issue artifact で Issue の artifact を調べて、前回の調査ログを読み、次にやるべきことを実行してください。 実行結果は、調査ログの artifact に新しい節として追記して保存してください。
artifact の番号は教えていません。結果は次のとおりです。
- 一覧から調査ログを見つけて読み、「次にやること」を実行した
- 本体のログを壊さないよう、捨て用の artifact を別に作って試した
- 結果を調査ログに「同時編集の確認」の節として追記した。版は 1 から 2 になった
- 追記の保存前に、ログが読んだときから変わっていないことを確かめていた
私が確認できた範囲では、追記された内容は artifact に残っていて、前回の節は崩れていませんでした。
CLAUDE.md に手順を書いておく
CLAUDE.md に、artifact を確認する手順だけを書いても試しました。
Issue 番号が分かる作業では、回答や作業の前にgh issue artifact list <番号>で添付された artifact を確認し、関係するものをgh issue artifact view <番号> <artifact番号>で読む。
空のディレクトリで、「Issue #8 で、同時編集の確認はどうなった?結果を教えて。」とだけ頼みました。依頼文に artifact とは書いていません。それぞれ 1 回ずつの結果です。
- CLAUDE.md がある場合は、artifact の一覧から調査ログを読み、確認結果を答えた
- CLAUDE.md がない場合は、Issue の本文とコメントだけを見て「記録は見つからない」と答え、artifact には行き着かなかった
調査ログの中身は CLAUDE.md に書かず、Issue 側に置いたままという運用ができると思います。
気づいた点
- artifact は Issue にだけ付き、PR には付かない。
view 3 8と引数を逆にしたとき、#3 が PR だったためartifacts are only supported on issuesと返った - 対象外のリポジトリで
listを打つと、エラーではなく空の一覧が返る。コマンドだけでは、対象かどうかを判断できない - HTML のプレビュー内の JavaScript は、手元では動かなかった。画面を切り替えたいときは CSS だけで作る
- tsx はテキストとして保存される。見た目を見せるには、描画済みの HTML に書き出しておく
- 削除(
delete)は復元できない。--yesを付けると確認なしで消える - まだプレビューで、仕様は変わる可能性がある
使ってみた所感
これまでは Markdown ファイルに調査ログを書いてきて、競合とファイルの肥大化に困っていました。Claude Code が一覧から調査ログを見つけて読み、続きを追記できたので、Issue ごとに分けて持つ形で読み込ませる使い方は、うまく回りそうだと感じています。
HTML のモックをその場で見られる点も便利です。JavaScript は動きませんが、CSS だけで版の切り替えまで作れるので、「こういう画面にしたい」という案を Issue に見た目で残せます。
まとめ
調査ログを 1 つの大きな Markdown に積む代わりに、Issue ごとの artifact に分けて持てば、競合やファイルの肥大化の悩みを減らせそうです。HTML のモックも置けるので、issue artifacts は Claude Code と一緒に使うと、業務の記録を残す場所として便利になるかもしれません。