メインコンテンツへスキップ
見出し画像

Claude Code の開発を「ドット絵オフィスで社員が働く映像」に変換する作り方

    画像
    Claude Code の開発ログが、そのままドット絵オフィスで働く社員に変わる。

    この記事の最新版はZennにあります(加筆・修正はZenn側で行っています)。→ https://zenn.dev/pico_shacho/articles/faa01e4a7b4dc5

    この記事について

    想定読者:Claude Code を使う個人開発者で、日々の開発の様子を発信の映像素材として使ってみたい人。
    これで何ができるか:開発中に自動でたまる作業ログを、ローカルだけで動く「ドット絵オフィス」の画面に変換します。役割(社長・番頭・役員・各部署)が机で働く様子として一覧でき、いま誰が動いたかが一目で分かります。ローカル完結で追加費用0円、イベント発生から画面反映まで約0.1秒(実測109ms)でした。画面に出すのは「役割・部署・動作・ファイル種別」だけで、コード本文やファイル名、パスは出さない設計です。

    作り方は5ステップです。各ステップは「なぜそうするか」→「やること」の順で、数字はすべて自分の実測値だけを載せています。コードは動かせる範囲で載せますが、パスはプロジェクトルートからの相対表記です。

    全体像は次のファイルです。

    • 作業ログを記録するフック:`.claude/hooks/log_event.py`

    • 機密ファイルの読み取りをブロックするフック:`.claude/hooks/block_secrets.py`

    • ログを配信するサーバとドット絵画面:`visualizer/server.py`、`visualizer/index.html`

    • フックの登録:`.claude/settings.json`

    なぜ作ったか

    匿名で開発の様子を発信したい。でも実際の画面には、ファイル名・パス・端末のユーザー名など、そのままでは出せない情報が多すぎます。じっさい私は、匿名でやると決めた初日に、自分の報告文へ端末のユーザー名が入ったパスを書いてしまいました。だから「画面に出す情報を、あとで消すのではなく最初から絞る」方向で、この仕組みを作りました。

    必要なもの

    • Python(3系)

    • Claude Code(フックが使える環境)

    • FastAPI と uvicorn(可視化サーバ用。`pip install fastapi uvicorn`)

    ※ OS により `python` と `python3` が分かれます。以降のコマンドは環境に合わせて読み替えてください。


    手順1:作業ログを7項目だけ記録するフックを作る

    なぜそうするか

    映像素材にするなら、記録するのは「働いている雰囲気」を出すのに必要な最小限でいい、と考えました。コードの中身やファイル名まで残すと、匿名で発信するときにそのまま事故につながります。そこで「記録してよい項目」をあらかじめ決め打ちするホワイトリスト方式にしました。安全そうに見える項目でも、リストに無ければ一切書きません。

    やること

    Claude Code のフック(`PreToolUse` / `PostToolUse` / `SubagentStop` など)で小さな Python を呼び、次の7項目だけを1行のJSONとして追記します。

    • 時刻 / イベント名 / ツール名 / 役割名 / スキル名 / 成功可否 / ファイル種別

    ポイントは「ファイル種別」です。ファイル名やパスをそのまま残すのではなく、拡張子を「文書・スクリプト・コード・画面・設定・ログ・画像」などの種別に変換してから記録します。こうすると「何を触ったか」は分かっても「どのファイルか」は残りません。

    `.claude/hooks/log_event.py` の骨格はこうです(スキル名・成否の判定は省略。7項目を組み立てて日付別ファイルに追記するまで)。

    import sys, os, json, datetime
    from pathlib import Path
    
    ROOT = Path(__file__).resolve().parents[2]   # プロジェクトルート(相対で解決)
    EXT_KIND = {".md": "文書", ".py": "スクリプト", ".js": "コード",
                ".html": "画面", ".json": "設定", ".jsonl": "ログ", ".png": "画像"}
    
    def file_kind(fp):
        if not fp:
            return None
        return EXT_KIND.get(os.path.splitext(fp)[1].lower(), "その他")
    
    def main():
        data = json.loads(sys.stdin.read() or "{}")   # フックはstdinでJSONを渡す
        ti   = data.get("tool_input") or {}
        rec = {                                        # ← 記録するのはこの7項目だけ
            "ts": datetime.datetime.now().isoformat(timespec="seconds"),
            "event": data.get("hook_event_name"),
            "tool": data.get("tool_name"),
            "role": data.get("agent_type") or "番頭",  # 役割(無ければ番頭)
            "skill": None,                             # SKILL.md読込等から判定(略)
            "ok": None,                                # PostToolUseの成否から(略)
            "file_kind": file_kind(ti.get("file_path")),
        }
        logs = ROOT / "logs"; logs.mkdir(exist_ok=True)
        day = datetime.date.today().isoformat()
        with (logs / f"events-{day}.jsonl").open("a", encoding="utf-8") as f:
            f.write(json.dumps(rec, ensure_ascii=False) + "\n")   # 1行を単一writeで追記
    
    if __name__ == "__main__":
        try:
            main()
        finally:
            sys.exit(0)   # 何があっても作業を止めない(終了コード0)

    追記先は日付別のファイル(`logs/events-YYYY-MM-DD.jsonl`)にしました。1行ずつ単一の書き込みで追記すると、複数の処理が同時に動いてもログが混ざりにくくなります。実際に役職を2人並行で動かしても、当日ログはすべて妥当なJSONのまま(破損0)でした。1行あたり約137バイトと軽量です。

    設計上の注意を2つ。フックは標準ライブラリだけで書き、何が起きても終了コード0で返します(フックが失敗しても開発本体を止めないため)。また標準出力には何も出しません(フックの判定に影響させないため)。


    手順2:機密ファイルの読み取りをブロックする仕組みを作る

    なぜそうするか

    ログを最小限にしても、AI が `.env` や秘密鍵をうっかり読んでしまえば、その中身がやり取りに乗る可能性があります。記録を絞るだけでなく、そもそも読ませない入口を1枚かませることにしました。

    やること

    `PreToolUse`(ツールが実行される前)でもう1つ小さな Python を呼び、機密ファイルを読もうとする操作を検知したら終了コード2で止めて、理由だけを短く返します(パスやファイル名は出しません)。

    対象にしたのは次の3種です。

    • `.env` 系(`.env`、`.env.local` など)

    • 秘密鍵類(`.pem` / `.key` / `.p12` / `.pfx`、`id_rsa` などの鍵ファイル)

    • 個人特定語をまとめたリスト(`private/pii_words.txt`。中身は誰も読まない運用)

    # 読み取り系ツール(Read/Edit 等)で機密パスに当たったら止める
    if tool in READ_TOOLS and is_secret_path(file_path):
        sys.stderr.write("機密ファイルの読み取りはルールによりブロックしました。\n")
        return 2  # PreToolUse をブロック

    コマンド実行(Bash)については少し丁寧に判定します。「機密ファイル名」が出てくるだけで止めると、削除や一覧のような中身を読まない操作まで巻き込みます。そこで「機密ファイルへの参照」があり、かつ `cat` / `grep` / 入力リダイレクトのような読み取りを示す構文があるときだけブロックしました。

    実際に、存在するダミーの `.env` と実在するリストファイルの読み取りをどちらもブロックし、中身が記録に露出しないことを確認しました。

    当初はこの判定を単純にしていたため、「機密ファイル名+読み取りコマンド」を1コマンドに詰め込むと、削除や一覧のような中身を読まない操作まで過剰に止まっていました。そこで安全性は下げないまま、判定を次のように見直しました。

    • サブコマンドごとに判定する:`|`・`;`・`&&`・`||`・`&`・改行でコマンドを分割し、1つずつ見ます。1つのサブコマンドの中に「機密への参照」と「読み取り系コマンド」がそろったときだけ止めます。同じ行に無害な操作が混ざっても巻き込まれません(例:`rm .env; grep .env` は、削除も、`.env` を検索パターンとして扱う検索も、中身を読まないので通ります)。

    • `grep`/`rg` の検索語の位置は読み取りに数えない:検索キーワードにたまたま機密ファイル名と同じ文字列が来ても、ファイルを開く操作とは区別します。ただし機密をファイル引数として渡す場合や、`< 機密ファイル`・`-f 機密ファイル` のように読み込ませる場合は、これまでどおり止めます。

    • 判定しきれない形は止める:`$(...)`・バッククォート・プロセス置換のように中を確実に読み切れない書き方は、安全側に倒してブロックします(`X=$(cat .env)` のような形も止めます)。

    限界も正直に書いておきます。 これはシェルの解釈を完全に再現するものではなく、文字列と構文の一致で見ているだけです。たとえばファイル名を分割・変数化した書き方(`cat .en''v` や `f=.env; cat $f`)、`python -c "open('.env')..."` のようなインタプリタ経由、`grep` 以外でパターンを第1引数に取る `awk`/`sed` などは、取りこぼしたり、逆に過剰に止めたりします。完全な防御にはシェル解釈の完全な再現が必要で、軽量なフックの範囲を超えます。だから方針は一貫して「迷ったら通さない(ブロックする)」にして、取りこぼすより過剰に止まる方を選び、最後は人間が確認します。

    フックの登録(`.claude/settings.json` 全文)

    作った2つのフックを、どのイベントで呼ぶかを登録します。`PreToolUse` では「機密ブロック → ログ記録」の順に2つ呼びます。ほかのイベントはログ記録だけです。

    {
      "hooks": {
        "SessionStart": [
          { "hooks": [ { "type": "command", "command": "python .claude/hooks/log_event.py" } ] }
        ],
        "UserPromptSubmit": [
          { "hooks": [ { "type": "command", "command": "python .claude/hooks/log_event.py" } ] }
        ],
        "PreToolUse": [
          { "hooks": [
            { "type": "command", "command": "python .claude/hooks/block_secrets.py" },
            { "type": "command", "command": "python .claude/hooks/log_event.py" }
          ] }
        ],
        "PostToolUse": [
          { "hooks": [ { "type": "command", "command": "python .claude/hooks/log_event.py" } ] }
        ],
        "SubagentStop": [
          { "hooks": [ { "type": "command", "command": "python .claude/hooks/log_event.py" } ] }
        ],
        "Stop": [
          { "hooks": [ { "type": "command", "command": "python .claude/hooks/log_event.py" } ] }
        ]
      }
    }

    登録後は、いったん Claude Code を開き直すとフックが読み込まれます。


    手順3:FastAPI + WebSocket でログを監視し「表示用イベント」に変換して配信する

    なぜそうするか

    画面に流すのは、あくまで表示に必要な形にしてからにしたいです。ログには内部の役割名(英字)やスキルのIDが入っているので、そのまま配信せず、サーバ側で「画面用の名前」「部署名」「動作名」に変換して余分を落としてから送ります。ここで削っておけば、画面側に個人を特定できる情報が届きません。

    やること

    サーバは当日ログを末尾から監視(tail)し、新しい行が増えたら表示用イベントに変換して WebSocket でブラウザへ送ります。監視間隔は約200ms(0.2秒)にしました。

    送るのは `{who, action, kind, file_kind}` の4つだけです。時刻・スキルの内部ID・パス・コマンド本文は配信に含めません。

    # 内部の役割名 → 画面用の表示名
    ROLE_DISPLAY = {"番頭": "番頭", "cto": "CTO", "cmo": "CMO",
                    "cfo": "CFO", "cso": "CSO", "qa": "検品"}
    # ツール名 → 画面に出す動作
    TOOL_ACTION = {"Edit": "打鍵", "Write": "打鍵", "Bash": "作業",
                   "Read": "調べる", "Grep": "調べる"}

    監視ループはおおよそこの形です。

    async def tail_loop():
        while True:
            # ファイルが増えた分だけ読み、表示用に変換して送る
            ...
            await asyncio.sleep(0.2)   # 約200ms間隔で監視

    実装上の細かい工夫として、終了イベントが同じ内容で複数回発火することがあったので、「役割+時刻の近さ(2秒以内)」で重複を1つにまとめました。接続時の挙動も2通り用意しています。通常モードでは接続時に当日分を最初から再生し、撮影モードでは末尾から流して過去分を再生しません(撮影を0からきれいに始めるため)。

    サーバはローカル(127.0.0.1)だけで待ち受け、LLM や外部 API は一切呼びません。イベントがログに書かれてから画面に届くまでの実測は約0.1秒(109ms)、描画を含めても1秒以内でした。外部通信が無いので、この構成での追加費用は0円で運用できました。


    手順4:Canvas でドット絵オフィスを自作する(描き方の要点)

    なぜそうするか

    既存ゲームの絵柄やキャラを持ち込むと権利の問題が出ます。そこで絵はすべてコードで自作しました。人物も机も椅子もPCも、四角を積み重ねて描くドット絵にしています。素材ファイルを使わないので、そのまま配れて、見た目も自分で好きに調整できます。

    やること

    1枚の Canvas に、部屋 → 全員の席 → 作業量パネルの順で毎フレーム描き直します。人物は「頭・胴・腕」を四角で描き、机の前板で下半身を隠して「着席している」ように見せます。ドット絵の質感を保つには、拡大時にぼやけないよう CSS で `image-rendering: pixelated` を指定するのがポイントです。

    canvas{ image-rendering:pixelated; }   /* 拡大してもドットのまま */

    描画で意識した点は次の3つです。

    • 拡大率をひとつの係数にまとめる:`w = v => Math.round(v*scale)` のように全部の座標を同じ倍率で丸めると、縦長・横長やサイズ変更でも崩れにくくなります。

    • イベントが無い間も動かす:アイドル中でも「呼吸(上下の微動)」と「まばたき」を入れて、止まって見えないようにしました。

    • いま働いた人を強調する:直近に動いた席だけ足元にリングを出し、明るさを少し上げて、誰が動いたか一目で分かるようにしました。

    // 直近に動いた席だけ足元リングを描く(明るさも少し変える)
    const active = (now - s.lastActive) < ACTIVE_MS;
    if(active){ /* 足元に楕円のリングを描画 */ }
    g.globalAlpha = active ? 1 : 0.88;

    配置は、社長・番頭・役員5人(CTO/CMO/CFO/CSO/検品)・部下8部署が同じ床に着席する形にしました。横長と縦長(9:16)を切り替えられるようにし、縦長でも全員が収まるよう段組みを変えています。


    手順5:匿名運用・撮影モードの考え方(何を画面に出さないか)

    なぜそうするか

    映像を外に出す前提なら、「出さないもの」を先に決めておくのが安全です。手順1〜3で情報を絞ってきましたが、最後にもう一度、画面に個人を特定できるものが残っていないかを機械的に確かめる仕組みを足しました。

    やること

    出さないものを、はっきり決めます。

    • ファイル名・パス・OSのユーザー名・ホームディレクトリ名

    • 時刻や日付、スキルの内部ID

    • アカウント名・メール・リポジトリ名などの識別子

    そのうえで二重の保険を入れました。1つ目は、ログを書き出す直前に、記録する文字列を特定語リストと大文字・小文字を区別せず照合し、一致したら伏字に置き換える処理です(語そのものは読み書きしません)。

    def mask(value, words):
        low = value.lower()                 # 大小文字を区別せず照合
        if any(w in low for w in words):
            return "[マスク]"
        return value

    2つ目は撮影モードに入る前の自動再チェックです。撮影モードを起動する瞬間に、当日ログをチェックするスクリプトを走らせ、合否を画面に短く表示してから撮影に入ります。

    撮影モードでは、タイトルやボタンなどのUIを隠し、文字を大きくして全画面にフィットさせます。画面内にURL・タブ名・時刻を出しません。実際に、撮影モードで描かれた文字(40件超)を、時刻・日付・パス・内部IDなどの禁止パターンで照合し、該当0件を確認しました。撮影対象はこの可視化画面だけにして、ターミナルやエディタは映さない前提で運用します。


    (応用)広報部ダッシュボード:発信の導線と数字を1画面にまとめる

    なぜそうするか

    作った映像を発信し始めると、今度は「どのSNSに出したか」「反応の数字はどうか」を毎回あちこちに見に行くことになります。これも1画面にまとめたくなりますが、原則は手順5までと同じで、画面にはURLやアカウント名を出さないようにします。リンクや数字を扱うときも、個人を特定できる情報は表に出さない、という続きの設計です。

    やること

    手順3のサーバに、発信用の画面(`/dashboard`)と小さな窓口をいくつか足します。いちばんのポイントは、SNSのURLそのものをブラウザ側に一度も渡さないことです。

    • リンクは名前だけ表示し、URLはサーバ側に隠す:SNSのURLは、gitに含めないローカルのファイル(例:`private/sns_links.json`)に人間だけが記入します。画面に出すのは「X」「Threads」「note」「はてな」などのラベルとボタンだけです。ボタンを押すと、サーバ側の窓口(例:`/open/<サービス名>`)がリダイレクトで目的のSNSを開きます。URLは画面にも配信データにも現れません。

    • 登録済みのサービスしか開かない:窓口は、あらかじめ用意したキー(サービス名)以外を受け取ったら開かず、無いものとして扱います(存在しないキーは404)。値が `https://` で始まらなければ「未設定」と表示し、外部へは飛ばしません。

    • KPIはローカルのCSVを読んで一覧にする:表示数・保存数などの数字は、手元のCSV(例:`business/kpi.csv`)に人間が記入し、画面はそれを読み取って投稿ごとの最新値を並べるだけにします。取得できない数字は0にせず「-」のままにします。ここでも外部APIは呼びません。

    • この画面の操作はログに残さない:発信用ダッシュボードの操作は、手順1の作業ログ(`logs/`)には記録しません。映像素材のログと、発信の管理を混ぜないためです(可視化サーバはそもそも作業ログに書き込まない作りにしておくと、構造的にこれを満たせます)。

    見た目は手順4のドット絵に合わせ、部署のキャラが並ぶ形にしました。掲示板には「今いくつのSNSに出しているか」を紙の枚数(サービス名やURLは出さず枚数だけ)で示し、画面の上には「本日の記録件数」を数字だけ小さく出しています。ここでも画面に出るのは、ラベル・数字・キャラだけです。

    なお、SNSのリンク先を書いたファイルの中身は、番頭(メインのAI)も読まない運用にしています(個人特定語のリストと同じ扱い)。人間だけが記入し、AIはキーの構造だけを触ります。あとからサービスを増やすときも、設定ファイルにキーを足すだけで済むようにしておくと楽です。


    まとめ

    • 記録は7項目だけのホワイトリストにして、ファイルは「種別」に変換する。

    • 機密ファイルは入口でブロックし、理由だけ返す。

    • ログはサーバ側で表示用に絞ってから配信する(実測 約0.1秒/109ms、追加費用0円)。

    • 絵はコードで自作し、いま働いた人を強調する。

    • 「出さないもの」を先に決め、撮影前に自動で再チェックする。

    • (応用)発信の導線とKPIも、URLやアカウント名を画面に出さずに1画面へまとめられる。

    ここまでの手順だけで、ドット絵オフィスの映像素材は作れます(無料部分だけで完結します)。

    ※この記事の最新版はZennにあります。今後の更新はZennにまとめています。→ https://zenn.dev/pico_shacho/articles/faa01e4a7b4dc5

    この記事が参加している募集

    あなたへのおすすめ