Claude Code 入門 — ターミナルから AI とペアプロする

概要

Claude Code は、Anthropic が提供するターミナル常駐型の AI コーディングエージェントです。IDE のチャットパネルとは異なり、シェルから直接起動して「リポジトリを読ませ、変更させ、テストを走らせる」までをエージェント自身に任せられます。

本記事では、インストールから最初のペアプロ、CLAUDE.md によるプロジェクト設定、権限制御、非対話（ヘッドレス）実行までをハンズオン形式で解説します。コマンドやフラグはアップデートで変化するため、正確な仕様は公式ドキュメントを一次情報として確認してください。

環境

• macOS / Linux / Windows(WSL 推奨)
• Node.js（LTS 推奨）
• Anthropic のアカウント
• 既存の Git リポジトリ（変更を巻き戻せるため強く推奨）

セットアップ

インストール

npm 経由でグローバルインストールします。

npm install -g @anthropic-ai/claude-code

バージョンを確認します。

claude --version

起動と認証

プロジェクトのルートで起動します。

cd path/to/your-project
claude

初回はブラウザ経由の認証フローに誘導されます。ログイン後、対話セッションに入れます。

なぜターミナルで動く AI が効くのか

チャット型の AI 支援で最も消耗するのは、人間がコンテキストを手で運ぶ作業です。

• 該当ファイルをコピペする
• ディレクトリ構成を説明する
• エラーログを貼り付ける
• 生成コードを手でファイルに戻す

この往復が積み重なると、AI に頼むより自分で書くほうが速い、という逆転が起きます。根本原因は、AI がファイルシステムやシェルに触れられず、人間が I/O を仲介している点です。

Claude Code は、ファイル探索・編集・シェルコマンド実行・Git 操作をエージェント側のツールとして持ちます。人間は自然言語で目的を伝え、AI が必要なファイルを自分で読み、差分を提案し、承認を得て適用します。

ハンズオン

まずは読ませて理解合わせ

いきなり書かせず、理解させることから始めます。

このリポジトリの構成をざっと説明して。エントリポイントと主要なモジュールはどこ？

ここで的外れなら以降の変更も外れます。最初の要約の精度確認が成否を分けます。

小さな変更を頼む

README にインストール手順のセクションを追加して。既存のトーンに合わせて。

変更はまず差分として提示され、承認して初めてファイルに反映されます。全書き換えが勝手に起きることはありません。

バグ修正のペアプロ

`npm test` が落ちる。原因を調べて直して。テストが通るまで確認して。

エージェントは「実行 → 失敗を読む → 修正 → 再実行」のループを自走します。人間はレビュアーに徹します。

CLAUDE.md でプロジェクトの流儀を固定する

リポジトリのルートに CLAUDE.md を置くと、セッション開始時に読み込まれ、プロジェクト固有の恒久ルールとして扱われます。

# プロジェクトのルール

## コーディング規約
- パッケージマネージャは pnpm を使う（npm は使わない）
- コミット前に必ず `pnpm lint` と `pnpm test` を通す

## ブランチ運用
- main へ直接コミットしない。必ず feature ブランチを切って PR にする

## 出力
- 変更理由を PR の説明に日本語で書く

チーム共有したいルールは Git 管理下の CLAUDE.md に、個人的なメモはローカル専用の設定に分けると運用が安定します。

権限モードを理解する

エージェントがファイルを書き換え、コマンドを実行する以上、権限制御は重要です。

• 基本は「変更・実行のたびに承認を求める」モード
• 信頼できる定型コマンドのみ許可リストに登録して確認を減らす
• 削除・強制 push・外部送信などの破壊的操作は自動許可しない

ヘッドレス（非対話）実行

CI やスクリプトからは単発実行が可能です。

claude -p "CHANGELOG.md に今回の変更点を追記して"

-p（print）で「一度きりの指示 → 標準出力」という使い方ができます。バッチや Git フックと組み合わせて定型作業を自動化できますが、承認が挟まらない構成になりやすいため、権限範囲を絞ることが前提です。

動作確認

1. claude --version でバージョンが表示される
2. リポジトリ内で claude を起動し、「構成を説明して」で妥当な要約が返る
3. 小さな編集を依頼し、差分提示 → 承認 → 反映を確認する
4. git diff で意図した変更のみが入っていることを確認する
5. 破棄したい場合は git checkout -- <file> で戻す

注意点

• 秘密情報: .env や認証情報のあるディレクトリで安易に自動許可しない
• 過信しない: テストが緑でも意図と違う実装はあり得る。差分は必ずレビュー
• Git 前提: 巻き戻せる状態を保つ。未コミットの大変更を一気にやらせない
• 仕様変化: コマンドやフラグは更新される。細部は公式ドキュメントを確認
• 課金: 利用にはアカウント/プランが必要。大きな作業ほど消費が増える

まとめ

Claude Code の本質は「AI をチャット窓ではなく、作業環境そのものに立たせる」ことです。ファイルを読ませ、書かせ、テストを回させ、人間はレビューと意思決定に集中する。Git 管理下で小さな変更から始め、CLAUDE.md に流儀を書き、権限を絞る。この 3 点を押さえれば、ターミナルからの AI ペアプロは十分に実用段階にあります。