ガイド

Claude Code 起動完全ガイド【2026年最新】:インストール・初回認証・起動しないときの対処法まで徹底解説

室谷東吾
監修者室谷東吾(@0x__tom

株式会社MYUUU 代表取締役 / 日本最大級AIコミュニティ「.AI」創設者(累計2,000名超)/ セプテーニ・ホールディングス(電通グループ)と資本業務提携 / 著書「お金を使わず、AIを働かせる『Dify』活用」(ぱる出版、3刷)/ Xフォロワー約2万人

テキトー教師
監修者テキトー教師(@tekitoo_T_cher

.AI 認定講師 / 教育×AIの専門家 / 累計300名以上にAI活用を指導 / 「テキトーに学ぶ」がモットーの実践派講師 / Xアカウント

Claude Code 起動完全ガイド【2026年最新】:インストール・初回認証・起動しないときの対処法まで徹底解説

Claude Codeの「起動」、実はここで詰まる人が多い

室谷室谷
今回はClaude Codeの起動についての話をしましょう。「インストールしたけど動かない」「claudeコマンドが見つからない」というDMが結構来るんですよね・・・
テキトー教師テキトー教師
.AI(ドットエーアイ)のコミュニティでも初回起動でつまずく方、本当に多いです。インストール自体は数分で終わるんですが、ターミナルの操作に慣れていない方だと、そこから先で止まるケースがよくあります。
室谷室谷
MYUUUでも新しくジョインしたメンバーには最初にClaude Codeの環境構築を手伝うんですが、OS別にちょっとずつ違うんですよね。特にWindowsは選択肢が多くて。
テキトー教師テキトー教師
そうですよね。Mac/Linux/Windowsで手順が違うし、Windowsはさらにネイティブ・WSL・Git Bashという選択肢があるので、そこで迷う方が多いですね。

この記事を読めば、環境別の起動手順と、起動しないときの対処法まで全部わかる内容にしていきましょう。

Claude Codeを起動する前に確認すること

Claude Code公式ドキュメントのAdvanced setupページ(インストール要件の確認)(公式サイトより)

動作環境とシステム要件

室谷室谷
まず前提確認から入りましょう。Claude Codeって、どの環境でも動くわけじゃないんですよね。
テキトー教師テキトー教師
公式ドキュメントに動作環境が明記されています。整理すると、こういうスペックが必要です。
項目要件
macOS13.0以上
Windows10 1809以上、またはWindows Server 2019以上
Ubuntu20.04以上
Debian10以上
Alpine Linux3.19以上
RAM4GB以上
プロセッサx64またはARM64
ネットワークインターネット接続必須
室谷室谷
RAMが4GB以上、プロセッサはx64かARM64なので、最近のPCならほぼ問題ないですね。ただネットワーク必須というのは意外と見落とされる。
テキトー教師テキトー教師
そうなんですよ。Claude Codeはローカルで完結するツールじゃなくて、常にAnthropicのAPIと通信する設計なので。

オフライン環境や社内でファイアウォールが厳しい場合は注意が必要です。

必要なプランと料金

テキトー教師テキトー教師
もう一つ重要なのが、Claude Codeはどのプランでも使えるわけじゃないという点ですよね。
室谷室谷
ここ、かなり重要です。無料プランでは使えません。

Claude.aiのProプラン以上が必要です。2026年4月時点の公式料金はこうなっています。
プラン月額Claude Code
Free$0利用不可
Pro$20(年払いで$17)利用可能
Max(5x)$100利用可能
Max(20x)$200利用可能
Team要問い合わせ利用可能
Enterprise要問い合わせ利用可能
テキトー教師テキトー教師
あとはAnthropicコンソール(console.anthropic.com)でAPIキーを使う方法もありますね。企業でAPIを直接叩いているケース。
室谷室谷
Amazon BedrockやGoogle Vertex AI、Microsoft Foundry経由でも使えるので、企業での導入だとそっちのルートも多いですよね。MYUUUではチームメンバーにはProプランを推奨してます。

個人で使うなら最初はProで十分です。
テキトー教師テキトー教師
コミュニティのメンバーさんでも「MaxにしてもProで全然足りてた」という声は多いですよ。ヘビーに使う方や複数のプロジェクトを並行して回している方はMaxが向いていますが、まずはProから始めるのが無難です。

Claude Codeのインストール方法(OS別完全手順)

Claude Codeのインストールフロー:動作環境確認からプラン確認・コマンド実行・認証・起動完了まで

室谷室谷
じゃあ実際のインストール手順に入りましょう。環境別に分けて説明しますね。

Mac・Linux・WSLの場合(ネイティブインストール推奨)

テキトー教師テキトー教師
Mac/Linux/WSLはこのコマンド1行で終わります。これが公式推奨の「ネイティブインストール」です。
curl -fsSL https://claude.ai/install.sh | bash
室谷室谷
これが一番シンプルです。自動更新も有効になるので、毎回手動でアップデートしなくていいのが楽ですね。
テキトー教師テキトー教師
Homebrewを使っている方はこちらでもインストールできます。ただしHomebrewの場合は自動更新が効かないので、アップデートするときは手動コマンドが必要です。
# Homebrewでインストール(Mac向け)
brew install --cask claude-code

# Homebrewでアップデートする場合
brew upgrade claude-code
室谷室谷
Homebrewは管理しているパッケージが多い人には便利ですが、Claude Code単体でいいなら素直にcurlの方がいいと思います。自動更新が効かないのは地味に不便なんですよね。

Windowsの場合

テキトー教師テキトー教師
Windowsは少し複雑です。ネイティブ・WSL2・WSL1の3つの選択肢があります。

まずはどれを選ぶかを整理しましょう。
方式必要なものサンドボックス向いているケース
ネイティブWindowsGit for Windows非対応Windowsネイティブのプロジェクト
WSL2WSL2有効化対応Linuxツールチェーンを使う場合
WSL1WSL1有効化非対応WSL2が使えない場合
室谷室谷
セキュリティやサンドボックスを重視するならWSL2が一番いいですね。
テキトー教師テキトー教師
そうです。コマンド実行の安全性を考えるとWSL2推奨です。

ただ、既存のWindowsプロジェクトがある方はネイティブの方が連携しやすいケースもある。

ネイティブWindowsの場合(PowerShell):

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

ネイティブWindowsの場合(CMD):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
室谷室谷
ここで注意なのが、PowerShellとCMDの見分け方です。プロンプトがPS C:\で始まればPowerShell、C:\だけならCMDです。
テキトー教師テキトー教師
これ、コミュニティのメンバーさんが結構ハマるんですよ(笑)。PowerShellで&&を使うと「トークンセパレーターじゃない」とエラーが出るので、シェルをちゃんと確認してからコマンドを打ちましょう。

WSL2でインストールする場合:

# WSLターミナルを開いてから実行
curl -fsSL https://claude.ai/install.sh | bash
テキトー教師テキトー教師
WSLの場合は、WindowsのPowerShellやCMDではなく、WSLのLinuxターミナルの中でコマンドを実行します。これが混乱するポイントです。
室谷室谷
あと、WindowsネイティブでインストールするときはGit for Windowsが必要です。Gitがない状態でclaude起動しようとすると詰まるので、先にインストールしておくといいです。

WinGetでインストールする場合

テキトー教師テキトー教師
WinGet(Windowsパッケージマネージャー)を使う方法もあります。
winget install Anthropic.ClaudeCode
室谷室谷
ただしWinGetもHomebrewと同様で、自動更新は効きません。アップデートするときはwinget upgrade Anthropic.ClaudeCodeが必要です。

インストールの確認方法

テキトー教師テキトー教師
インストールが完了したら、きちんと動いているか確認します。
# バージョン確認
claude --version

# 環境診断(詳細チェック)
claude doctor
室谷室谷
claude doctorが便利です。インストール・認証・環境の問題を一括診断してくれる。

「起動しない」ときにまずこれを実行するといいですね。

Claude Codeの初回起動と認証手順

室谷室谷
インストールが終わったら、実際にプロジェクトディレクトリに移動して起動します。
# プロジェクトのディレクトリに移動してから起動
cd your-project-directory
claude
テキトー教師テキトー教師
ここで重要なのが、Claude Codeはプロジェクトのルートディレクトリで起動するという点です。どのディレクトリで起動するかで、コードベースの認識範囲が変わります。
室谷室谷
そうです。cdでちゃんとプロジェクトフォルダに移動してからclaudeするのがポイントです。

ホームディレクトリからそのまま起動する人がたまにいるんですが・・・
テキトー教師テキトー教師
プロジェクトの範囲が広すぎてコンテキストウィンドウを無駄に使ってしまうんですよね(笑)。最初はプロジェクトごとにターミナルを開いて、そこから起動する癖をつけると良いです。

認証の手順

テキトー教師テキトー教師
初回起動時はブラウザが開いてログインを求められます。手順はシンプルです。
  1. claudeコマンドを実行
  2. ブラウザが自動で開く(または表示されたURLをブラウザで開く)
  3. Claude.aiアカウント(ProプランまたはMax)でログイン
  4. 認証コードをターミナルに貼り付ける
  5. 完了
室谷室谷
これだけです。一度認証が通れば次回以降はそのまま起動できます。
テキトー教師テキトー教師
Anthropicコンソール(console.anthropic.com)を使う場合もOAuth認証なので、APIキーを手動で設定する必要はないのが嬉しいところです。
室谷室谷
AWS BedrockやGoogle Vertex AI経由で使う企業もあって、その場合は環境変数での設定が必要になりますが、個人で使う分にはclaude.aiアカウントで十分ですね。

デスクトップアプリ版もある

テキトー教師テキトー教師
ターミナルが苦手な方向けに、デスクトップアプリ版も公式で提供されています。
室谷室谷
これ、結構最近充実してきましたよね。macOS版とWindows版があって、GUIでインストールから起動まで完結できる。

ターミナルを使ったことがない方はこちらから入るのもいいかもしれないです。
テキトー教師テキトー教師
デスクトップアプリだと複数セッションを並行して立ち上げたり、差分をビジュアルで確認したりもできますね。ただ実用的な作業はターミナル版の方が柔軟です。

コミュニティの方を見ていると、最終的にはターミナル版に落ち着く方が多い印象です。
室谷室谷
最近の話をすると、Claude Codeのレンダラーが大幅に改善されたんですよ。ターミナル版でもフリッカーが消えて、入力欄が画面下部に固定されて、チャットアプリみたいに使いやすくなってきてますね。
テキトー教師テキトー教師
このアップデートは体験が全然違いますよね。あとWebブラウザ版(claude.ai/code)もあって、こっちはローカルに何もインストールしなくていい。

自分のPCにないリポジトリを触るときや、複数タスクを並行したいときに便利です。

Claude Codeが起動しないときのトラブルシューティング

Claude Code公式トラブルシューティングページ(エラー別の対処法一覧)(公式サイトより)

室谷室谷
ここが一番需要があるセクションだと思います。「起動しない」「claudeコマンドが見つからない」パターンを整理しましょう。
テキトー教師テキトー教師
公式のトラブルシューティングページが充実しているので、まずはclaude doctorを実行して何のエラーかを確認するのが先決です。

command not found: claude が出る場合

室谷室谷
これが一番多いパターンです。インストールは成功しているのに、claudeコマンドが認識されない。
テキトー教師テキトー教師
原因はほぼ確実にPATHの問題です。Claude Codeのインストール先(macOS/Linuxは~/.local/bin/claude、Windowsは%USERPROFILE%\.local\bin\claude.exe)がPATHに含まれていない状態です。

Mac/Linuxの場合(zsh):

# PATHに追加
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 確認
claude --version

Mac/Linuxの場合(bash):

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
室谷室谷
あるいは単純にターミナルを閉じて開き直すだけで解決するケースもあります。インストール時に.zshrc.bashrcに書き込まれているので、新しいターミナルセッションを開けば反映されることが多い。
テキトー教師テキトー教師
「インストールしたけど動かない!」と言ってきたコミュニティのメンバーさんに「ターミナル閉じて開き直してみて」と伝えたら、それで解決したケースが何件もありましたよ(笑)。

ネットワーク関連のエラー

室谷室谷
インストール自体が失敗するパターンもありますね。「TLS/SSLエラー」とか「storage.googleapis.comに接続できない」とか。
テキトー教師テキトー教師
Claude Codeのインストーラーはstorage.googleapis.comに接続するんですよね。日本のネットワークでは基本問題ないですが、会社のファイアウォールや特定のVPN環境だとブロックされることがあります。
室谷室谷
こういう場合の対処法は、プロキシを設定してからインストールする方法です。
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash
テキトー教師テキトー教師
社内プロキシのURLはIT部門に確認する必要がありますが、この設定で通ることが多いですね。

認証エラー(OAuthエラー・403 Forbidden)

テキトー教師テキトー教師
認証まわりのエラーも多いです。「OAuth error: Invalid code」とか「403 Forbidden」が出るケース。
室谷室谷
WSL2でOAuthを使うときに詰まるパターンがありますよね。ブラウザとWSLの間でリダイレクトがうまくいかない。
テキトー教師テキトー教師
WSL2でのOAuth認証エラーの場合は、コールバックURLを手動でターミナルに貼り付ける方法があります。ブラウザでログインした後、リダイレクトされたURLをコピーして、claudeコマンドのプロンプトに入力します。
室谷室谷
「Not logged in or token expired(ログインしていないかトークンが期限切れ)」のエラーが出たときは、もう一度claudeを実行してログインし直すのが手っ取り早いです。

Windowsで「Git Bashが見つからない」エラー

テキトー教師テキトー教師
WindowsネイティブでClaude Codeを使う場合、Git Bashが必要なんですが、パスが通っていないとエラーになりますよね。
室谷室谷
この場合はsettings.jsonに手動でパスを設定できます。
{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}
テキトー教師テキトー教師
Gitのインストール先が異なる場合はパスを合わせてください。Git for Windowsのデフォルトインストール先はC:\Program Files\Gitです。

低メモリのLinuxサーバーでインストールが途中で止まる

室谷室谷
これはローカル開発ではあまり起きないですが、VPSやDockerで使う場合に発生することがある。
テキトー教師テキトー教師
メモリが少ないLinuxサーバーだとインストール中に「Killed」と表示されて止まります。スワップ領域を追加することで解決します。
# 2GBのスワップ領域を追加する例
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
室谷室谷
クラウドVPSでClaude Codeを使う場合は、最低でも4GBのRAMか、スワップを含めて4GB確保できる環境を用意した方がいいですね。

起動後すぐやるべき初期設定

室谷室谷
無事起動したら、最初にやっておくべき設定があります。ここが生産性に直結するんですよね。

claude doctorで環境チェック

テキトー教師テキトー教師
まずclaude doctorを実行して環境の状態を診断しましょう。インストール・認証・設定が全部正常かを一発で確認できます。
claude doctor
室谷室谷
エラーがあればここに表示されるので、起動直後に一回やっておくと安心ですね。

パーミッション設定(確認ダイアログを減らす)

テキトー教師テキトー教師
デフォルトだとほぼ全ての操作で「これを実行してもいいですか?」と確認が出ます。最初のうちは安全側に倒れているんですが、慣れてくると正直面倒です。
室谷室谷
少なくともWeb検索とWebフェッチは許可しておくと、ドキュメント参照が自動でできるようになって生産性が全然違います。

設定ファイルの場所は~/.claude/settings.json(ユーザー全体の設定)か、プロジェクトルートの.claude/settings.json(プロジェクト専用の設定)です。

{
  "permissions": {
    "allow": [
      "WebFetch",
      "WebSearch"
    ]
  }
}
テキトー教師テキトー教師
最小構成はこれです。WebFetchとWebSearchを許可するだけで、体感が大きく変わりますよ。

コミュニティのメンバーさんに「これだけ設定してみてください」と言うと、翌日には「全然違いますね!」という反応が返ってくることが多いです。

完了通知の設定(Hooksで音を鳴らす)

室谷室谷
長いタスクをClaude Codeに任せたまま別の作業をしていると、終わったことに気づかないんですよね。Hooksで音通知を設定しておくと便利です。
{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "afplay /System/Library/Sounds/Glass.aiff"
          }
        ]
      }
    ]
  }
}
テキトー教師テキトー教師
これはMacの場合です。/System/Library/Sounds/にGlass.aiff、Ping.aiff、Pop.aiffなどがあるので好みで変えられます。

