メインコンテンツにスキップ

Claude Codeの初日

今日アップデートされました

目標: 約15分で、Claude Codeをインストールし、サインインして、初めてのAI支援による変更を完了します。このガイドは初日に必要な内容のみをカバーしており、より詳しい資料へのリンクは最後に表示されます。


ステップ1: Claude Codeをインストール(2分)

お使いのマシンに合致するコマンドを選択し、ターミナルに貼り付けてください。

セットアップ

コマンド

macOS / Linux / WSL

Windows (PowerShell)

Homebrew

brew install --cask claude-code

npm (Node 18+)

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

ヒント: sudoを使用してnpm installを実行しないでください。これにより、後でファイルのアクセス許可の問題が発生します。

インストールを確認:

claude --version


ステップ2: サインイン(2分)

認証方法は、組織がアクセスをどのようにプロビジョニングしたかによって異なります。以下のいずれかを選択してください:

組織が使用している場合...

実行内容

Claude Enterpriseシート

claudeを実行し、/loginを実行してブラウザでリクエストを承認します(プロンプトが表示された場合はSSOを含む)。これが最も一般的なパスです。

Anthropic Console APIキー

export ANTHROPIC_API_KEY=sk-ant-…を実行し、claudeを実行します。

Amazon Bedrock

export CLAUDE_CODE_USE_BEDROCK=1を実行し、AWSの認証情報を設定してから、claudeを実行します。

Google Vertex AI

export CLAUDE_CODE_USE_VERTEX=1を実行し、GCPの認証情報を設定してから、claudeを実行します。

どの方法が適用されるかが不明な場合は、管理者に確認するか、/loginを最初に試してください。これはほとんどの組織のデフォルトです。


ステップ3: プロジェクトを開く(1分)

cd path/to/your/project claude

Claude Codeはオンデマンドでファイルを読み取るため、アップロードまたは添付する必要はありません。作業したいリポジトリ内から起動するだけです。


ステップ4: 1つの安全ルールを理解する(1分)

Claudeはファイルを変更またはコマンドを実行する前に常に確認を求めます。変更を提案する場合、diffと3つの選択肢が表示されます:

  • はい — この単一の変更を適用します。

  • はい、今後編集について確認しない — セッションの残りの間、ファイル編集を自動承認します。

  • いいえ — 変更を拒否し、理由を説明してください。

いつでもShift+Tabを押してモード間を切り替えることができます(計画 → 編集を受け入れる → デフォルト)。変更が予期しない結果を生成した場合、コミットするまでgitの履歴は変更されないため、git checkoutでそれを元に戻すことができます。


ステップ5: 最初に試す5つのこと

これらをプロンプトに1つずつコピーして貼り付けてください。各例は異なるコア機能を示しています。

1. 方向性を把握する

Give me a 5-bullet summary of what this codebase does and where the entry point is.

これが役立つ理由: Claudeが特定のパスを指定されずに独自にファイルを探索する方法を示しています。

2. 何かを見つける

Where is user authentication handled? Show me the file and the key function.

これが役立つ理由: 正確なシンボルまたはファイル名がわからない場合、grepよりも高速です。

3. 安全な編集を行う

Add a docstring to the function <name> in <file>. Keep it to 2 lines.

これが役立つ理由: 低リスクの変更でdiffを確認および承認する練習ができます。

4. 実際の問題を修正する

This test is failing: <paste the error>. Find the cause and fix it.

これが役立つ理由: これが主要なワークフローです。症状を説明すると、Claudeが調査して修正を提案します。

5. gitを処理させる

Stage my changes and write a commit message that follows our existing style.

これが役立つ理由: Claudeは(承認を得て)gitを実行でき、リポジトリの既存のコミット規約に一致します。


ステップ6: 本日を終了する前に

プロジェクトごとに1回実行してください:

/init

これにより、プロジェクトルートにCLAUDE.mdファイルが生成され、コードベースの規約がキャプチャされます。Claudeはすべてのセッションの開始時に自動的にそれを読み取るため、将来の応答はすでにプロジェクトに合わせてカスタマイズされます。これは実行できる最も価値の高いセットアップステップです。


次のステップ

Claude Codeをインストールし、認証し、編集を行い、プロジェクトメモリをセットアップしました。さらに進む準備ができたら、公式ドキュメントでメモリとCLAUDE.mdスラッシュコマンドインタラクティブモードのショートカットについて詳しく説明しています。

インストールまたはログイン中に問題が発生した場合は、トラブルシューティングガイドを参照してください。

こちらの回答で解決しましたか?