Claude Codeの基本的な使い方｜導入から最初の修正まで

Claude Codeは、terminalや対応IDEからClaudeへcoding taskを任せるagentic coding toolです。

chat画面へcodeを貼る使い方ではなく、Claude Code自身がrepositoryを探索し、必要なfileを読み、修正し、commandを実行できるのが大きな違いです。

最初は「全部任せる」より、小さな修正を一つ通して、どこまで読んで何を変更するかを確認しながら使うのが分かりやすいです。

Claude Codeをinstallする

Anthropic公式はnative installerを推奨しています。OSごとのcommandはsetup guideを確認し、macOS / Linux / WSLでは下記のinstall commandを使います。npm版も利用できますが、global installにはNode.js 22以上が必要です。

macOS / Linux / WSLでnative installerを使う場合の流れは、

curl -fsSL https://claude.ai/install.sh（新しいタブで開く） | bash

cd your-project

claude

です。

Claude CodeはmacOS / Linux / Windowsで利用でき、OS向けsetup guideに従います。認証はPro / Max、Team / Enterprise、Console、またはBedrock / Vertex AIなど対応providerから選びます。Teamでは全seatで利用できます。新規・self-serve Enterpriseでも各Enterprise seatに含まれますが、旧Enterprise契約ではClaude Codeを含むseat種別か管理画面で確認してください。

最初にproject全体を説明してもらう

起動直後からいきなり修正させるより、

「このprojectの構成を確認して、主要directoryと役割を説明して」

のように依頼すると、Claude Codeがどこまでcontextを理解しているか確認できます。

Claude Codeは必要に応じてcodebaseを探索するため、毎回すべてのfileを手動で添付する必要はありません。

小さな修正を一つ依頼する

最初のtaskは、影響範囲が分かりやすいものがおすすめです。

たとえば、

• button labelを変更する

• TypeScript errorを1件直す

• validationを追加する

• READMEを更新する

• failing testの原因を調べる

といった修正です。

「直して」だけではなく、

• 目的

• 変更してよい範囲

• 触ってほしくないfile

• 完了条件

を伝えると、結果を確認しやすくなります。

大きめの変更はplanから始める

大きめのtaskではPlan modeを使うと安全です。

Plan modeではClaudeがcodebaseを分析できますが、file変更やcommand実行は行いません。

まず、

「原因を調べて、変更予定fileと修正方針だけ出して」

と依頼し、その内容を確認してから実装へ進むと、意図しない変更を減らせます。

permissionを確認する

Claude Codeにはtool permissionがあります。

file readのようなread-only操作は自動で進められる一方、shell commandやfile editは設定によってapprovalが入ります。

Claude Code v2.1.283以降では、対話型terminal / VS Codeの組み込み開始modeはAutoです。それ以前のversion、設定、組織policy、model availability、初回起動時の状態によってManualになることがあります。Manualではread-only操作を除き許可を求め、Autoでもclassifier・deny rule・組織設定が働きます。開始modeを決めつけず、画面のmodeとpermission設定を確認してください。

production data、deploy、database migration、destructive commandなどを扱うときは、permission設定と実行内容を必ず確認した方が安全です。

修正後はdiffとtestを見る

Claude Codeが「完了しました」と返しても、それだけで終了しない方がよいです。

最低限、

• git diff

• type check

• lint

• test

• build

のうちprojectに必要なものを確認します。

Claude Code自身に、

「変更点を要約して、実行したtestと未確認項目を分けて」

と依頼する方法も有効です。

IDEからも使える

Claude Codeはterminalだけでなく、VS Code、CursorなどVS Code系editor、JetBrains IDEでも利用できます。

Pro / Maxで同じClaude accountへloginした場合、terminalとIDEのusageは同じ利用枠へcountされます。

普段CursorやVS Codeを使う人は、editor内でClaude Codeを使うworkflowも選べます。

まずは使ってみる

記事の文脈に合うToolへ進めます。報酬の有無で見た目は変えていません。

• 

  Claude Code

  公式サイトを見るTool詳細を見る比較を見る

