Claude Code のフォルダ構成と GitHub――会社で AI を使う土台は、3つから考える

Claude Code のフォルダ構成と GitHub

Claude Code や Codex(OpenAI の、同じ種類の道具)を会社で使い始めると、しばらくして次の悩みが出てくることがあります。

  • AI に作らせた資料や決まりが、社員のパソコンごとにばらばらになっている
  • どのフォルダで AI を開けばいいのか、人によって違う
  • 担当の社員が休んだり辞めたりすると、AI に教えた決まりがどこにあるか分からない

どれも、AI の腕前の問題ではありません。AI に作らせたものを、どこに置き、どう残し、誰が触るかという、土台の問題です。この記事では、よく聞かれる「Claude Code に GitHub は必要ですか?」に答えたうえで、その土台を3つに分けて説明します。

目次

Claude Code に GitHub は必要ですか?

必須ではありません。Claude Code は、パソコンの中のフォルダを直接読んで書くので、パソコンの中で使うぶんには GitHub がなくても動きます。Codex も同じです。スマホやクラウドで動かす使い方は、GitHub の倉庫をつなぐのが前提になります。

ただ、会社で使うなら、入れておくことをおすすめしています。理由は3つです。

  1. パソコンの外に控えが残る。 パソコンが壊れても、GitHub に送ってあった決まりや記録は戻せます
  2. 別のパソコンと中身をそろえられる。 会社のパソコン2台のあいだや社員どうしで、同じ決まりを取り込んで使えます
  3. 社員が辞めても、会社に残る。 倉庫を会社として持っていれば、決まりと記録が個人のパソコンの中だけにある状態を避けられます

Git と GitHub の違いは、ゲームにたとえると分かりやすいです。Git はセーブポイント(パソコンの中で、変更を1つずつ記録する仕組み)、GitHub はクラウドセーブ(その記録をパソコンの外に預ける場所)です。控えになるのは、記録して GitHub に送った分だけです。別のパソコンでは、その記録を取り込んでから使います。

会社で AI を使う土台は、3つから考える

3つの軸。①フォルダの構成=中身をどう並べるか ②GitHub の倉庫の構成=どこまでを1つの単位として預けるか ③AI の置き方=どの AI が、どのフォルダを開くか
3つの軸。①フォルダの構成=中身をどう並べるか ②GitHub の倉庫の構成=どこまでを1つの単位として預けるか ③AI の置き方=どの AI が、どのフォルダを開くか

土台を決めるときに考えることは、次の3つです。

  1. フォルダの構成:AI に作らせたものを、パソコンの中でどう並べるか
  2. GitHub の倉庫の構成:どこまでを1つの単位として GitHub に預けるか
  3. AI の置き方:どの AI が、どのフォルダを開くか

順に見ていきます。

1. フォルダの構成:仕事ごとに分ける

いちばん勧めやすいのは、一番上に会社全体の決まりを置き、その下に仕事ごとのフォルダを並べる形です。仕事ごとのフォルダにも、その仕事の決まりを置きます。

こうするのは、AI の読み方に合わせるためです。Claude Code は CLAUDE.md、Codex は AGENTS.md という決まりの文書を読みます。読み方はツールで違います。

  • Claude Code:開いたフォルダとその上の階の決まりを最初に読み、下の階の決まりは、その階のファイルを扱うときに読みます
  • Codex:始めるときに、一番上から開いたフォルダまでの決まりを読みます。下の階の決まりを効かせたいときは、その階を開いて始めます

細かい読み方は、それぞれの公式の説明で確かめてください。どちらの場合も、会社全体に効くことは一番上に短く、細かいことは仕事ごとのフォルダに置くと、AI に合った並びになります。フォルダの並べ方が、そのまま AI への指示の並べ方になります。決まりの文書の書き方は「CLAUDE.md と AGENTS.md の書き方」にまとめています。