Linuxはpaplay /usr/share/sounds/freedesktop/stereo/complete.ogaです。
室谷室谷
MYUUUのメンバーはほぼ全員これ設定してますね。特に30分以上かかる大きなタスクを任せているときに重宝します。

CLAUDE.mdでプロジェクト設定を書く

テキトー教師テキトー教師
起動後すぐやるべき設定の中でも、CLAUDE.mdの作成は特に重要です。
室谷室谷
プロジェクトのルートにCLAUDE.mdというファイルを置くと、Claude Codeが毎回の会話でそれを読み込んでくれます。プロジェクトのルール、使用技術スタック、やってはいけないことなどを書いておけます。
テキトー教師テキトー教師
CLAUDE.mdを書く過程でプロジェクトの構造を整理し直す方が多いんですよ。「書く過程で自分のプロジェクトを理解し直す」のが本当の価値だったりします。

Claude Codeを使うためというより、自分のプロジェクトを俯瞰するきっかけになる。
室谷室谷
それ、面白い視点ですね。確かに「CLAUDE.mdを書いてみてください」と言うと、チームの認識がズレていることに気づくケースも多い。

設定ファイル兼チームドキュメントみたいな役割になるんですよ。

よくある質問

Claude Codeは無料で使えますか?

室谷室谷
使えません。Claude.aiのFreeプランではClaude Codeへのアクセスは含まれていません。

