Claude Codeを導入してみたけれど、ターミナルでどう指示を出せばいいのか分からない」
「AIが書いたコードでエラーが出たとき、どう解決すればいいの?」
このような悩みを持っていませんか?
Anthropic社が開発したClaude Codeは、ターミナル(CLI)上で対話しながら、コード生成、ファイル操作、ビルド、テスト実行まで自律してこなす次世代のAIコーディングエージェントです。
1. Claude Code(クロードコード)とは?従来ツールとの違い
Claude Codeは、VS Codeなどのエディタ上でコードを提案する補完ツール(CursorやGitHub Copilotなど)とは一線を画す「自律型開発エージェント」です。
エディタ補完とClaude Codeの違い
| 比較項目 | エディタ補完ツール(Copilot等) | Claude Code(ターミナル型) |
| 操作場所 | エディタ画面(コード編集部) | ターミナル(CLI画面) |
| 操作範囲 | 開いているファイルや周辺コード | プロジェクト全体・複数ファイル一括 |
| コマンド実行 | できない(手動で実行) | AIが自分でnpm testやgitを実行 |
| プロジェクトルールの固定 | 設定ファイルによる補助 | CLAUDE.md でプロジェクト規約を完全学習 |
単にコードを提案するだけでなく、「テストを実行してエラーが出たら自分で修正する」という一連の開発サイクルを自動で回してくれる点が最大の特長です。
2. 【導入タスク】5分で完了するセットアップ手順
まずはClaude Codeを自分のPCで動かせるようにセットアップしましょう。
TASK 1: Node.js環境の確認
Claude Codeを動かすにはNode.js(v18以上)が必要です。ターミナル(MacはTerminal、WindowsはPowerShellまたはWSL)を開き、バージョンを確認してください。
Bash
node -v
表示確認:
v18.x.x以上が表示されればOKです。未アクセスの場合はNode.js公式サイトからLTS版をインストールしてください。
TASK 2: npmでのインストールと起動
以下のコマンドを実行して、Claude Codeをグローバルにインストールします。
Bash
npm install -g @anthropic-ai/claude-code
インストール完了後、開発を行いたいプロジェクトフォルダへ移動して起動します。
Bash
cd my-project
claude
TASK 3: 認証設定
初回起動時にはブラウザが自動的に立ち上がり、Anthropicアカウントでのログイン認証(OAuth認証)が求められます。画面の指示に従って連携を許可すれば準備完了です。
2の補足:Node.jsの必須性について
3. 【操作タスク】基本コマンドと「指示出し(プロンプト)」の黄金パターン
Claude Codeのターミナル対話で頻繁に使用する特殊コマンドと、精度の高い指示(プロンプト)の出し方を押さえましょう。
必須の特殊コマンド一覧
/help: 使用できるコマンドやショートカットの一覧を表示します。/compact: 会話履歴を要約して圧縮します(長時間の作業でコンテキスト・メモリが圧迫された際に有効)。/bug: 発見された不具合や修正箇所のバグ報告を作成します。/clear: 現在の対話セッションをクリアしてリセットします。
精度の高いコードを生成させる「プロンプト黄金パターン」
あいまいな指示を出すとAIは迷ってしまいます。以下の3つの要素を含めて指示を出すのがコツです。
- 目的・対象ファイルの明記
- 使用するライブラリ・技術スタック指定
- テスト実行・動作確認の依頼
プロンプト文面例:
「
src/api/weather.tsを作成し、OpenWeatherMap APIから現在の天気を取得する関数を書いてください。TypeScriptの型定義を厳格に行い、実装後はnpm testを実行して正常に動作するか確認してください。」
4. 【設計タスク】「CLAUDE.md」を作成して精度を10倍にする
Claude Codeをスマートに使いこなす上で最も重要なのが、プロジェクトのルートディレクトリに配置するCLAUDE.mdファイルです。
このファイルを作成しておくと、Claude Codeは毎回起動時にルールを読み込み、プロジェクトの作法に合わせたコードを出力してくれます。
CLAUDE.md テンプレート(コピペして利用可能)
Markdown
# プロジェクト基本ルール
## 技術スタック
- フロントエンド: Next.js (App Router), TypeScript, Tailwind CSS
- テストフレームワーク: Jest, React Testing Library
## コーディング規約
- コンポーネントはすべてアロー関数形式(`const Component = () => {}`)で記述すること
- `any` 型の使用は禁止。必ず明確な型定義または interface を作成すること
- 非同期処理は async/await を使用し、try-catch ブロックでエラーハンドリングを行うこと
## 実行コマンド
- ビルド: `npm run build`
- テスト実行: `npm test`
- リントチェック: `npm run lint`
5. 【実践タスク】Webスクレイピングツールを作ってみよう
ここでは例として、Pythonを使ったWebスクレイピングツールを作成する流れを解説します。
STEP 1: 要件定義と環境構築
ターミナルでClaude Codeに対し、次のように指示を出します。
Plaintext
> PythonのBeautifulSoupとrequestsを使って、指定した技術ニュースサイトから見出し一覧を取得するスクリプトを作成したいです。必要な仮想環境の作成とライブラリのインストールから案内してください。
STEP 2: コード自動生成とテスト実行
Claude Codeが自律的にコマンドを実行し、ファイルを生成します。
Bash
# Claude Codeが自動的に提案・実行するコマンドの例
python -m venv venv
source venv/bin/activate
pip install requests beautifulsoup4
作成された scraper.py に対し、「実際に実行して取得結果を表示してみて」と伝えるだけで、ターミナル上でスクリプトを実行し、エラーがあればその場で自律修正を行います。
STEP 3: エラー解決とリファクタリング
もし「HTMLタグ構造が変わってエラーが出た」場合も、ログをそのまま提示するだけで解決策を出力してくれます。
Plaintext
> 実行時に AttributeError が出ました。エラーログを解析して修正してください。