よくある失敗は、次の3つです。

  • 一番上の決まりに何でも書いて長くなり、大事な決まりが埋もれる
  • 同じ決まりを2か所に書き、片方だけ直して食い違う
  • 終わった仕事のフォルダを片付けず、AI が古い決まりを読む

2. GitHub の倉庫の構成:どこで区切るかを決める

GitHub は、フォルダ1つを、中身ごと1つの「倉庫」(GitHub の画面では「リポジトリ」)として預かります。決めることは、どこまでを1つの倉庫にするかです。

切り方中身向く場面
1つにまとめる会社の決まりと、仕事ごとのフォルダを丸ごと1つの倉庫に会社の仕事のやり方と記録をためていきたいとき
作業ごとに分けるアプリ・サイト・お客さんごとに倉庫を分ける作ったものを人に渡す・公開する・お客さんごとに中身を分けたいとき
用途で分ける会社の倉庫と個人の倉庫のように、持ち主で分ける扱ってよいデータやアカウントが違うとき

あわせて、倉庫に載せないものを決めておきます。

  • 動画・音声・大きな画像(通常の送り方では、1つのファイルが約100MBを超えると GitHub に送れません)
  • AI やサービスにつなぐための鍵やパスワードを書いたファイル
  • お客さんとの打ち合わせの録音や文字起こしなど、生の記録

載せないものは、外付けの記憶装置など、別の控えで守ります。そして倉庫は非公開で作ります。一度公開すると、あとで消しても、その間に写されたものは取り消せません。

3. AI の置き方:まずは1つから

Claude Code と Codex は、弊社で比べた範囲では、ふつうの仕事ならどちらでもこなせました。弊社では、まずはどちらか1つから始めることをおすすめしています。Claude の有料プランを契約しているなら Claude Code、ChatGPT の有料プランなら Codex で、まず必要な仕事ができるかを試してみてください。

2つ使う場合は、同じフォルダを2つの AI で開くか、AI ごとに別のフォルダにするかを決めます。同じフォルダなら作ったものをすぐ渡し合えますが、同じファイルを同時に書き換えないための決まりが要ります。別のフォルダなら混ざりませんが、お互いの仕事が見えなくなります。

3つは、つながっている

3つは別々の話に見えますが、つながっています。

  • 倉庫の区切りは、フォルダの区切りと重なります。 ただし1つの倉庫の中には、フォルダをいくつでも作れますし、載せないフォルダも作れます。倉庫を決めることは、フォルダの上に「どこで区切るか」の線を引くことです
  • ぶつかったときの守られ方は、倉庫と AI の置き方で決まります。 同じ倉庫を、社員やパソコンごとの別々の写しで使うと、別々に直したものを取り込むときに、同じ所を直していてまとめられなければ、Git が止めて知らせます。一方、1つのフォルダを2つの AI が同時に使うと、Git はそこを見張れません
  • フォルダの並べ方は、AI への指示の並べ方です。 AI は開いたフォルダの決まりを読むからです

よくある組み合わせを並べると、次のようになります(A〜C2 は、この記事の中での呼び名です)。

よくある5つの組み合わせ。C2=1つの倉庫の中に仕事ごとのフォルダ(AI が1つならこれが基本)/C1=作業ごとに別の倉庫/B1=AI ごとに別のフォルダと倉庫/B2=同じ倉庫を2つのフォルダに写す/A=1つのフォルダを2つの AI で使う
よくある5つの組み合わせ。C2=1つの倉庫の中に仕事ごとのフォルダ(AI が1つならこれが基本)/C1=作業ごとに別の倉庫/B1=AI ごとに別のフォルダと倉庫/B2=同じ倉庫を2つのフォルダに写す/A=1つのフォルダを2つの AI で使う
形ひとこと
C2:1つの倉庫の中に、仕事ごとのフォルダAI が1つなら、まずこれ。 仕事のやり方をためる
C1:作業ごとに、別のフォルダと倉庫アプリやサイトを作るときの形
B1:AI ごとに、別のフォルダと倉庫混ざらない。お互いの仕事は見えない
B2:1つの倉庫を、AI ごとの2つの写しで取り込むときにぶつかれば Git が知らせる。倉庫に載せない素材は別に写す
A:1つのフォルダを、2つの AI で2つを組ませる。同時に書き換えない決まりが要る

