Claude Codeで、AIに直させる社内ツールを作るときの設計の考え方を解説します。変更の記録と戻し方、裏で動くAIの権限のしぼり方、データの置き場所、試験の用意まで、実際につまずいた点とあわせて経営者向けに整理します。
Claude Code(Anthropic社のAIコーディングツール)を使って、プログラミングの専門家でなくても、自社の仕事に合わせた道具を作れるようになってきました。ただ、「動く物ができた」ことと「毎日安心して使える」ことは別です。特に、AIが自分で資料を書き換える道具では、何が変わったかが見えない、元に戻せない、AIが余計なことをする、といった問題が起きやすくなります。
この記事では、弊社がClaude Codeで作った社内で使うデザインツールを例に、AIに作業させる社内ツールを作るときの設計の考え方と、実際につまずいた点を、経営者・担当者向けにやさしく整理します。機能の紹介よりも、「中の仕組みを、なぜそうしたか」と「どこで苦労したか」を中心に書きます。内容は2026年11月時点のものです。
AIに直させる社内ツールとは
ここで扱うのは、人が一から描く道具ではなく、AIが作った物を「残す・見比べる・直させる」ための道具です。弊社では、ホームページやLP(広告などから訪れた人に見せる1枚もののページ)の制作資料を、今はこのツールで作っています。
役割の分け方はシンプルです。作る・直すのはAI、人は見て指示を出し、だめなら元に戻します。たとえば、デザインの上にコメントを置いて「見出しを大きく」と書くと、AIがそのコメントを受けて直します。ほかにも、3案を並べて選ぶ、何か所かのコメントをまとめて1回で頼む、変更の記録から戻す、名前を付けて残した版と今の版を左右に並べる、人が自分で文字や位置を直す、画像やバナーを作る、といったことができます。
一般的なデザインツールは、人が自分の手で描くことを中心に作られています。「AIに直させて、人が選ぶ」という自社の使い方にぴったり合う道具が見つからないときは、自社で作るのも1つの方法です。
いきなり作らず、設計書と見本から始める
AIに作らせる場合ほど、作り始める前の準備が出来を左右します。弊社では、最初に設計書で「何ができるか(仕様)」と「守る決まり」を決めました。
- 設計書を何度も見直し、見つかった抜けに重さ(高・中)を付ける
- 抜けごとに「どう防ぐか」を書いてから作り始める
- 画面は、先に見本を作って確かめてから作り込む
- 作るのはClaude Code、確かめるのは自動の試験に任せる
あとで紹介する「戻すと人の直しまで消える」「裏のAIが了承の記録まで作れてしまう」といった危ない抜けは、どちらもこの設計書の見直しで見つかりました。弊社では、コードを書く速さより、抜けに先に気づけるかどうかで出来が決まると感じています。
仕組み1:外部のパッケージを入れず、手元で動かす
このツールの本体は、Node.js(Webページで使われるプログラムの言語JavaScriptを、パソコンやサーバーで動かす仕組み)だけで動きます。サーバー(画面からの依頼を受けて処理する裏側のプログラム)と画面には、外部のパッケージ(他の人が作って公開しているプログラムの部品)を入れていません。部品を入れるほど、更新の手間と、部品の中に悪い物が入り込む心配が増えるためです。
プログラムはTypeScript(JavaScriptに「型」の決まりを足した言語)で書き、変換の手順を挟まずにそのまま動かしています。Node.jsの公式資料によると、v22.18.0・v23.6.0以降は、型の部分を取り除いてTypeScriptのファイルをそのまま実行する機能が標準で有効です。サーバーと画面のTypeScriptは、今は約10,900行です。画面のファイルは、サーバーが変更を見つけて読み直すので、直したらすぐ画面で確かめられます。
サーバーはこのMacの中だけで動かし、外から入る口は作っていません。画面からの操作も送り元を確かめ、ほかのページからの操作は断ります。ただし、お客様にデザインを見てもらうための確認のページだけは、パスワード付きでCloudflare(Webサイトの配信や保護を行うサービス)に出す機能があります。出すのは、人が確かめて押したときだけです。AIの作業の進み具合は、SSE(サーバー送信イベント。サーバーから画面へ新しい情報を送り続ける仕組み)で、すぐ画面に表示します。
仕組み2:変更は「操作」として記録し、すぐ戻せるようにする
弊社が作ってみて大事だと分かったのは、「何が変わったかが見えること」と「すぐ戻せること」です。このツールでは、資料への変更をすべて「操作」として、改訂番号つきで記録します。操作は、どこを、どう変えたかをJSON(データを決まった形で書くための書式)で書いたものです。
変更を送るときは、読んだ時点の改訂番号を一緒に送ります。その間に別の変更が入って番号が食い違えば、その変更を断ります。この仕組みで、AIの直しと人の直しがぶつかって、片方が消えることを防いでいます。操作を当てはめる処理はサーバーと画面で同じものを使い、人が編集している途中の下書きも同じ決まりで扱います。
苦労したのは「戻す」機能です。設計の見直しで、AIの作業を戻すと、その後のほかの直し(人の直しを含む)まで消えてしまう抜けが見つかりました。今は、戻したい作業の変更だけを打ち消し、後の変更と重なるときは止めて知らせます。
人が保存前の直しを持っているときにAIの変更が届いた場合は、次の3つから選べます。
- 今の内容に自分の直しを当てはめて保存する
- 自分の直しを捨てる
- やめて、自分の直しを下書きのまま残す
仕組み3:裏で動くAIには、道具をほとんど持たせない
コメントを受けて直すAIは、Claude Codeを画面なしで裏で起動して動かしています。Claude Codeには、画面を開かずに指示を渡して実行する使い方(公式資料では claude -p による非対話の実行。人が途中で答えなくても、最後まで自動で進める実行のしかた)があります。
このAIには、シェル(コマンドを実行する仕組み)・ファイルの読み書き・Webの閲覧といった道具は持たせていません。使えるのは、自作のMCPサーバーの道具だけです。MCP(Model Context Protocol)は、AIと外部の道具やデータをつなぐための共通の決まりです。道具は、資料の要素の一覧を読む get_outline、詳しく読む get_nodes、まとめて直す apply_ops など、資料の操作に限っています。
設計の見直しでは、「裏のAIが、人がするはずの了承の記録まで作れてしまう」という抜けも見つかりました。そこで今は、次のように動ける範囲をしぼっています。
しぼっていること | 内容 |
|---|---|
触れる資料 | 実行ごとに1つの資料だけ |
使える操作 | 限られた操作だけ。期限付きの合言葉を実行ごとに渡す(合言葉の期限は30分) |
資料の中の文字 | 実行ごとに名前の変わる区切りの中に入れ、命令として読ませない |
時間と回数 | 1回の実行は15分まで、修正の送信は30回まで |
資料の中に「これまでの指示を無視して」のような文が紛れ込んでいても、AIがそれを命令として受け取らないようにするための工夫です。こうした攻撃はプロンプトインジェクションと呼ばれます。
地味に困ったのは、AIが道具の接続を待たずに、道具なしで答えてしまうことでした。接続を待ってから始める設定にして直しています。
Q. 社内ツールでも、AIの権限をしぼる必要はありますか?
あります。社内だけで使う道具でも、資料の中の文字や外から取り込んだデータに、AIへの指示に見える文が含まれることがあります。AIに渡す道具と範囲を最初から小さくしておけば、思わぬ書き換えや情報の持ち出しを防ぎやすくなります。
仕組み4:データの置き場所と、止まったときの備え
資料はJSONのファイルにして、Googleドライブに置いています。書き込むときは、別のファイルに書いてから差し替えるので、途中で止まってもファイルが壊れません。
いちばん苦労したのはここです。ドライブのアプリが詰まって中身を取り寄せられなくなり、ツール全体が止まって、画面が真っ白のままになったことがありました。今は次のようにしています。
- パソコンの中に写しを持ち、ふだんは写しから読む
- ドライブが止まったときは、パソコンの中に書きためておく
- ドライブが戻ったら、「アップしますか?」と聞いてから送る
クラウドの保存場所は便利ですが、止まることもあります。止まったときにどう動くかまで決めておくと、毎日使う道具として安心です。
仕組み5:試験を先に用意し、毎回すべて流す
AIに書かせる量が増えるほど、試験(作った物が正しく動くかを自動で確かめる仕組み)が大事になります。このツールの試験は今36種類あり、そのうち27種類は本物のChrome(Googleのブラウザ)で画面を動かして確かめます。機能を足すたびに全部を流し、試験用のサーバーは試験ごとに別の番号で立ち上げて、本番のデータには触れません。
それでも事故はありました。
- 一時フォルダに置いていた試験の道具が、Macの自動の片付けで消えた(ツールのフォルダに移して解決)
- 説明のコメントの後ろに処理を書いてしまい、その処理が動いていなかったことが何度かあった(見つける点検を追加)
- AIがすぐ失敗したときに、画面が「順番待ち」のまま止まる不具合があった(直した)
どれも、今は同じことが起きないように直しています。人が画面を見ているだけでは気づきにくい不具合もあるので、試験を育てていくことが大切です。
Q. 試験はAIに書かせてもよいですか?
書かせてかまいません。ただし、何を確かめるかは設計書で人が決め、試験が本当に失敗を見つけられるかも確かめます。試験が通っても、その試験が何も確かめていなければ意味がないためです。
文字の読み取りと画像づくりは、得意な道具に任せる
バナーを文字・ボタン・背景の層に分けるために、macOSのVision(Appleが提供する、画像の中の文字を読み取る機能など)を使い、文字の位置を読んでいます。Swift(Appleの機器向けのプログラミング言語)で小さな道具を書き、ツールから呼び出しています。バナーは、載せる媒体を選ぶと、その媒体でよく使う大きさが出ます。
画像の生成は、OpenAI社のAIの道具であるCodexを裏で呼び出しています。ここでもつまずきがありました。入力を受け付ける口を開けたまま起動すると、Codexが入力を待ち続け、画像を作らずに止まったことがあります。また、入口と本体の2つのプログラムが動くので、止めるときは片方だけ残らないよう、2つをまとめて止めるようにしています。全部を自作せず、得意な道具を組み合わせるときは、「止まったときにどう終わらせるか」まで決めておくのが大切です。
作ってみて分かった、AIで社内ツールを作るときのポイント
作って分かったことを、AIで社内ツールを作りたい方向けに3つにまとめます。
- AIに直させるなら、直す力より「何が変わったかが見えること」と「すぐ戻せること」が大事だった
- AIに書かせるほど、設計書と試験が大事になる。出来は、抜けに先に気づけるかで決まると感じている
- 自分で毎日使う道具なら、使っていて引っかかった所をすぐ直していける。直すたびに試験を全部流してから入れる
今後、複数人で使う場合は、Cloudflare Tunnel(外から入る口を開けずに、手元のサービスをCloudflare経由で使えるようにする仕組み)とCloudflare Access(決まった人だけが入れるようにする仕組み)を使い、Googleアカウントでログインした決まった人だけが入れる形にすることを検討しています。2026年11月時点では、ツールの画面はこのMacの中だけで使っています。
よくある質問
プログラミングができなくても、Claude Codeで社内ツールは作れますか?
作れる場合があります。ただし、作る前に「何ができるか」「守る決まり」「失敗したときの戻し方」を文章で決めておくことが前提です。AIは指示のとおりに作るので、決まりがあいまいだと、抜けもそのまま作られやすくなります。
社内ツールのデータは、どこに置くのがよいですか?
社内の決まりに合わせて選びます。クラウドの保存場所を使う場合は、つながらないときの動き(手元に写しを持つ、あとで送る)まで決めておくと安心です。
作った社内ツールを、社外から使えるようにしてもよいですか?
入れる人を限る仕組み(ログインやパスワードの確認)を用意してからにします。手元だけで動かす前提で作ったツールを、そのままインターネットに公開するのは危険です。お客様に見せる部分だけを出す場合も、出す範囲と入れる人を決めておきます。
まとめ
- AIに直させる社内ツールは、「作るのはAI、見て指示して戻すのは人」という役割分担で考える
- 作る前に設計書と見本を作り、抜けに重さを付けて防ぎ方を決める
- 変更は記録し、ぶつからず、すぐ戻せるようにする。保存前の直しの扱いも選べるようにする
- 裏で動くAIには、必要な道具と範囲・時間・回数だけを渡す
- データの置き場所は、止まったときの動きまで決める
- 試験を先に用意し、機能を足すたびにすべて流す
