1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

CodexやClaude Codeに作業を任せる前に。範囲を決め、秘密を渡さず、プルリクエストで受け取る【非エンジニアのGitHub入門⑦】

1
Last updated at Posted at 2026-11-14

Codex や Claude Code に実際の作業を任せる例として、予測モデルをつくるまでを Kindle の本『AIエージェントで機械学習をスキルにする』にまとめています。

前回は、GitHub Desktopを使ってリポジトリをパソコンに写し、手元で直した内容をGitHubに送りました。最後に「次回は、AIに作業を任せるときの基本を扱う」と予告しています。今回がその回です。

Codex(OpenAIが提供する、開発作業を任せられるAI)と Claude Code(Anthropicが提供する、同じ種類のAI)は、パソコンの中のファイルを読み、書き換え、命令(コマンド)を実行できます。第6回でクローンした work-notes のフォルダで動かせば、その中のファイルを相手に作業してくれます。

便利な反面、気をつけたいこともあります。第1回の佐藤さんを思い出してください。AIに「部門別の内訳も出して」と頼んだら、集計条件の行まで書き換わっていました。AIは、頼んだ範囲を超えて手を動かすことがあります。悪気があるわけではありません。頼まれたことを片付けようとして、必要だと判断した場所にも手を入れてしまうのです。

仕事にたとえると、AIの道具は、手の速い新しい同僚です。入社初日の人に、何の説明もなく全部の棚の鍵を渡す職場はないでしょう。どこまで任せるかを伝え、見せられない書類は渡さず、仕上がりは確かめてから受け取る。AIに頼むときも、決めておくことは同じです。

今回は、この3つを Codex と Claude Code に共通する考え方として整理します。道具のインストールや起動の手順は、それぞれの公式の案内に任せます12。道具ごとの設定の名前は、最後の補足にまとめました。

1つ目は、任せる範囲を決めること

範囲には、2つの意味があります。どの場所で作業させるかと、何をさせるかです。

場所は、作業フォルダに絞る

Codex も Claude Code も、起動したフォルダを作業の場所として扱います34。この連載で練習するなら、第6回でクローンした work-notes のフォルダで起動します。

ホームフォルダやデスクトップのように、いろいろなファイルが入っている場所で起動するのは避けてください。作業に関係のないファイルまで、AIの手が届く場所に並ぶことになります。1つの仕事には、1つのリポジトリのフォルダ。この組み合わせを基本にしておくと、範囲が自然に決まります。

依頼文は「お願い」、設定は「鍵」

何をさせるかは、2つの手段で決めます。

1つは依頼文です。第5回で、Issueに「何を頼み、何は変えてほしくないのか」を書きました。それをそのまま、AIへの依頼文に使えます。

README.md の最後に、「確認の手順」という段落を1つ追加してください。
ほかの行は変えないでください。
終わったら、変えた場所を一覧で教えてください。

「ほかの行は変えない」と書いておけば、佐藤さんの場面のような食い違いは起きにくくなります。ただし、依頼文はあくまでお願いです。AIは守ろうとしますが、守れなかったときに止める仕組みではありません。Claude Code の公式ドキュメントにも、指示はClaudeが何をしようとするかを形作るが、何を許可するかは変えない、という趣旨の注意があります4。

もう1つが、道具の設定です。こちらは鍵にあたります。どちらの道具にも、どこまで確認なしで進めてよいかを決める設定があり、おおまかには次の3段階に分かれます35。

  • 読むだけで、ファイルは書き換えない
  • 作業フォルダの中なら、確認なしで書き換えや命令の実行まで進める
  • 確認なしで、何でも実行する

3つ目の「何でも実行する」設定は、どちらの道具でも普段使いには勧められていません34。

気をつけたいのは、最初から選ばれている設定です。どちらの道具も、版や使い方によっては、作業フォルダの中のことを確認なしで進める設定から始まります35。使い始める前に、いまどの設定になっているかを一度確かめてください。慣れるまでは、ファイルを書き換える前に確認を求めてくる設定にしておくと、AIが何をしようとしているのかを一つずつ見られます。

お願いと鍵の関係に、このあと扱う受け取り方までつなげると、次のようになります。

確認を求められたら、読んでから答える

確認を求める設定にしておくと、AIは途中で「この命令を実行してよいですか」と聞いてきます。ここで大事なのは、読まずに許可しないことです。

命令の中身が分からなくても、手がかりはあります。第6回のコラムで、GitHub Desktop のボタンとコマンドの対応表を載せました。git commit なら記録しようとしている、git push ならGitHubに送ろうとしている、と読めます。見当がつかないものは、いったん断って「この命令は何をするものですか」とAIに聞き返せば大丈夫です。断っても、それまでの作業が壊れることはありません。

