こんにちは。趣味若づくりオヤジ池田です。
北九州で、AIを使ったアプリ開発や業務効率化のお手伝い、それと営業をやっています。
Claude Codeには、自分がAIをどう使っているか振り返って「ここ、改善できますよ」と教えてくれる機能があります。/insightsというコマンドを打つだけで実行できるので、気になる方はぜひ自分でも試してみてください。今回はこれを実行してみたら、いくつか提案が出てきたので、順番に対応してみました。今日はその作業の記録です。
そもそも何をしたのか
僕は普段、Claude CodeとCodexという2つのAIツールを使い分けています。それぞれに「こう動いてね」という指示書のようなファイルがあって、Claude Code側はCLAUDE.md、Codex側はAGENTS.mdという名前です。これが長く使ってるうちに、片方にしか書いてないルールが出てきて、ズレ始めていました。放っておくと事故のもとなので、まとめて整理することにしました。
やったこと
大きく分けて3つです。
1. 2つの指示書を揃えた
CLAUDE.mdとAGENTS.md、両方の中身を見比べて、同じ内容になるように揃えました。ツール名など、意図的に変えている数か所以外は完全に一致させています。
2. 「相談モード」と「実行モード」を切り替えるコマンドを作った
AIに何か頼むとき、「まだ案を聞きたいだけ」の時と、「もう決めたから最後までやってほしい」時があります。この2つを毎回言葉で説明するのが面倒だったので、コマンド1つで切り替えられるようにしました。相談モードの時は、AIはファイルを作ったり実行したりせず、案を出すだけに専念します。
3. 危険な操作を自動で止める見張り役を作った
うっかりデスクトップの中身を消してしまったり、関係ないフォルダにファイルを作ってしまったり、AIに強めの操作を頼むとまれに事故が起きます。それを未然に止める仕組み（専門用語でいう「Hook」）を作りました。
ここでいくつかつまずきました。最初に使おうとしたツールがこのパソコンには入っていなかったり、書き方の作法が合ってなくて気づかないうちに動いていなかったり。原因を1つずつ確認して、別の方法に書き直しました。
一番面白かった失敗
ひと通りテストが通ったあと、念のため実際に動かして本当に止まるか確認しようとしたら、自分が確認用に打ったコマンドそのものが止められました。
理由は単純で、確認用のコマンドの中に「デスクトップに新しいフォルダを作る」という文言が、たまたまそのまま含まれていたからです。この見張り役は、中身が本当に危険かどうかを深く判断せず、危ないパターンの言葉が含まれているだけでまず止める、という安全寄りの作りにしていました。なので、これは狙い通りの反応です。確認用のコマンドを少し書き換えて、無事に動作を確認できました。
ついでに見つかったこと
作業中に2つ、気になる点が見つかりました。
- パスワードのようなキーが、設定ファイルにそのまま丸見えの状態で入っていた。今回はここまで手を広げず、直した方がいいという課題だけメモしておきました
- 使えるはずのツールが1つ、実際には反応していなかった。ただ別の方法で同じことができていたので、実害はなし
気づくと全部その場で直したくなるんですが、今回はやる範囲を決めて、範囲外のことは「気づいたこと」として記録するだけにとどめました。
まとめ
- 複数のAIツールを使い分けるなら、指示書の中身がズレていないか、たまに見直した方がいい
- 「相談だけ」なのか「最後までやってほしい」なのかを毎回説明するのは、コマンドで切り替えると楽になる
- 安全の仕組みは、多少過剰に反応するくらい厳しめに作っておく方が安心（今回は僕自身が引っかかりました）
- 作業中に見つかった別の課題は、その場で全部直そうとせず、いったん記録して後で判断するのも1つのやり方