Claude Code 入門 － ターミナルから AI とペアプロを始める最初の一歩

Claude Code 入門 － ターミナルから AI とペアプロを始める最初の一歩

はじめに

「コードを書いていて、同僚に気軽に相談できたら」と思ったことはないでしょうか。バグの原因を一緒に探してほしい、このモジュールのテストを書いてほしい、コミットメッセージを考えてほしい。そんな場面で頼れる AI ペアプログラマーが、ターミナルのすぐ隣にいてくれたら便利ですよね。

Claude Code は、ターミナルから直接使える AI コーディングアシスタントです。チャットでコードの断片を貼り付けて質問するような使い方ではなく、実際のプロジェクトディレクトリの中でファイルを読み書きし、コマンドを実行しながら一緒に作業を進めてくれます。この記事では、インストールから最初のタスク実行まで、一通りの流れを紹介します。

Claude Code でできること

Claude Code は、日常的な開発業務の多くをカバーしています。公式ドキュメントでは「コードベースを理解し、ファイルを編集し、コマンドを実行し、開発ツールと統合するエージェント型のコーディングツール」と説明されています。

具体的には次のような作業を任せられます。コード生成やバグ修正はもちろん、未テストのコードへのテスト追加、リファクタリング、コミットメッセージの作成、プルリクエストの作成、依存ライブラリの更新など、後回しにしがちな地味な作業もまとめて引き受けてくれます。複数ファイルをまたぐ修正も一度の指示でこなしてくれるので、大きなリファクタリングでも頼りになります。

利用するにはアカウントが必要です。Claude.ai の有料プラン（Pro、Max、Team、Enterprise）のほか、Claude Console（API アクセス）や Amazon Bedrock・Google Vertex AI・Microsoft Foundry といったクラウドプロバイダー経由でも利用できます。ターミナルの CLI に加え、VS Code や JetBrains IDE の拡張機能、デスクトップアプリ、ブラウザからも使えますが、この記事ではターミナル CLI を中心に紹介します。

インストール手順

Claude Code のインストールは、ネイティブインストーラーを使うのが公式推奨の方法です。以前は npm によるインストールが一般的でしたが、現在は非推奨になっています。ネイティブインストーラーは Node.js 不要で動作し、バックグラウンドで自動更新される点も便利です。

macOS でのインストール

ターミナルを開き、次のコマンドを実行します。

curl -fsSL https://claude.ai/install.sh | bash

Homebrew を使っている場合は、こちらの方法も選べます。公式では2種類のキャストが用意されています。claude-code は安定チャンネルを追跡するもので、最新版より約1週間遅れますが重大なリグレッションを含むリリースをスキップします。claude-code@latest は最新チャンネルを追跡し、リリース直後のバージョンを受け取れます。

# 安定チャンネル（推奨）
brew install --cask claude-code

# 最新チャンネル
brew install --cask claude-code@latest

ただし Homebrew 経由の場合は自動更新されないため、インストールしたキャストに合わせて定期的にアップグレードコマンドを実行してバージョンを最新に保ってください。

# claude-code をインストールした場合
brew upgrade claude-code

# claude-code@latest をインストールした場合
brew upgrade claude-code@latest

Linux でのインストール

macOS と同じコマンドで対応しています。

curl -fsSL https://claude.ai/install.sh | bash

Debian や Ubuntu 系のディストリビューションでは apt、Fedora や RHEL 系では dnf によるパッケージマネージャーインストールも利用できます。詳細は公式ドキュメントの「Install with Linux package managers」を参照してください。

Windows でのインストール

Windows はシェルの種類によってコマンドが異なります。PowerShell を使っている場合は次のコマンドを実行します。

irm https://claude.ai/install.ps1 | iex

CMD（コマンドプロンプト）を使っている場合はこちらです。

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

どちらのシェルを使っているかわからない場合は、プロンプトの先頭を確認してください。PS C:\ と表示されていれば PowerShell、C:\ のみであれば CMD です。なお、Windows ネイティブ環境では Git for Windows のインストールも推奨されています。Git for Windows がインストールされていない場合、Claude Code は Bash ツールの代わりに PowerShell をシェルとして使用します。

