開発環境ガイド

インストール

GitHubに接続する

SSHキーを作ってGitHubに登録し、GitHub CLIも用意します。

GitHubにコードを送ったり(push)、取得したり(clone)するには、「自分であること」をGitHubに伝える設定が必要です。このページでは、パスワードを毎回入力しなくてよい SSHキー を使います。

SSHキーは「鍵(秘密鍵)」と「鍵穴(公開鍵)」のペアです。公開鍵をGitHubに登録し、秘密鍵は自分のパソコンに置いておきます。秘密鍵は誰にも渡さないでください。

手順1: SSHキーを作る

WSL(Ubuntu)で実行します。メールアドレスは、GitHubに登録したものにします。

ssh-keygen -t ed25519 -C "you@example.com"

いくつか質問されます。

  1. Enter file in which to save the key: そのまま Enter(標準の場所に保存されます)
  2. Enter passphrase: 鍵を守る合言葉です。設定をおすすめします(空でも動きます)

手順2: 公開鍵をコピーする

次のコマンドで、公開鍵を表示します。

cat ~/.ssh/id_ed25519.pub

ssh-ed25519 AAAA... で始まる1行が表示されます。その1行全体をマウスで選択してコピーします。

コピーするのは .pub が付いた 公開鍵 です。id_ed25519(.pub なし)は秘密鍵なので、絶対にコピーして貼り付けたり、共有したりしないでください。

手順3: GitHubに登録する

  1. ブラウザでGitHubにログインします。
  2. 右上のアイコン → Settings を開きます。
  3. 左のメニューから SSH and GPG keys を選びます。
  4. New SSH key を押します。
  5. Title に「WSL Ubuntu」など、分かる名前を入れます。
  6. Key に、コピーした公開鍵を貼り付けて Add SSH key を押します。

手順4: つながるか確認する

ssh -T git@github.com

初回は、次のように確認されます。yes と入力して Enter を押します。

Are you sure you want to continue connecting (yes/no/[fingerprint])?

次のように、自分のユーザー名で挨拶されれば成功です。

Hi ユーザー名! You've successfully authenticated, but GitHub does not provide shell access.

GitHub CLI(gh)を入れる(おすすめ)

gh は、GitHubの操作(リポジトリの作成、プルリクエストなど)をコマンドでできる公式ツールです。Claude Code も、GitHubの操作に gh を使えます。

公式の手順に沿ってインストールします。

(type -p wget >/dev/null || (sudo apt update && sudo apt-get install wget -y)) \
  && sudo mkdir -p -m 755 /etc/apt/keyrings \
  && out=$(mktemp) && wget -nv -O$out https://cli.github.com/packages/githubcli-archive-keyring.gpg \
  && cat $out | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg > /dev/null \
  && sudo chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg \
  && sudo mkdir -p -m 755 /etc/apt/sources.list.d \
  && echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null \
  && sudo apt update \
  && sudo apt install gh -y

インストール手順は更新されることがあります。エラーになったときは、GitHub CLIの公式インストール手順(Linux)を確認してください。

インストールできたら、バージョンを確認してログインします。

gh --version
gh auth login

質問には、次のように答えます。

質問選ぶもの
Where do you use GitHub?GitHub.com
Preferred protocol for Git operationsSSH
Upload your SSH public key登録済みなら、すでにある鍵を選ぶ
How would you like to authenticate GitHub CLI?Login with a web browser

表示されたコードをコピーし、ブラウザの画面に入力して許可します。

gh auth status

Logged in to github.com と表示されれば完了です。

確認する

  • ssh -T git@github.com で、ユーザー名つきの挨拶が表示される
  • gh auth status で、ログイン済みと表示される(gh を入れた場合)

うまくいかないとき

  • Permission denied (publickey): 公開鍵の登録が違っている可能性があります。cat ~/.ssh/id_ed25519.pub の内容と、GitHubに登録した内容が同じか確認してください。
  • 登録したのに毎回パスフレーズを聞かれる: SSHエージェントに鍵を預けると、入力が減ります。eval "$(ssh-agent -s)" のあと ssh-add ~/.ssh/id_ed25519 を実行します。

Esc で閉じます