Claude Code が打つコマンドの読み方

作業を始める前 — status・fetch -q・status・branch --show-current

1. Windows のノート PC で、Claude Code が作業を始めます。最初の git status は、書きかけが無いか（working tree clean）を見ています。2行目の up to date は、手元の写し origin/main と比べた答えです。

   $ git status
   On branch main
   Your branch is up to date with 'origin/main'.
   
   nothing to commit, working tree clean

2. 昨夜 Mac で push した「パンを追加」が GitHub 側にあります。git fetch -q は何も表示しませんが、手元の origin/main の付箋はそこまで進みました。

   $ git fetch -q

3. 同じ git status を、fetch のあとにもう一度打ちます。2行目が behind 'origin/main' by 1 commit に変わりました。status を2回打つのは、fetch の前と後で答えが違いうるからです。

   $ git status
   On branch main
   Your branch is behind 'origin/main' by 1 commit, and can be fast-forwarded.
     (use "git pull" to update your local branch)
   
   nothing to commit, working tree clean

4. いま乗っているブランチの名前だけが1行で出ます。これから積むコミットが main に入ることを確かめています。

   $ git branch --show-current
   main

5. 早送りで済むと分かったので、main を origin/main まで進めます。Updating a1c4f20..c43e6a8 と Fast-forward が出れば、追いつきました。

   $ git pull --ff-only
   Updating a1c4f20..c43e6a8
   Fast-forward
    todo.txt | 1 +
    1 file changed, 1 insertion(+)

6. 括弧の中に HEAD -> main と origin/main が並んでいます。GitHub と同じところから作業を始められる、という確認です。

   $ git log --oneline -1
   c43e6a8 (HEAD -> main, origin/main, origin/HEAD) パンを追加

変更を確かめてステージに載せる — diff --stat・diff・diff --cached

1. Claude Code に「買い物メモにバターを足して」と頼み、todo.txt が書き換わりました。notes.txt には、自分で書きかけていた1行があります。status の赤い欄に、2つとも modified で並びます。

   $ git status
   On branch main
   Your branch is up to date with 'origin/main'.
   
   Changes not staged for commit:
     (use "git add <file>..." to update what will be committed)
     (use "git restore <file>..." to discard changes in working directory)
   	modified:   notes.txt
   	modified:   todo.txt
   
   no changes added to commit (use "git add" and/or "git commit -a")

2. --stat は、ファイルごとに何行変わったかの一覧です。見るのは ファイル名の列 で、頼んだ覚えのないファイルが混ざっていないかを確かめます。ここでは notes.txt が混ざっています。

   $ git diff --stat
    notes.txt | 1 +
    todo.txt  | 1 +
    2 files changed, 2 insertions(+)

3. 中身を見るときは --stat を外します。+ で始まる行が足された行です。notes.txt の +火曜は特売 は、今回の作業とは関係のない書きかけだと分かります。

   $ git diff
   diff --git a/notes.txt b/notes.txt
   --- a/notes.txt
   +++ b/notes.txt
   +火曜は特売
   diff --git a/todo.txt b/todo.txt
   --- a/todo.txt
   +++ b/todo.txt
   +バターを買う

4. そこで、todo.txt だけをステージに写します。git add . ではなくファイル名を書くのは、こういう書きかけを拾わないためです。

   $ git add todo.txt

5. --cached は ステージと HEAD のコミット の差、つまり次のコミットに入るものです。todo.txt の1ファイル・1行だけになりました。

   $ git diff --cached --stat
    todo.txt | 1 +
    1 file changed, 1 insertion(+)

6. --name-only は、ファイル名だけを並べます。この一覧が、そのままコミットに入るファイル です。

   $ git diff --cached --name-only
   todo.txt

7. 緑の欄（Changes to be committed）に todo.txt、赤の欄に notes.txt が分かれました。赤の欄のファイルは、このままコミットしても入りません。

   $ git status
   On branch main
   Your branch is up to date with 'origin/main'.
   
   Changes to be committed:
     (use "git restore --staged <file>..." to unstage)
   	modified:   todo.txt
   
   Changes not staged for commit:
     (use "git add <file>..." to update what will be committed)
     (use "git restore <file>..." to discard changes in working directory)
   	modified:   notes.txt
   