インストールの確認

インストール後、次のコマンドでバージョン番号が表示されれば正常にインストールされています。

claude -v

認証とログイン

インストールが完了したら、プロジェクトディレクトリに移動して claude コマンドを実行してください。初回起動時にはログインが求められます。

claude

ブラウザが起動し、Claude.ai または Claude Console の認証画面が開きます。お使いのアカウントでログインすると、認証情報がローカルに保存されるため、次回以降はそのまま利用できます。アカウントを切り替えたい場合は、セッション中に /login コマンドを使います。

Claude Console アカウントで初めてログインした場合、Console 内に「Claude Code」ワークスペースが自動的に作成されます。このワークスペースを通じて、組織全体のコスト管理をまとめて行えるようになっています。

最初のタスクを実行してみよう

ログインが完了すると、ウェルカム画面が表示されます。セッション情報や最近の会話、最新情報が確認できます。

まずはコードベースを理解させるところから始めてみましょう。プロンプトに自然言語で入力するだけです。

このプロジェクトは何をするものですか？

Claude はプロジェクト内のファイルを必要に応じて読み込み、構成や概要を説明してくれます。コンテキストを手動で与える必要はありません。

コードベースの理解が進んだら、実際にコードを書いてもらいましょう。

メインファイルに Hello World 関数を追加してください

Claude は対象ファイルを特定し、変更内容を提案した上で、承認を求めてきます。ファイルを直接変更する前に確認を挟んでくれるので、意図しない変更が加わる心配はありません。

Git 操作も自然言語で指示できます。

変更内容にあったコミットメッセージをつけてコミットしてください

変更内容を確認し、適切なコミットメッセージを生成してコミットしてくれます。ブランチの作成やプルリクエストの作成も同様に頼めます。

覚えておきたい基本コマンド

日常的に使うコマンドをまとめておきます。Claude Code には2種類のコマンドがあります。ひとつは Claude Code を起動するときにターミナル（macOS のターミナルや Windows のコマンドプロンプト）から入力する起動コマンド、もうひとつは Claude Code が起動した後の会話画面の中で入力するスラッシュコマンドです。

Claude Code 起動コマンド（ターミナルから入力）

コマンド	説明
claude	インタラクティブモードで起動する
claude "タスク内容"	起動と同時に初期プロンプトを渡す
claude -p "質問"	回答を表示してすぐに終了する（スクリプトや CI 連携向け）
claude -c	同じディレクトリの直近の会話を再開する
claude -r	過去の会話を選んで再開する

スラッシュコマンド（Claude Code の会話画面から入力）

コマンド	説明
/help	利用可能なコマンドの一覧を表示する
/clear	会話履歴をリセットして新しいセッションを始める
/model	使用するモデルを切り替える
exit または Ctrl+D	Claude Code を終了する

ターミナル以外で作業したい場合は、VS Code 拡張機能やデスクトップアプリも選択肢です。VS Code では差分のインライン表示や @ メンションによるファイル参照が使えます。デスクトップアプリでは複数セッションの並行実行やスケジュール実行といった機能も利用できます。

まとめ

Claude Code はターミナルに常駐する AI ペアプログラマーです。コード生成やバグ修正はもちろん、テスト追加・リファクタリング・Git 操作まで、自然言語の指示で一緒に進めてくれます。インストールはネイティブインストーラーの一行コマンドで完了し、Node.js などの事前準備は不要です。

まずは手元のプロジェクトで「このプロジェクトは何をするものですか？」と聞いてみてください。コードベースを読み込んで丁寧に答えてくれるその様子を見ると、「一緒に作業している」という感覚が自然と生まれてきます。この記事がどなたかのお役に立てれば幸いです。

◆　塩野　正人
◆　マネージドサービス部　所属
◆　X（Twitter）：@shioccii
◆　過去記事はこちら

前職ではオンプレミスで仮想化基盤の構築や運用に従事。現在は運用部隊でNew Relicを使ってサービス改善に奮闘中。New Relic User Group運営。