MCPで外部toolをつなげる

Claude CodeはMCPに対応しています。

Google Drive、Figma、Slack、custom internal toolなど外部sourceを接続し、codeだけでは足りないcontextを取得できます。

ただしMCPはClaude Codeの権限範囲を広げます。

接続できることと、常に接続すべきことは別です。必要なtoolだけを許可し、write actionは特に慎重に扱う方が安全です。

最初の1回はこの流れで十分

初回は、

project確認

→ 小さなtaskを指定

→ plan確認

→ 実装

→ diff確認

→ test

→ commit前に最終確認

という流れで十分です。

agentとしての能力を活かしつつ、人間側が変更範囲を把握しやすいworkflowになります。

最初の修正を安全に通す手順

インストール後は、変更範囲と成功条件を一度に伝えると、出力をレビューしやすくなります。例えば既存のREADME typoを直すなら、次のように依頼します。

「READMEの導入手順にある誤字だけを直してください。対象はREADME.mdです。設定ファイルやコードには触れないでください。変更前に該当箇所と修正案を示し、修正後はdiffを見せてください。テストが必要か判断し、実行した場合は結果と未確認事項を分けてください。」

作業は、依頼→調査結果→変更前の確認→編集→diff確認→必要なtestの順で進めます。Claude Codeが追加のfile変更や依存更新を提案した場合は、最初の依頼に含まれていない理由を聞き、必要性が分からなければ保留します。最初から広い範囲を任せず、1つの小さな変更でpermissionや差分の出方を理解してから対象を広げる方が戻しやすくなります。

完了とみなす条件を先に置く

「動いた」で終えると、どこまで確認したか曖昧になります。taskごとに完了条件を一つ以上決めます。

表は横にスクロールできます

task	完了条件の例	人が確認する点
README修正	指定箇所だけ変更	diffに他のファイルが混ざっていない
bug fix	再現ケースが解消	関連testと副作用
feature	acceptance criteriaを満たす	仕様外の挙動がない
dependency更新	versionと理由が明示	lockfile差分と互換性
command実行	実行内容と結果が報告される	destructive / network操作でないか

終わったら、変更file、実行command、test結果、未確認事項を別々に読みます。testがない小規模taskなら、「testなし」と明示してもらいます。Gitを使うprojectでは、commit前に自分でdiffを確認し、目的外の変更がないことを見てから進みます。この確認はClaude Codeの能力を疑うためではなく、修正の責任範囲を人間が把握するための工程です。

うまく始まらないときの切り分け

起動や認証で止まったら、いきなり再installせず原因を分けます。まずClaude Codeのversionと診断結果を確認し、ログイン画面では選んだaccountが意図したPro / Max、Console、または組織seatかを見ます。Console APIを使う予定がないのにAPI billingが選ばれている場合は、subscriptionで使いたいaccountへ戻します。

表は横にスクロールできます

症状	最初に見る場所	次の対応
commandが見つからない	install完了、shellのPATH、terminal再起動	setup guideのOS別手順とinstall診断を確認
loginできない	network、対応地域、選択したaccount	現在の認証方法に合う公式手順をやり直す
利用枠に達した	/status、同一accountのClaude利用、model	待つ・planを見直す・API追加利用を選ぶ前に請求先を確認
編集やcommandが止まる	permission mode、allow / deny rule、組織設定	作業内容と必要な権限を確認し、範囲を限定

診断結果を共有するときは、token、API key、顧客code、home directoryの個人情報を取り除きます。エラー文をそのまま公開issueへ貼るのではなく、再現に必要な情報だけを残してください。これで「install問題」「account / billing問題」「権限問題」を混ぜずに初回の修正へ進めます。

AIものさしの判断

Claude Codeは「codeを質問するAI」より、「repositoryの中で作業を進めるagent」として使うと強みが分かります。

一方、初回から大規模refactorやproduction操作を丸投げする必要はありません。

小さなtaskから、plan・permission・diff・testを確認する習慣を作る方が、結果的に自動化範囲を安全に広げやすくなります。