最低でもProプラン(月$20)が必要です。
テキトー教師テキトー教師
ただし、Anthropicコンソール(console.anthropic.com)でAPIキーを使う方法であれば、従量課金で利用できます。使った分だけ払う形なので、少量試すだけならこちらの方が安いケースもあります。

claudeコマンドを実行したら古いバージョンが起動する

室谷室谷
Homebrewやnpmで旧バージョンをインストールしていた場合に起きることがあります。which claudeでどのパスのclaudeが起動しているか確認してみてください。
which claude
# 複数のパスが設定されている場合の確認
type -a claude
テキトー教師テキトー教師
npmでインストールしていた方がネイティブインストールに移行するときのコマンドはこちらです。
# ネイティブバイナリをインストール
curl -fsSL https://claude.ai/install.sh | bash

# 旧npmインストールを削除
npm uninstall -g @anthropic-ai/claude-code

バージョンを固定したい・特定バージョンをインストールしたい

室谷室谷
特定のバージョンにピン留めしたい場合は、インストール時にバージョン番号を指定できます。
# 例: バージョン2.1.89を指定してインストール
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89
テキトー教師テキトー教師
settings.jsonで自動更新チャンネルをstableにしておくと、バグが多いバージョンを掴みにくくなります。latestは最新をすぐ受け取る設定、stableは約1週間遅れの安定版です。
{
  "autoUpdatesChannel": "stable"
}