コミットして読み返す — commit・log --oneline -3・show --stat

1. 前の区間の続きです。todo.txt にバターの1行、notes.txt に自分の書きかけの1行があります。

2. 前の区間と同じく、todo.txt だけをステージに写します。

   $ git add todo.txt

3. [main af62c16] は「main に af62c16 のコミットを積んだ」、次の行はそのコミットが変えた量です。ここが 2 files changed なら、何かが余計に入っています。

   $ git commit -m "バターを追加"
   [main af62c16] バターを追加
    1 file changed, 1 insertion(+)

4. 1行目 だけを見ます。いま作ったメッセージに (HEAD -> main) が付いていれば、コミットは歴史の先頭に入りました。2行目の (origin/main, origin/HEAD) は、GitHub の写しがまだ1つ前にあるという印です。

   $ git log --oneline -3
   af62c16 (HEAD -> main) バターを追加
   c43e6a8 (origin/main, origin/HEAD) パンを追加
   a1c4f20 店のメモを追加

5. いま作ったコミットに入ったファイルの一覧です。todo.txt だけで、notes.txt は入っていません。

   $ git show --stat
   commit af62c16 (HEAD -> main)
   
       バターを追加
   
    todo.txt | 1 +
    1 file changed, 1 insertion(+)

6. 2行目は ahead of 'origin/main' by 1 commit（まだ送っていないコミットが1つ）です。notes.txt は赤の欄に残っていて、書きかけはそのまま無事です。

   $ git status
   On branch main
   Your branch is ahead of 'origin/main' by 1 commit.
     (use "git push" to publish your local commits)
   
   Changes not staged for commit:
     (use "git add <file>..." to update what will be committed)
     (use "git restore <file>..." to discard changes in working directory)
   	modified:   notes.txt
   
   no changes added to commit (use "git add" and/or "git commit -a")

送って、届いたかを確かめる — push -q・status・log --oneline -1

1. 前の区間の続きです。2行目の ahead of 'origin/main' by 1 commit が、まだ送っていないコミットの数です。

   $ git status
   On branch main
   Your branch is ahead of 'origin/main' by 1 commit.
     (use "git push" to publish your local commits)
   
   Changes not staged for commit:
     (use "git add <file>..." to update what will be committed)
     (use "git restore <file>..." to discard changes in working directory)
   	modified:   notes.txt
   
   no changes added to commit (use "git add" and/or "git commit -a")

2. 送られるのは、(origin/main, origin/HEAD) の付いた行より 上の行 のコミットです。ここでは「バターを追加」の1つだけです。

   $ git log --oneline -3
   af62c16 (HEAD -> main) バターを追加
   c43e6a8 (origin/main, origin/HEAD) パンを追加
   a1c4f20 店のメモを追加

3. --contains HEAD は、いまのコミットを含む追跡ブランチだけを出します。何も出ないのは、「バターを追加」がまだどの origin/ の写しにも入っていない、つまりまだ送っていないからです。

   $ git branch -r --contains HEAD

4. -q を付けた push は、うまくいくと何も表示しません。上の GitHub 側の main と、手元の origin/main が「バターを追加」へ進みました。

   $ git push -q

5. 出力の無い push が届いたかを、2行目で確かめます。ahead が消えて up to date with 'origin/main' に戻りました。

   $ git status
   On branch main
   Your branch is up to date with 'origin/main'.
   
   Changes not staged for commit:
     (use "git add <file>..." to update what will be committed)
     (use "git restore <file>..." to discard changes in working directory)
   	modified:   notes.txt
   
   no changes added to commit (use "git add" and/or "git commit -a")

6. HEAD -> main と origin/main が同じ行に並びました。手元の main と GitHub の写しが、同じコミットにあるという意味です。

   $ git log --oneline -1
   af62c16 (HEAD -> main, origin/main, origin/HEAD) バターを追加

7. push のあとは origin/main が出ます。「バターを追加」が GitHub の main の写しに入った、つまり送ってあるという答えです。

   $ git branch -r --contains HEAD
     origin/HEAD -> origin/main
     origin/main

8. push が送るのはコミットだけです。notes.txt の書きかけは送られず、作業ツリーに残っています。

   $ cat notes.txt
   駅前のスーパー
   火曜は特売