2つ目は、秘密の情報を渡さないこと

ここでいう秘密の情報は、パスワード、APIキー(外部のサービスを使うときの、合言葉のような文字列)、お客さまの個人情報、社外に出せない資料などです。これらがAIに渡ってしまう道は、主に3つあります。

依頼文に貼らない

1つ目は依頼文です。AIへの依頼文や、AIが読んだファイルの中身は、道具を提供している会社のサービスに送られて処理されます。第1回の「仕事の成果物を置いてよいのか」で、GitHubに保存することと、AI機能に情報を渡すことは別の確認事項だと書きました。ここでも考え方は同じです。業務の情報を渡してよいかは、会社のルールや取引先との契約で先に確かめてください。

作業フォルダに置かない

2つ目は、作業フォルダの中のファイルです。AIは作業フォルダのファイルを読めます。秘密の情報が書かれたファイルを作業フォルダに置かないのが、いちばん確実です。どうしても置く必要があるなら、特定のファイルを読ませない設定を使います。ただし、この設定にも抜け道があり、置かないことの代わりにはなりません。Claude Code の例と限界は、最後の補足に載せました。

GitHubに送らない

3つ目は、GitHubへの送信です。AIが作ったファイルも、自分で置いたファイルも、コミットしてプッシュすればGitHubに届きます。

これを防ぐのが、.gitignore(ギット・イグノア)というファイルです。リポジトリのいちばん上のフォルダに置き、記録の対象から外したいファイルの名前を書いておきます6。

# 記録しないファイル
.env
秘密のメモ.txt

# で始まる行は、自分用のメモです。.env(ドット・エンブ)は、パスワードやAPIキーを書いておくファイルによく使われる名前です。AIの道具が作業の途中でこの名前のファイルを作ることもあるので、最初から書いておいて損はありません。

ここで、第3回の話を思い出してください。コミットは、前の状態を消さずに残す仕組みでした。裏を返すと、一度コミットしてしまった秘密の情報は、あとでファイルを消しても履歴に残ります。.gitignore が効くのは、まだ記録していないファイルだけです6。

もし送ってしまったら、まずそのパスワードやキーそのものを使えなくしてください。サービスの設定画面で変更したり、作り直したりします。履歴から消す作業は、そのあとです。公開リポジトリなら、送った時点で誰かに見られた前提で動いたほうが安全です。

3つ目は、プルリクエストで受け取ること

AIが作業を終えたら、結果を受け取ります。使うのは、第4回から練習してきたプルリクエストです。

受け取り方は2通り

1つは、AIにはファイルを直してもらうだけにして、記録と送信は自分でする方法です。AIの作業が終わったら、GitHub Desktop を開きます。変わったファイルと差分が、第6回と同じように表示されます。中身を確かめてから、自分でコミットし、プッシュし、プルリクエストを作ります。

もう1つは、プルリクエストを作るところまでAIに頼む方法です。Codex のクラウド版(Codex Cloud)は、作業の結果をプルリクエストとして出せます7。Claude Code も、頼めばプルリクエストを作れます8。

この連載のおすすめは、慣れるまでは1つ目の方法です。記録する直前に、必ず自分の目で差分を見ることになるからです。AIに任せる範囲は、慣れてから少しずつ広げれば十分です。

どちらの方法でも、AIには main で直接作業させず、ブランチで作業してもらいます。依頼文に「新しいブランチを作って作業してください」と一言書いておけば足ります。自分で GitHub Desktop でブランチを作ってから、AIに頼んでも構いません。第4回で見たとおり、ブランチで作業している間、main は元のままです。うまくいかなければ、そのブランチを取り込まなければ済みます。

差分で確かめる4つのこと

プルリクエストの Files changed(変更されたファイル)で、次の4つを確かめます。

  • 頼んだ範囲の変更か。Issueや依頼文と見比べる
  • 頼んでいないファイルが変わっていないか。変わったファイルの数を見る
  • 秘密の情報が紛れ込んでいないか
  • 説明欄に「なぜ変えたか」が書いてあるか

第1回の佐藤さんが、集計条件の書き換えに気づいたのも、この画面でした。

最後の項目は、説明欄をAIに書いてもらった場合も同じです。AIの説明は、もっともらしく整っています。差分と食い違っていないかを、自分で読んで確かめてください。AIの「完了しました」は、作業が終わったという報告です。中身が正しいかどうかの判断は、受け取る側の仕事です。

つまずきやすいところ

