「毎週同じ表を別のシートに転記している」「申請の内容をまとめて定型の文書にしている」。部署の中には、システムを入れるほどではないけれど手間がかかっている作業がいくつもあります。こうした作業は、小さなツールを1つ作るだけで楽になることがあります。
Codex を使うと、プログラミングの経験が少ない担当者でもこうした小さなツールを試作できます。ただし、作れることと使い続けられることは別です。要件があいまいなまま作り始めると、動くけれど誰も直せないツールが残ります。この記事では、社内の小さな業務ツールを Codex で作るときの手順を「選ぶ」「要件を書く」「計画させる」「段階ごとに作る」「引き継ぐ」の順に整理します。製品の動きに関わる内容は、2026年11月6日に OpenAI の公式ドキュメント(Best practices・Prompting・Agent approvals & security・Security)で確かめた範囲に絞りました。
表データの整形そのものを任せる手順は表データの整形と集計の記事で紹介しています。この記事は、同じ作業を毎回頼むのではなく「ツールとして残す」場合の進め方です。
結論: 小さく選び要件を1枚にしてから作らせる
先に要点をまとめます。
- 作る対象は「入力と出力がはっきりしていて止まっても手作業に戻せる」作業に絞る
- 作り始める前に要件を1枚にまとめ「何ができたら完成か」を書く
- いきなり作らせず計画を先に出させ、人が確認してから作らせる
- 一度に全部を作らせず、段階ごとに動かして確かめる
- 使い方・確かめ方・直し方をフォルダに残し、担当者が替わっても直せるようにする
ポイントは、Codex に任せる部分と人が決める部分を分けることです。コードを書くのは Codex に任せられますが、何を作るか・どうなったら完成か・社内で使ってよいかは人が決めます。
作る対象の選び方
最初の題材選びで、その後の進めやすさがほぼ決まります。次の表で、試作に向いているものと向いていないものを見分けてください。
| 見るところ | 試作に向いている | 試作に向いていない |
|---|---|---|
| 使う人 | 担当者本人か1つの部署 | 社外の顧客や取引先 |
| 入力と出力 | 「この CSV からこの形式の文書を作る」とはっきりしている | 状況によって判断が変わる |
| 止まったとき | 手作業に戻せば業務は続く | 業務が止まる・損失が出る |
| 扱うデータ | 見本のデータで試せる | 個人情報をまとめて扱う |
| ほかのシステム | 読み取るだけ・つながない | 基幹システムに書き込む |
向いている題材の例としては、次のようなものがあります。
- 複数の CSV を1つの表にまとめて決まった列の順に並べ替える
- 申請の一覧から部署ごとの集計表と定型の報告文を作る
- フォルダ内のファイル名を社内の命名ルールにそろえる前に、変更の一覧を出す
- 入力欄に値を入れると定型の案内文ができる、手元で開くだけの画面
右側に当てはまるものは、試作ではなく情報システム部門と通常の開発の手順で進めてください。どの部署から始めるかの考え方は試験導入する部署と人の選び方の記事にまとめています。
手順1: 作業用フォルダを Git で管理する
ツールを作る場所として、専用のフォルダを1つ用意します。このフォルダは Git でバージョン管理しておくことをおすすめします。
公式ドキュメントでは、バージョン管理されているフォルダでは作業フォルダへの書き込みと必要に応じた承認を組み合わせた設定(Auto)、バージョン管理されていないフォルダでは読み取りのみの設定が案内されています。(出典: Security)また、ローカルで使う場合の既定ではネットワーク接続がオフで、書き込みは作業中のフォルダに限られると説明されています。(出典: Agent approvals & security)
Git で管理しておけば、Codex が加えた変更を1つずつ確かめ、うまくいかなかったときに前の状態へ戻せます。慣れないうちは承認とサンドボックスの設定を厳しめにしておき、信頼できる作業に限って緩めることも公式ドキュメントで勧められています。(出典: Best practices)設定の考え方はサンドボックスと承認ポリシーの記事で詳しく説明しています。
あわせて、試作の段階では本物のデータを置かず、項目だけそろえた見本のデータを用意します。API の鍵やパスワードが必要になりそうな場合は、鍵と環境変数の扱いの記事を先に読んでください。
手順2: 要件を1枚にまとめる
次に、作るものの要件を文書にします。長い仕様書は要りません。次の項目を1枚に書けば十分です。
| 項目 | 書くこと | 例 |
|---|---|---|
| 目的 | 何の作業を楽にするか | 毎週の申請一覧から部署別の集計表を作る |
| 使う人 | 誰がどこで使うか | 総務の担当者が自分のパソコンで週1回 |
| 入力 | 何を渡すか | 申請システムから書き出した CSV |
| 出力 | 何ができればよいか | 部署別の件数を並べた CSV と報告文のテキスト |
| やらないこと | 範囲の外に置くもの | 申請システムへの書き込み・メールの送信 |
| 完成の条件 | どうなったら完成か | 見本データ3種類で件数が手計算と一致する |
公式ドキュメントでは、指示に含めるとよい要素として「目的(Goal)」「関係する資料(Context)」「守るべき制約(Constraints)」「完了の条件(Done when)」が挙げられています。(出典: Best practices)上の表はこの4つを業務ツール向けに言い換えたものです。特に「やらないこと」と「完成の条件」は省きがちですが、ここがないと Codex がどこまで作ればよいかを判断できません。
要件書は 要件.md のような名前で作業用フォルダに置いておきます。後の手順で毎回読ませるためです。
手順3: いきなり作らせず計画を出させる
要件書ができたら、すぐに作らせず計画を出させます。公式ドキュメントでは、作業が複雑なときやあいまいなときは、実装の前に計画を立てさせることが勧められています。計画モード(/plan または Shift+Tab で切り替え)では、Codex が情報を集めて確認の質問をしながら計画を組み立てます。(出典: Best practices)
目的: このフォルダの「要件.md」に書いたツールを作りたい。
まだコードは書かないで、作り方の計画だけを出してほしい。
見てほしいもの:
- 要件.md
- 見本データのフォルダにある CSV
出してほしいもの:
- 作る順番を3〜5段階に分けた計画
- 段階ごとに「何ができるようになるか」と「どう確かめるか」
- 使う言語やライブラリと、それを選んだ理由
- 要件.md だけでは決められないことを質問として一覧にする
計画が出てきたら、担当者が読んで質問に答えます。「部署名が空欄の行はどう扱うか」「同じ週に2回書き出したときはどうするか」といった質問には、業務の判断が入ります。答えた内容は要件書に書き足しておきます。
使う言語やライブラリは、社内で後から直せる人がいるものを選ぶよう伝えるのも大切です。社内のパソコンに追加で入れる必要があるものが含まれていれば、情報システム部門に確認してから進めます。
手順4: 段階ごとに作らせて確かめる
計画が固まったら、1段階ずつ作らせます。公式ドキュメントでは、複雑な作業は小さく焦点を絞った段階に分けたほうがよく、小さな作業のほうが Codex にとっても確かめやすく人にとっても見直しやすいと説明されています。また、Codex は自分の作業を確かめられるときに質の高い結果を出すとされています。(出典: Prompting)
目的: 計画の第1段階「CSV を読み込んで部署別の件数を数える」を作る。
制約:
- 要件.md の「やらないこと」に書いたことはしない
- 見本データのフォルダのファイルは書き換えない
- 出力は「出力」フォルダに書く
完了の条件:
- 見本データ3種類それぞれで部署別の件数を出す
- 件数の合計が CSV の行数と一致することを確かめる
- 動かし方を README.md に書く
- 使ったコマンドと結果を最後にまとめる
1段階が終わるたびに、担当者が次のことを確かめます。
- README.md に書かれた手順どおりに、自分で動かせるか
- 出力を見本データと見比べて、件数や内容が合っているか
- 想定と違う入力(空の CSV・列が足りない CSV)を渡したときに、黙って誤った結果を出さず止まるか
- Git の差分を見て、頼んでいないファイルが変わっていないか
合わない点があれば、その段階のうちに直させます。次の段階に進んでからでは、どこで間違えたかをたどりにくくなるためです。既存のコードにテストを足す考え方は既存システムにテストを足す記事が参考になります。
手順5: 使い続けるための引き継ぎを残す
ツールが完成したら、使い続けるための情報をフォルダに残します。ここを省くと、作った人が異動したときに誰も直せなくなります。
| 残すもの | 書くこと |
|---|---|
| 要件.md | 目的・入力・出力・やらないこと・完成の条件と、途中で決めた判断 |
| README.md | 動かし方・必要な準備・よくあるエラーと対処 |
| AGENTS.md | Codex に直させるときの決まり(確かめ方・触ってはいけないファイル) |
| 見本データ | 確かめるときに使う CSV と、その正しい出力 |
公式ドキュメントでは、AGENTS.md はリポジトリでの作業のしかたを Codex に伝える場所とされ、ビルドやテストのコマンド・決まりごと・してはいけないこと・何をもって完了とするかと確かめ方を書いておくことが勧められています。/init コマンドで最初のひな形を作ることもでき、内容は短く保ち、同じ間違いが繰り返されたときにルールを足していく進め方が案内されています。(出典: Best practices)書き方はAGENTS.md の書き方の記事で詳しく紹介しています。
この4つがそろっていれば、修正を頼むときも「AGENTS.md と要件.md を読んでから、部署名の並び順を五十音順に変えて」のように短く頼めます。
部署で始めるときに決めておくこと
担当者が自分で作ったツールは、便利なぶん社内のどこで何が動いているか見えにくくなります。部署で始める前に、次のことを決めておくと安心です。
- 作ってよい範囲: 作る対象の選び方の表の右側に当たるものは作らない
- 人に見てもらう時点: 部署内で配る前に情報システム部門かエンジニアに一度見てもらう
- 置き場所: 作ったツールのフォルダを部署の共有の場所にまとめ、作った人と用途を一覧にする
- やめるとき: 使わなくなったツールはフォルダごと片付け、一覧から消す
これらは社内の利用ガイドラインに入れておくと周知しやすくなります。項目の例は社内利用ガイドラインの作り方の記事にまとめています。GitHub で管理する場合のレビューの進め方はGitHub の PR でのコードレビューの記事が参考になります。
まとめ
Codex で社内の小さな業務ツールを作るときは、入力と出力がはっきりしていて止まっても手作業に戻せる作業を選び、要件を1枚にまとめて完成の条件を決めます。そのうえで計画を先に出させて人が確認し、1段階ずつ作らせて動かしながら確かめます。完成したら要件書・README.md・AGENTS.md・見本データを残し、担当者が替わっても同じ基準で直せるようにしておきます。
この記事の内容は、2026年11月6日時点の OpenAI 公式ドキュメントの記載に基づいています。機能の名前や設定の内容は変わることがあるため、使う前に最新の記載をご確認ください。デジライズでは、部署ごとの業務に合わせた Codex の使い方の設計から、社内ルールの整備・非エンジニア向けの研修までを含めた Codex の法人導入支援のご相談を承っています。「まず1つの部署で小さなツールを試作してみたい」という段階からでもお問い合わせください。
- https://developers.openai.com/codex/learn/best-practices
- https://developers.openai.com/codex/prompting
- https://developers.openai.com/codex/agent-approvals-security
- https://developers.openai.com/codex/security
確認日:2026年11月6日。提供条件・機能・料金は変更されるため、最新情報は各公式ページをご確認ください。
デジライズの実績はデジライズ全体の社内集計値です。Codex の機能・対応環境・料金・提供条件は記事の公開・更新時点の OpenAI 公式情報に基づき、変更される場合があります。導入効果は企業や業務によって異なります。



