Git & GitHub セットアップ

chroはバージョン管理にGitを、コラボレーションにGitHubを使用します。このガイドでは、両プラットフォームでのインストールとSSH鍵のセットアップについて説明します。

既存のインストール確認

まず、Gitがすでにインストールされているか確認します：

git --version

Gitがインストールされていれば、バージョン番号が表示されます。そうでない場合は、以下のインストール手順に従ってください。

macOS

方法1: Xcode Command Line Tools（推奨）

macOSでGitを入手する最も簡単な方法：

xcode-select --install

ダイアログが表示されます。「インストール」をクリックして完了を待ちます。

方法2: Homebrew

Homebrewがインストールされている場合：

brew install git

インストールの確認

git --version  # git version 2.x.x と表示されるはず

Windows

方法1: winget（推奨）

Windowsパッケージマネージャーを使用：

winget install Git.Git

注意: インストール後、ターミナルを再起動してください。

方法2: Git for Windows インストーラー

git-scm.comからダウンロード
インストーラーを実行
デフォルト設定を使用（初心者には推奨）
「Git from the command line and also from 3rd-party software」が選択されていることを確認

インストールの確認

新しいターミナル/PowerShellウィンドウを開きます：

git --version

Gitの初期設定

ID（コミットに必要）を設定します：

git config --global user.name "あなたの名前"
git config --global user.email "[email protected]"

デフォルトブランチ名をmainに設定：

git config --global init.defaultBranch main

設定を確認：

git config --list

GitHubアカウントのセットアップ

GitHubアカウントをお持ちでない場合：

github.comにアクセス
「Sign up」をクリック
登録プロセスに従う
メールアドレスを確認

SSH鍵のセットアップ（推奨）

SSH鍵は、GitHubとのセキュアでパスワード不要の認証を提供します。

SSH鍵の生成

macOS / Linux / Windows（Git BashまたはWSL）：

ssh-keygen -t ed25519 -C "[email protected]"

プロンプトが表示されたら：

Enterキーを押してデフォルトのファイル場所を受け入れる
パスフレーズを入力（推奨）またはEnterキーでパスフレーズなし

Windows（PowerShell）：

ssh-keygen -t ed25519 -C "[email protected]"

SSHエージェントの起動

macOS：

eval "$(ssh-agent -s)"

~/.ssh/configに追加（存在しない場合は作成）：

Host github.com
  AddKeysToAgent yes
  UseKeychain yes
  IdentityFile ~/.ssh/id_ed25519

鍵を追加：

ssh-add --apple-use-keychain ~/.ssh/id_ed25519

Windows（PowerShell - 管理者として実行）：

# ssh-agentサービスを開始
Get-Service -Name ssh-agent | Set-Service -StartupType Automatic
Start-Service ssh-agent

# 鍵を追加
ssh-add $env:USERPROFILE\.ssh\id_ed25519

Linux / WSL：

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

SSH鍵をGitHubに追加

1. 公開鍵をコピー：

macOS：

pbcopy < ~/.ssh/id_ed25519.pub

Windows（PowerShell）：

Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub | Set-Clipboard

Linux：

cat ~/.ssh/id_ed25519.pub
# 出力を手動でコピー

2. GitHubに追加：

GitHub設定 > SSH Keysにアクセス
「New SSH key」をクリック
わかりやすいタイトルを入力（例：「MacBook Pro 2024」）
「Key」フィールドに鍵を貼り付け
「Add SSH key」をクリック

接続テスト

ssh -T [email protected]

以下のように表示されるはずです：

Hi username! You've successfully authenticated, but GitHub does not provide shell access.

代替手段: 個人アクセストークンを使用したHTTPS

SSHよりHTTPSを好む場合：

個人アクセストークンの作成

GitHub設定 > Developer Settings > Personal Access Tokensにアクセス
「Generate new token (classic)」をクリック
わかりやすい名前を入力
スコープを選択：repo（プライベートリポジトリの完全な制御）
「Generate token」をクリック
トークンをすぐにコピー（再度表示されません）

Git認証情報ストレージの設定

macOS：

git config --global credential.helper osxkeychain

Windows：

git config --global credential.helper wincred

初めてpush/pullするとき、GitHubユーザー名を入力し、パスワードとしてトークンを使用します。

GitHub接続の確認

リポジトリをクローンしてテスト：

# SSH（推奨）
git clone [email protected]:octocat/Hello-World.git

# またはHTTPS
git clone https://github.com/octocat/Hello-World.git

成功すれば、GitでGitHubを使用する準備ができています！

トラブルシューティング

”Permission denied (publickey)”

SSH鍵がエージェントに追加されていることを確認：ssh-add -l
鍵がGitHubに追加されていることを確認：github.com/settings/keys
正しい鍵を使用していることを確認：ssh -vT [email protected]

”Could not open a connection to your authentication agent”

SSHエージェントを起動：

eval "$(ssh-agent -s)"

Gitがpushのたびにパスワードを要求（HTTPS）

認証情報ストレージを設定：

# macOS
git config --global credential.helper osxkeychain

# Windows
git config --global credential.helper wincred

# Linux
git config --global credential.helper store

改行コードの問題（Windows）

改行を処理するようにGitを設定：

git config --global core.autocrlf true

次のステップ

GitとGitHubの設定が完了したら、次に進んでください：

AIコーディングツールのセットアップ - Claude CodeまたはOpenAI Codexをインストール
chroのインストール - chroをインストール