はじめに
最近、Claude Codeなどの自律型AIエージェントや、CLIベースの強力な開発ツールをワークフローに組み込む機会が急激に増えてきました。
AIがターミナル上で自律的にコードを生成し、コマンドを叩いてテストを回してくれる現代において、開発者にとっても、「CUI(ターミナル)を中心としたシームレスな開発体験」の重要性が、以前にも増して高まっています。
しかし、WSL2(Ubuntu)のターミナルを開いた直後、cdとlsを繰り返して目的のプロジェクトを探したり、~/Documents/GitHub/や~/workspace/の下に様々なリポジトリが無秩序に散らかっていたりしませんか？
かつてはghq + pecoの組み合わせでディレクトリを管理するのが定番でしたが、現在はより高速で 圧倒的に強力な「プレビュー機能」 を持つfzfを組み合わせるのがモダンなベストプラクティスです。
本記事では、Mac向けの情報が多いこの組み合わせを、WSL2 (Ubuntu) 環境へ最適に導入する手順 から 「ターミナル上でリポジトリの中身をのぞき見し、選択した瞬間にVS Codeが立ち上がる最強のショートカット を設定するまでを解説します。
1. ghqの導入と基本設定
ghq は、Gitリポジトリをホスティングサービス（GitHubなど）のドメインやユーザー名ごとに整理して自動配置してくれる神ツールです。
Goのインストール（※要注意トラップ）
Ubuntu環境では、Goを使ってインストールするのが最も確実です。
ただし、ここで単に sudo apt install golang-go を実行すると古いバージョンのGoが入ってしまい、ghqのインストール時にエラーになることがよくあります。
これを防ぐため、Go言語公式Wikiでも推奨されているPPA(最新版のリポジトリ)を追加してからインストールします。
# 最新のGoを取得するためのPPAを追加
sudo add-apt-repository ppa:longsleep/golang-backports -y
sudo apt update
# 最新版のGoをインストール
sudo apt install golang-go -y
ghqのインストール
最新のGoが入ったら、以下のコマンドで ghq をインストールします。
同時に、インストールしたツールをターミナルからすぐに呼び出せるよう、~/.bashrc へのPATH追記と反映までを一気に実行してしまいます。
# ghqのインストール
go install github.com/x-motemen/ghq@latest
# Goでインストールしたバイナリ（~/go/bin）へのパスを通す
echo 'export PATH=$PATH:$(go env GOPATH)/bin' >> ~/.bashrc
# 設定を現在のターミナルに反映
source ~/.bashrc
ghqのルートディレクトリ設定
クローンしたリポジトリをどこに保存するかを設定します。今回は~/ghqをベースにします。
git config --global ghq.root ~/ghq
【重要】自動的にSSHプロトコルでクローンさせる設定
GitHubからリポジトリをクローンする際、後々コミット時にPGP署名(GPG署名)を行うことや、認証の確実性を考慮すると、HTTPSではなく SSH でセキュアにクローンしたい場面が多くあります。
しかし ghq の仕様上、ghq get (アカウント名)/(リポジトリ名) と短縮形で指定して実行すると、デフォルトではHTTPS通信(https://github.com/... )として解釈されてしまいます。
これを「自動的にSSHでのクローン」に変換させるため、Gitの insteadOf という機能を設定しておきます。
git config --global url."git@github.com:".insteadOf "https://github.com/"
この設定を1行入れておくだけで、以降は ghq get mfunaki/my-repo と打った際にも、裏側で自動的に git@github.com:mfunaki/my-repo.git として解釈され、SSH経由でスムーズにクローンが行われるようになります。
2. fzf の導入
fzf はターミナル上の出力をインクリメンタルサーチできるフィルタツールですが、単なる曖昧検索ツールだと思っていませんか？ 実は、fzfの真骨頂は「プレビュー機能」にあります。
Ubuntuの apt で入るバージョンは古いことがあるため、公式推奨のGitクローン経由でのインストールがおすすめです。
git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf
~/.fzf/install
インストールを実行すると、途中で以下の3つの質問（対話プロンプト）が表示されます。基本的にはすべて y (Yes) を入力して進めてください。
-
Do you want to enable fuzzy auto-completion?
（あいまい検索による自動補完を有効にしますか？） -
Do you want to enable key bindings?
（履歴検索などのキーバインドを有効にしますか？） -
Do you want to update your shell configuration files?
（.bashrc 等の設定ファイルを自動更新してよろしいですか？）
3. 【準備】プレビュー用のモダンツールを導入
fzf のプレビュー画面をリッチにするため、モダンなファイルツリー表示ツールである eza (旧 exa の後継) をインストールしておきます。
sudo apt update
sudo apt install eza -y
4. 【本命】ターミナルから爆速で移動＆プレビュー＆VS Code起動
ここからが本番です。
「ghq で管理しているリポジトリを fzf で検索し、右側のプレビュー画面でディレクトリ構造を確認してから、移動と同時にVS CodeのRemote-WSLで開く」という一連の動作を、ショートカットキー一発で呼び出せるようにします。
お使いのシェルの設定ファイル（~/.bashrc または ~/.zshrc）の末尾に、以下のスクリプトを追記してください。
# ghq + fzf 連携関数（プレビュー機能付き）
function cd-ghq() {
# ezaを使って右側にディレクトリツリーをプレビュー表示する
local dir="$(ghq list --full-path | fzf --reverse --height 50% --prompt='Select Repo > ' --preview 'eza --tree --level=2 --color=always --icons {}')"
if [ -n "$dir" ]; then
cd "$dir"
echo "Moved to $dir"
# そのままVS Codeで開く
code .
fi
}
# Ctrl + g で呼び出せるようにキーバインドを設定 (Bash用)
bind '"\C-g":"cd-ghq\n"'
(zsh をお使いの場合は、キーバインド行を zle -N cd-ghq と bindkey '^g' cd-ghqに書き換えてください。)
追記したら、source ~/.bashrc で設定を反映させます。
動作確認
ターミナル上で Ctrl + g を押してみてください。
リポジトリの一覧と同時に、その中身(ツリー構造)が右側にプレビューされます。カーソルキーで上下に移動するだけで、エディタを開く前に「あ、このプロジェクトだ」と一瞬で判断できます。
Enterを押せば、そのディレクトリへ移動すると同時に、自動的にVS Codeが立ち上がります！
やっぱやめた(これじゃない)という時には、Esc キーで抜けられます。
思考のスピードでプロジェクトを切り替えられる、最高に気持ちいい体験の完成です。
ワンポイント: fzfを入れたら絶対に使うべき「Ctrl + R」
インストール時にキーバインドを有効化すると、Ctrl + R でコマンド履歴のあいまい検索ができるようになります。
これが今回構築した「リポジトリ移動(Ctrl + G)」と最高のコンボになります。
先ほどの Ctrl + G で目的のリポジトリを選択すると、即座にVS Codeが立ち上がりますよね。その直後、VS Codeの内蔵ターミナルを開いて Ctrl + R を押し、run や test などと打つだけで、「前回そのプロジェクトで叩いた長いビルドコマンドや、テスト起動コマンド」を1秒で呼び出して再実行できます。
また、Claude CodeなどのAIエージェントに投げた「長文の指示プロンプト」も、キーワード検索で一瞬で復元できるため、相性は抜群です。
カーソルキーの上矢印 ↑ を連打して履歴を遡る日々は、今日で終わりにしましょう！
終わりに(次回予告)
WSL2上のターミナルから一瞬でVS Codeを開けるようになると、AIを活用した開発スピードは劇的に上がります。
しかし、この環境でいざ git commit をしようとした際、「パスフレーズの入力画面がバグってコミットできない(WSL2/Ubuntuにいるつもりなのに command not found 等になる)」 という、VS Code内蔵ターミナル特有の恐ろしい罠が待ち受けていることがあります。
次回は、この「WSL2 × VS Code の Git認証トラップ」を、Ubuntu純正のGUIダイアログ(WSLg)を使ってスマートに完全解決する方法を解説します！
もし今回の記事が少しでもお役に立てましたら、いいねやストック、アカウントをフォローしてお待ちいただけると、次回の執筆の大きな励みになります！