確認の画面が何度も出て、面倒になることがあります。そこで「何でも実行する」設定に切り替えたくなりますが、練習のうちは我慢してください。同じ命令の確認が何度も続くなら、その命令だけを許可する方法が用意されていないか、道具の公式ドキュメントで確かめるのが近道です。

AIが、頼んでいないファイルまで変えてしまうことがあります。コミットする前なら、GitHub Desktop の変更一覧でそのファイルを選び、「Discard Changes(変更を破棄)」で元に戻せます9。破棄した変更は、ゴミ箱を空にするまではパソコンのゴミ箱に残ります9。すでにプルリクエストになっているなら、マージせずに、行コメントで直してほしい点を伝えます。第4回と同じ手順です。

AIの道具と GitHub Desktop を同時に開いていると、AIが書き換えた途中の状態が、Desktop の変更一覧にそのまま出てきます。AIの作業が終わったのを確かめてから、差分を見てコミットしてください。

道具ごとの補足(2026年11月時点)

2026年11月14日に、それぞれの公式ドキュメントで確かめた内容です。どちらの道具も更新が早いので、使う時点で原文を確かめてください。

確かめたいこと Codex Claude Code
どこまで確認なしで進めるかの設定 承認とサンドボックスの設定。Auto、読み取り専用、フルアクセスなど。/permissions で切り替える3 権限モード。Manual、Plan、auto など。ターミナルでは Shift+Tab で切り替える5
書き換える前に、計画や相談だけをする 読み取り専用3 Plan モード5
普段使いに勧められない設定 フルアクセス(サンドボックスも承認もなし)3 bypassPermissions(隔離した環境向け)4
依頼の前提を書いておくファイル AGENTS.md10 CLAUDE.md11

Codex の Auto は、作業フォルダの中の読み書きと命令の実行は確認なしで進め、作業フォルダの外への書き換えや、インターネットへの接続の前に確認を求めます3。標準の設定では、作業フォルダの中でも .git(第6回で見た、履歴が入ったフォルダ)は書き換えられないよう守られています3。

Claude Code の Manual は、ファイルの書き換えや命令の実行のほとんどで確認を求めます。最近の版では、安全性のチェック付きで自動的に進める auto から始まることがあります5。特定のファイルを読ませないようにするには、設定の deny(拒否)ルールに Read(./.env) のように書きます4。ただし、このルールが止めるのは、Claude Code がファイルを直接読む操作です。AIが動かした Python などのプログラムが、間接的にファイルを開く場合には効きません。どの経路からも読めないようにするには、OSの仕組みで触れる範囲を区切るサンドボックスを有効にする必要があります4。秘密のファイルは、やはり作業フォルダに置かないのがいちばんです。

AGENTS.md と CLAUDE.md には、毎回伝えたい前提を書いておけます。「main で直接作業しない」「.env は読まない」のような約束です。ただし、どちらも依頼文と同じく「お願い」の側です。Claude Code の公式ドキュメントも、CLAUDE.md は強制的な設定ではないと書いています11。鍵の代わりにはなりません。

まとめと次回予告

今回分かったことは3つです。

  • 任せる範囲は、依頼文(お願い)と道具の設定(鍵)の両方で決める
  • 秘密の情報は、依頼文にも、作業フォルダにも、GitHubにも入れない
  • 結果はプルリクエストで受け取り、差分を見てから取り込む

次回は最終回です。第6回で予告した舞台裏をお見せします。この連載の原稿は、第5回から、ここまで紹介してきた手順どおりにGitHubの上で書いてきました。2つのAIにどう役割を分け、どこで人が確かめたのか。リポジトリに残った記録を、そのまま見ていきます。

  1. ChatGPT プランで Codex を使う(OpenAI ヘルプセンター) ↩

  2. Claude Code ドキュメント(概要) ↩

  3. エージェントの承認とセキュリティ(Codex) ↩ ↩2 ↩3 ↩4 ↩5 ↩6 ↩7 ↩8 ↩9

  4. 権限を設定する(Claude Code) ↩ ↩2 ↩3 ↩4 ↩5 ↩6

  5. 権限モードを選択する(Claude Code) ↩ ↩2 ↩3 ↩4 ↩5

  6. GitHub Docs(ファイルを無視する) ↩ ↩2

  7. Codex Cloud(ChatGPT Learn) ↩

  8. 一般的なワークフロー(Claude Code) ↩

  9. GitHub Docs(GitHub Desktop でのコミットと変更の確認) ↩ ↩2

  10. AGENTS.md によるカスタム指示(Codex) ↩

  11. Claude があなたのプロジェクトを記憶する方法(Claude Code) ↩ ↩2

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?