Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【ITニュース解説】Wrapping Claude Code and Codex in Electron: A Stop Bug

2026年10月29日に「Dev.to」が公開したITニュース「Wrapping Claude Code and Codex in Electron: A Stop Bug」について初心者にもわかりやすく解説しています。

作成日: 更新日:

ITニュース概要

開発中のRefmadeアプリで、AIタスク停止後もバックグラウンドプロセスが残り、ファイル削除バグが発生した。`nohup`プロセスが原因で、環境変数やプロセス情報から孤立プロセスを特定し修正した。RefmadeはAI操作要求をカード表示し、安全な利用を支援する。

ITニュース解説

Refmadeは、コマンドライン操作に不慣れなユーザーでもAIエージェントであるClaude CodeやCodexを簡単に利用できるよう開発されたデスクトップアプリケーションだ。このアプリは、ユーザーがすでにPCにインストールしているAIエージェントのプログラムを、視覚的に分かりやすいオフィスのような画面で操作できるようにする。AnthropicやOpenAIといったAI開発企業とは提携しておらず、独自に開発が進められている独立したソフトウェアである。開発の大部分のコードはAIエージェント自身が書き、人間が計画、決定、レビューを行っている点が特徴的だ。

RefmadeはAIエージェントの機能を直接呼び出すのではなく、「ラッパー」と呼ばれる方法でAIエージェントと連携する。具体的には、AIモデルのAPI(アプリケーションプログラミングインターフェース)をアプリ自身が利用するのではなく、ユーザーが個別にインストールしたコマンドライン版のAIエージェント(claude -pやcodex app-server)をRefmadeが起動する。これにより、アプリがユーザーのAPIキーや利用料金を管理する必要がなく、ユーザー自身の設定や契約に基づいてAIを利用できる。

この連携の鍵となるのは、AIエージェントのコマンドラインツールが「機械が読み取りやすい形式」と「ユーザーに許可を求めるための仕組み」を持っていることだ。Claude Codeの場合、Refmadeはclaude -pというコマンドを起動し、そのプログラムの標準入出力(stdin/stdout)を通してJSON形式のデータをやり取りする。JSONは、人間にとっても機械にとっても分かりやすい構造でデータを記述する形式である。AIエージェントが例えば「ツールを使いたい」という要求を出すと、それはJSONデータとしてRefmadeに送られる。Refmadeはそれを受け取ると、ユーザーに許可を求めるためのカードを画面に表示し、ユーザーの選択(許可・不許可)をJSON形式でAIエージェントに返す仕組みだ。Codexの場合は、JSON-RPCという、JSON形式を使って遠隔のプログラムの機能を呼び出す仕組みで通信が行われる。

Refmadeでは、AIエージェントがファイル作成やコマンド実行など、システムに変更を加える可能性のある操作を行おうとすると、それをユーザーに分かりやすい形で「許可カード」として表示する。これは、例えば「rm -rf」(ファイルを強制的に削除するコマンド)といった専門的なコマンドラインをそのまま見せても、初心者には理解が難しいからだ。許可カードには、「新しいファイルを作成してもよいですか?」といった平易なタイトルと説明文、変更される場所、そしてどのような変更が起こるかを示す短いメッセージが表示される。Refmadeはコマンドラインを独自に解析し、その意味を説明する。AI自身による説明も併せて表示されるため、AIの言葉だけで操作内容が曖昧になることを防ぐ。この仕組みは、AIエージェントの要求を「人間が理解できる言葉」に翻訳し、ユーザーが安全に作業を進められるようにするための重要な機能だ。ただし、このシステムはAIの要求を解釈して表示するものであり、完全なサンドボックス(外部から隔離された安全な実行環境)ではないため、解釈が誤る可能性もゼロではない。

開発中に発見された重大なバグの一つに「Stopバグ」がある。これは、Refmadeアプリでタスクの「Stop」ボタンを押しても、AIエージェントが開始した一部のプロセスが終了せず、予期せぬファイル削除が発生するというものだった。具体的には、AIエージェントにnohup sh -c 'sleep 20; rm keep.txt' &というコマンドを実行させた際に問題が起きた。nohupというコマンドは、通常ならユーザーがログオフしたり、親となるプログラムが終了したりしても、その子プロセスがバックグラウンドで動き続けるようにする。また、最後の&は、そのコマンドをバックグラウンドで実行させることを意味する。このため、RefmadeがAIエージェントのプログラム(親プロセス)を終了させても、nohupによって切り離されたバックグラウンドの子プロセスは独立して動き続け、設定された20秒後にkeep.txtというファイルを削除してしまったのだ。

このバグの修正は、OSごとに異なるアプローチが取られた。Linuxの場合、各AIエージェントのセッションにREFMADE_TASKという環境変数(プログラムが動作する環境に設定される情報)を設定し、Stop時にはこの環境変数を持つ孤立プロセス(親プロセスが終了してしまった子プロセス)を探して終了させる。macOSでは、他のプロセスの環境変数を読み取ることが難しいため、タスクの実行中に開始され、作業ディレクトリがタスクフォルダ内にある孤立プロセスを探すという、経験則に基づいた(ヒューリスティックな)方法が採用された。ただし、この方法には、同じフォルダで開発サーバーなどを起動していると誤って終了させてしまう可能性があるという制限がある。Windows版では、この修正はまだ適用されておらず、CLI自身のプロセスツリーのみが終了する。この修正後、同様のテストではファイルが削除されずに残ることが確認された。

その他にも、アプリ起動直後にタスクを開始するとAIエージェントがGUIに表示されるまでに時間がかかる「起動順序の競合バグ」が見つかり、これも修正された。開発プロセスにおいては、コードの品質を確保するために、3ラウンドにわたる別々のAIエージェントによるレビューが実施された。これにより多くの修正が行われ、最終的には394個のテストがすべてパスする高い品質が達成されている。しかし、これらのテストはコードの正確性を保証するものであり、ユーザーにとっての使いやすさは別途ユーザビリティテストが必要であると認識されている。Refmadeは、AIエージェントと人間が安全かつ効率的に協業できるデスクトップ環境を構築することを目指し、開発が進められている。

関連コンテンツ

関連IT用語