社員が何人もいるとき

会社では、ここに「何人が、どこまで触るか」が加わります。GitHub がいちばん役に立つのは、ここです。

  • 社員はそれぞれ、自分のパソコンに倉庫の写しを持ちます。 2人が同じファイルの同じ所を別々に直していれば、取り込むときに Git が止めて知らせます。違う所なら、Git がまとめます
  • 倉庫は会社として持ちます。 個人のアカウントに置くと、その人が辞めたときに会社の手元から離れるおそれがあります。GitHub には、会社として倉庫を持つ仕組み(組織のアカウント=Organization)があります
  • 会社のデータと、社員が個人で使う AI を混ぜない。 会社の倉庫と、個人のフォルダは分けておきます
  • 社外の人に見せるときは、範囲を決めて、見るだけの権限で招きます。 見るだけ・書けるの権限を分けるのは、会社として持つ倉庫の設定です。料金や権限の細かい分け方は、GitHub の公式の説明で確かめてください。期間が終わったら、手で外します

決まりと記録が会社の倉庫に残っていれば、担当が替わっても、次の人はそこから始められます。辞めるときに慌てて引き継ぎを作る場面を減らせます(「引き継ぎは辞めるときに作るものではない」)。

弊社の代表は、こう使っています

ご相談では AI を1つから始めることをおすすめしていますが、弊社の代表は、Claude Code と Codex の2つを1つのフォルダで組ませて使っています(上の表の A)。

  • Codex が作ったものを、Claude Code がそのまま開いて確かめる、というように、作る役と確かめる役をその場で入れ替えられる
  • 動画や画像、声の素材は GitHub に載せていないので、倉庫を通しては渡せない。別に写す手間を省くために、同じフォルダを使っている
  • 決まりの文書を1か所にまとめられる

GitHub の倉庫は非公開の1つだけで、2台のパソコン(Windows と Mac)とスマホの Claude Code が、その倉庫を通して、載せている分は同じ中身を使っています。代わりに、2つの AI が同じファイルを同時に書き換えないための決まりを置いています。2つの AI に同じ材料を触らせたい人向けの形で、最初からこの形を勧めることはしていません。

選ぶ順番

迷ったら、次の順で決めます。

  1. AI は1つですか? → はい:1つの倉庫の中に、仕事ごとのフォルダ(C2)。アプリやサイトを作るなら、その作品だけフォルダごと外に出して、別の倉庫に(C1)/いいえ:2へ
  2. 2つの AI に、同じ材料を触らせたいですか? → いいえ:AI ごとに分ける(B1)/はい:3へ
  3. 倉庫に載せない素材(動画・画像など)も、2つで使いますか? → はい:1つのフォルダを2つで使う(A)。同時に書き換えない決まりを置く前提です/いいえ:同じ倉庫を写しで分ける(B2)

何人も使うなら、あわせて、倉庫は会社として持ち、見せる範囲を決めます。

弊社では、会社で AI を使うときのフォルダの並べ方や、GitHub の入れ方のご相談をお受けしています。お問い合わせからご連絡ください。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

クリュープラス株式会社 代表取締役。群馬県伊勢崎市を拠点に、ドローン空撮とWebマーケティングを行っています。一等無人航空機操縦士。2016年から沖縄の離島を中心にドローンを飛ばし、飛行は200時間以上、事故はありません。Kindleで『言葉が変われば、単価は変わる』と写真集『青と白と緑』を出版。YouTube「drone islands」で、空から撮った日本の景色を公開しています。

目次