glabとは?GitLabをコマンドで操作する道具

glabって何?

glabは、GitLabをコマンドラインから操作するための公式CLIツールです。ブラウザでGitLabのページを開いてポチポチする代わりに、ターミナルに文字を打ち込んでマージリクエストを作ったり、Issueを眺めたり、CI/CDパイプラインの状況を確認したりできます。

GitHubにghというCLIがあるのをご存じなら、その関係とほぼ同じだと思ってもらって差し支えありません。ghがGitHub用なら、glabがGitLab用、という対応です。

身近な例えで言うと

銀行の窓口に行って、番号札を取って、順番を待って、用紙に記入して……というのがブラウザでGitLabを操作するイメージです。一方glabは、ATMやスマホアプリのようなもの。やれることは窓口より絞られるけれど、よく使う操作なら圧倒的に速い。

特に「コードを書いていたターミナルから一歩も動かずに済む」というのが大きくて、ブラウザに切り替えて、プロジェクトを探して、ボタンの位置を思い出して……という一連の中断がなくなります。この「中断が消える」のが、CLIツールの一番の価値かもしれません。

gitコマンドとは別物です

ここが最初に混乱しやすいところなのですが、gitとglabは別のツールです。

だからgit pushでブランチを送ったあと、glabでマージリクエストを作る、という流れになります。役割分担がはっきりしているので、慣れれば迷わなくなります。

Claude Codeとの関わり

Claude Codeはターミナル上で動き、必要に応じてコマンドを実行します。つまり、あなたの環境にglabが入っていれば、Claude Codeもそれを使えるということです。

「このブランチの変更内容でマージリクエストを作っておいて」と頼めば、Claude Codeが差分を読んでタイトルと説明文を組み立て、glab経由で作成する、といった動き方が考えられます。ブラウザを操作する能力は持っていなくても、CLIツールがあればGitLabに手を伸ばせるわけです。

逆に言うと、glabが入っていない・ログインしていない環境では、Claude CodeはGitLabの情報にアクセスできません。「なぜかMR周りのお願いがうまくいかない」というときは、まず手元でglabが動くかどうかを確認するのが近道です。

使い始めるまでの流れ

インストール方法はOSごとに異なりますが、macOSならHomebrew、LinuxならパッケージマネージャやGitLabが配布しているバイナリ、といった選択肢があります。詳細は公式のドキュメントを確認してください。

インストール後は認証が必要です。GitLabのアカウントとglabを結びつけないと、当然ながら自分のプロジェクトは見えません。ここを飛ばして「コマンドがエラーになる」と悩む人はけっこういます。

そして重要なのが実行する場所。glabは基本的に、カレントディレクトリがどのGitLabプロジェクトのリポジトリなのかを見て動きます。関係ないディレクトリで打っても「どのプロジェクトの話をしているのか分からない」状態になるので、対象のリポジトリの中で実行しましょう。

セルフホスト版のGitLabでも使える

GitLabは、gitlab.comのようなクラウド版だけでなく、企業が自社サーバーに立てて運用しているケースも多いツールです。glabはそうしたセルフホスト環境も想定されていて、接続先のホストを指定して使えます。社内GitLabで開発しているチームにとっては、ここが地味に効いてくるポイントです。

最初の一歩としておすすめの使い方

いきなり全部のコマンドを覚える必要はありません。自分がブラウザで一番よくやっている操作――たとえば「マージリクエストの一覧を見る」あたり――をglabに置き換えてみる。それだけでも、ターミナルから離れずに済む快適さは十分に体感できます。

コマンド名やオプションが分からなくなったら、glabのヘルプ表示に頼るのが確実です。うろ覚えのコマンドを試行錯誤するより、ヘルプを見たほうが結局は早い、というのはCLIツール全般に言えることですね。