Claude Code CLIのアップデート方法を教えてください

室谷室谷
ネイティブインストールは自動更新が有効になっているので、基本的に何もしなくても最新版になります。手動でアップデートしたい場合はこれです。
claude update
テキトー教師テキトー教師
HomebrewかWinGetでインストールしている場合は自動更新が効かないので、それぞれbrew upgrade claude-codewinget upgrade Anthropic.ClaudeCodeで更新します。

Claude Codeのリリースノートやアップデート情報はどこで確認できますか?

室谷室谷
公式ドキュメントのChangelogページが一番確実です()。あとは僕のX(@0x__tom)でも随時情報を発信しています。
テキトー教師テキトー教師
大型アップデートはAnthropicの公式ブログでも告知されますね。新機能やパフォーマンス改善は意外とこまめに来るので、チェックしておく価値はあります。

まとめ

室谷室谷
Claude Codeの起動まわりをまとめると、ポイントは3つですね。まず、ProプランかMax以上が必要。

次に、ネイティブインストールが一番シンプル。そして起動しない場合はPATH問題かネットワーク問題がほとんど。
テキトー教師テキトー教師
claude doctorを使いこなすのが近道です。エラーメッセージをそのまま検索するよりも、claude doctorが示す診断結果をもとに対処した方が早い。

コミュニティのメンバーさんには「まずclaude doctorして」と口酸っぱく言ってますよ(笑)。
室谷室谷
インストールと起動が済んだら、次は実際のプロジェクト作業でどう使うか、CLAUDE.mdの書き方、パーミッション設定の深掘り、MCPによる機能拡張といった話にどんどん発展していきます。.AIでもその辺の記事を順次公開していくので、ぜひチェックしてみてください。
テキトー教師テキトー教師
.AIのコミュニティには現役でClaude Codeを使っているメンバーも多いので、「うちではこうやってる」という実践的な知見が毎日交流されていますよ。

出典

.AI TIMES一覧に戻る