blog

Claude Codeのインストール方法|Mac・Windows・Linux対応の手順とエラー対処【2026年10月】

Claude Codeのインストールは、macOS・Linux・WSLならターミナルで curl -fsSL https://claude.ai/install.sh | bash、WindowsのPowerShellなら irm https://claude.ai/install.ps1 | iex を実行するだけです。この公式推奨の方法はNode.js不要で、インストール後に claude と入力すれば起動できます。

Claude Codeは、Anthropicのチャット型AI「Claude(クロード)」をターミナルから使い、ファイルの編集やコマンドの実行まで任せられるコーディング支援ツールです(できることの全体像はClaude Codeとはをご覧ください)。この記事では、どのアカウントで使えるか、ターミナルを使わない入口もあるか、ターミナルの開き方、OSごとのインストール手順、インストール後のログインと動作確認、入れた直後の最初の1件、うまくいかないときの原因別の直し方、アップデートとアンインストールの方法を、入れる人が迷う順に説明します。npmで入れる場合の注意点(Node.js 22以上・権限エラー)は6章にまとめています。

手順は公式ドキュメント(code.claude.com/docs)の内容にもとづき、エラーは「なぜ起きるか・どう直すか」が分かるように原因ごとに整理しました。公式のセットアップガイドとクイックスタートは2026年10月23日に再確認しています。画面と動画は、Claude Code 2.1.296 を入れたLinuxの端末で実際に実行して撮ったものです。

Claude Codeのインストール手順とエラー対処のイメージ


目次

Claude Codeのインストール手順は?(結論)

Claude Codeは、公式が推奨する「ネイティブインストーラー」をターミナルで1行実行するだけでインストールでき、Node.jsは不要です。インストール後に claude を実行し、ブラウザでClaudeのアカウント(Pro・Max・Ultra・Team・Enterpriseの有料プラン、またはConsole)にログインすれば使い始められます(2026年10月16日時点・公式セットアップガイド準拠)。

環境 インストールコマンド(推奨順) 自動更新
macOS・Linux・WSL curl -fsSL https://claude.ai/install.sh | bash あり
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 あり
macOS(Homebrew) brew install --cask claude-code なし(brew upgrade claude-code)
Windows(WinGet) winget install Anthropic.ClaudeCode なし(winget upgrade Anthropic.ClaudeCode)
npm(Node.js 22以上が必要) npm install -g @anthropic-ai/claude-code なし(npm install -g @anthropic-ai/claude-code@latest)
  • 動作環境:macOS 13.0以上/Windows 10 1809以上/Ubuntu 20.04以上、RAM 4GB以上。
  • Windowsの注意:管理者として実行する必要はありません。Git for Windowsを入れておくと、Claude CodeがBashツールを使えます(無い場合はPowerShell経由で動作)。
  • 確認:インストールが終わったら新しいターミナルを開き、claude --version でバージョンが表示されれば完了です。うまく動かないときは claude doctor でインストール状態を診断できます。
  • npmで入れる場合:npmパッケージはNode.js 22以上が必要です。権限エラー(EACCES)が出ても sudo は使わず、nvmなどでユーザー領域にNode.jsを入れ直します(5章)。

インストールが終わって claude と入力すると、初回は次のように、文字の配色の選択からログイン方法の選択へ進みます。

Claude Code を初めて起動したときの流れ(約25秒・音声なし。2026年10月12日に実際に実行して撮影。ウィンドウの枠は描画したもので、表示されている文字は実行結果そのままです)

はじめての依頼で最初に何をすればよいかは、Claude Codeの始め方で解説しています。

関連記事Claude Codeの日常操作の使い方は?

自分のパソコンに入れられる?動作環境と使えるアカウント

公式ドキュメントが示すシステム要件は次のとおりです(出典:code.claude.com/docs/en/setup.md、2026年10月16日確認)。

  • OS:macOS 13.0以上 / Windows 10 1809以上またはWindows Server 2019以上 / Ubuntu 20.04以上 / Debian 10以上 / Alpine Linux 3.19以上
  • ハードウェア:RAM 4GB以上、x64またはARM64プロセッサ
  • Node.js:ネイティブインストーラー・Homebrew・WinGetでは不要。npmでインストールする場合のみNode.js 22以上
  • ネットワーク:インターネット接続が必須(社内プロキシを経由する場合は、インストール前に環境変数 HTTPS_PROXY・HTTP_PROXY にプロキシのアドレスを設定します)
  • アカウント:Pro・Max・Ultra・Team・Enterpriseのいずれかの有料プラン、またはClaude Console(API)のアカウント。無料プランのclaude.aiアカウントでは使えません
  • シェル:Bash・Zsh・PowerShell・CMD のいずれか。対応している国・地域はAnthropicの対応国一覧で確認します(2026年10月23日確認・公式 setup)

どのアカウントで使えるか(料金の目安つき)

インストール自体は無料ですが、起動したあとのログインで、Claude Codeの対象になっているアカウントが要ります。公式のクイックスタートと料金ページ(2026年10月23日確認)の整理は次のとおりです。迷ったら、個人で試すならPro、使う量が多いならMax(さらに多いならUltra)、チームで使うならTeam、使った分だけ払いたいならConsole、が目安です。

アカウント 月額の目安(公式の料金ページ) Claude Codeでの位置づけ
Free(無料のclaude.ai) 無料 Claude Codeは使えません(チャットのみ)
Pro $20(年払いは月あたり実質$17) 個人向けの入口。公式のクイックスタートが「推奨」とする有料プラン(Pro・Max・Ultra・Team・Enterprise)の1つ
Max $100(月払いのみ。Proの5倍の使用量)。上の段階のUltraは$200で、週間の利用量はProの10倍、認証済みアカウントは5時間ごとの上限がありません(旧称 Max 20x。claude.com/pricing、2026年11月1日確認) 使う量が多い個人向け
Team 標準席 $25(年払いは$20)/プレミアム席 $125(年払いは$100)。いずれも1席あたり チームで使う場合。席ごとに契約
Enterprise 組織向け(料金の表記は公式の料金ページを確認) SSOなど組織の管理が要る場合
Claude Console(API) 使った分だけの従量課金(前払いのクレジット) 初回ログインで「Claude Code」ワークスペースが自動で作られ、費用をまとめて見られる
Amazon Bedrock・Google CloudのAgent Platform・Microsoft Foundry 各クラウドの契約に従う 企業がクラウド経由で使う場合。設定は公式の「サードパーティ連携」の手順に従う

プランの比べ方はClaude Codeの料金、APIの単価と試算はClaude Code APIの料金にまとめています。価格は変わるため、契約の前に公式の料金ページで最新の表記を確かめてください。

公式のインストーラーを使うなら、事前の準備はここまでです。npmで入れる場合だけ、先にNode.jsのバージョンを確認します。

node --version   # v22.x.x 以上が返ればOK(npmで入れる場合)
npm --version    # バージョンが表示されればOK
node --version と npm --version を確認し、npm view で Node.js 22以上が必要と表示された画面
Node.jsとnpmのバージョンを確認した画面(2026年11月1日に実際に実行して撮影。スマホで読めるよう40桁の幅で撮影)。3つ目のコマンドで、npmパッケージが求めるNode.jsのバージョン(22以上)も確認できます

Node.jsが入っていない、またはv22未満の場合は、ネイティブインストーラーを使えばNode.jsは不要です。どうしてもnpmで入れたい場合は、6章で説明するnvmかvoltaでNode.jsを入れ直してから進みます。

ターミナルを使わない入口もあります:デスクトップアプリ・VS Code・Web

Claude Codeは、ターミナル(CLI)のほかにも入口があります。公式のクイックスタートは、デスクトップアプリ、VS CodeとJetBrains、Web(claude.ai/code)、Slack、GitHub ActionsなどのCI/CDに広がっていると案内しています(2026年10月23日確認)。どれから入るかは、使う場所で決めます。

入口 インストールするもの アカウント 向く場面
ターミナル(CLI) この記事の1行コマンド(OSごとの手順は5章) Claude Codeの対象のアカウント すべての機能を使う、サーバーや自動化で使う
デスクトップアプリ アプリのインストーラー(macOS・Windows・Linux)。Node.jsやコマンドラインは不要 有料プラン(Pro・Max・Ultra・Team・Enterprise) ターミナルが苦手、画面で差分を見て進めたい
VS Code拡張機能 拡張機能「Claude Code」。ターミナルの claude は別にインストールが必要 Claude Codeの対象のアカウント エディタの中で作業したい
JetBrains IDE 公式のJetBrains向けプラグイン Claude Codeの対象のアカウント JetBrains系のIDEを使っている
Web(claude.ai/code) なし(ブラウザ) 公式の案内に従う 手元に環境がない場面

ターミナルを使うか迷っている場合は、この章の次に、使う入口に合う章へ進みます。ターミナルを選ぶなら、初めての人は4章で開き方を確かめてから5章、デスクトップアプリとVS Codeはこの章の下の説明で始められます。

VS Codeとデスクトップアプリで始める

Claude Codeは、ターミナルのほかにも入口があります。VS Codeを使っている場合は、拡張機能ビューで「Claude Code」を検索して入れると、エディタの中で使えます。拡張機能には本体が同梱されていますが、拡張機能を入れただけではターミナルの claude コマンドは使えません(PATHに追加されないため)。ターミナルでも使うには、この記事の方法でのインストールが別に必要です(出典:troubleshoot-install.md、2026年10月16日確認)。くわしくはClaude CodeをVS Codeで使う方法をご覧ください。

VS Codeの拡張機能ビューで「Claude Code」を検索した画面。一番上に発行元がAnthropicの公式拡張機能「Claude Code for VS Code」が表示されている
VS Codeの拡張機能ビューで「Claude Code」を検索した画面(2026年10月12日に実際に操作して撮影・必要な部分を切り出し)。発行元が Anthropic のものが公式です

VS Codeに入れる手順と、動かないときの最初の確認

  1. Ctrl + Shift + X(Macは Cmd + Shift + X)で拡張機能ビューを開き、「Claude Code」を検索して、発行元がAnthropicのものを Install します(VS Codeは1.94.0以上)。
  2. ファイルを1つ開き、エディターの右上にある Spark アイコンをクリックすると、Claude Codeのパネルが開きます。

入れても動かないときの最初の確認は、10章の「VS Codeで動かないとき」にまとめています。詳しい使い方はClaude CodeをVS Codeで使う方法をご覧ください。

ターミナルに慣れていない場合は、デスクトップアプリから始める方法もあります。公式ドキュメントによると、デスクトップアプリにはClaude Codeが含まれているため、「Code」タブを使うだけなら、Node.jsもコマンドラインのインストールも要りません。ただし、Pro・Max・Ultra・Team・Enterpriseのいずれかの有料プランが必要です(出典:code.claude.com/docs/en/desktop-quickstart.md、2026年10月16日確認)。

  1. macOS(IntelとApple Silicon共通)とWindowsは、公式ページからインストーラーをダウンロードして実行します。Linuxは公式の手順(apt または .deb)で入れます。
  2. アプリを起動して、Anthropicのアカウントでサインインします。
  3. 画面上部の「Code」タブを開き、作業するフォルダを選びます(有料プランでない場合は、ここでアップグレードを求められます)。
  4. やりたいことを入力します。権限モードが Manual のときは、変更の差分と、承認・却下のボタンが表示されます。
ClaudeデスクトップアプリのCodeタブを開いた画面。左にサイドバー、下に入力欄と実行環境・フォルダ・権限モード・モデルの選択が並ぶ(要点の部分を拡大)
デスクトップアプリの「Code」タブ(2026年10月12日にLinux版で実際に起動して撮影・要点の部分を拡大)。下の入力欄の横で、実行環境・フォルダ・権限モード・モデルを選びます

画面つきの手順はClaude Code Desktopとはにまとめています。ターミナルそのものを初めて使う場合は、次の章で開き方とコマンドの貼り付け方を説明します。

はじめてのターミナル:開き方・貼り付け方・操作の基本

ターミナルは、文字でコマンドを入力してパソコンに指示を出す画面です。開くと、点滅するカーソルが表示されます。ターミナルを使ったことがなくてもClaude Codeは使えます(公式 ターミナルガイド、2026年11月1日確認)。次の章のコマンドは、ここで開いた画面に貼り付けて Enter を押すだけです。

1. ターミナルを開く点滅するカーソルが出る2. 1行を貼り付けるEnter で実行(進捗は出ない)3. claude と入力ログインして使い始める
インストールの流れ。2のコマンドはOSごとに違います(次の章)
OS ターミナルの開き方 貼り付け
macOS Cmd + Space でSpotlight検索を開き、Terminal と入力して Enter Cmd + V
Linux Ctrl + Alt + T(多くのディストリビューション)、またはアプリ一覧で「Terminal」を探す Ctrl + Shift + V

ターミナルでの操作の基本

  • マウスでクリックして動かすことはできません。カーソルは矢印キーで動かします。
  • Esc:Claudeが作業している途中で止めます。
  • exit と入力する、または空の入力欄で Ctrl + D を2回押すと、Claude Codeを終了します。
  • /help:使えるコマンドの一覧が出ます。

インストールのコマンドは、実行中に進捗が表示されません。ウィンドウを開いたまま待つと、「Claude Code successfully installed!」と表示されます。エラーが出たときは10章の表で探してください。

【OS別】Mac・Windows・Linuxのインストール手順

インストールから最初の依頼までを、実際の操作画面で76秒に収録しました。音声はありません(2026年10月20日収録・Claude Code v2.1.304・Linux)。0:05 インストール/0:21 作業フォルダで起動/0:30 日本語で頼む/0:48 変更前後の確認

コマンドはどのOSでもほぼ同じですが、つまずきやすい点はOSごとに違います。公式ドキュメントでは、次のようにOSごとのコマンドがまとめられています。

Claude Code 公式ドキュメント「高度なセットアップ」のインストールの項目。macOS・Linux・WSL、Windows PowerShell、Windows CMD のコマンドが並んでいる部分(2026年10月時点・必要な部分を切り出し)
公式ドキュメント「高度なセットアップ」のインストールの項目(出典:code.claude.com/docs/ja/setup・2026年10月12日に撮影した画面から、コマンドの部分を切り出し)

Macにインストールする(macOS 13.0以上)

おすすめは公式のスクリプトです。この方法で入れると、バックグラウンドで自動的に更新されます。

curl -fsSL https://claude.ai/install.sh | bash

Homebrewを使う場合は、brew install --cask claude-code(安定版。通常は約1週間遅れ)か claude-code@latest(最新版)を選べます。ただしHomebrewで入れた場合は自動更新されません。brew upgrade claude-code(@latestを入れた場合は brew upgrade claude-code@latest)を定期的に実行してください。古いバージョンがディスクに残るので、brew cleanup もときどき実行します。配布されている本体には「Anthropic PBC」の署名とAppleの公証が付いており、codesign --verify --verbose ./claude で確認できます(出典:code.claude.com/docs/en/setup.md、2026年10月16日確認)。

Windowsにインストールする(PowerShell/CMD/WinGet)

コマンドは冒頭の表のとおりで、PowerShellは irm ... | iex、CMDは curl ... install.cmd、WinGetは winget install Anthropic.ClaudeCode です。

管理者として実行する必要はありません。WSL 2で使う場合は、WSLのターミナルの中でLinux用のコマンドを実行します。

Windowsで最も多いつまずきは、PowerShellとCMDの取り違えです。行の先頭が PS で始まればPowerShell、始まらなければCMDです(出典:公式 ターミナルガイド、2026年11月1日確認)。

ネイティブ・WSL 2・WSL 1のどれを選ぶか、PATHの設定、Windows特有のエラー(32ビット版PowerShell、Claude Desktopが claude コマンドを横取りする、インストール中のファイルロックなど)は、Claude CodeをWindowsで使う方法(環境の選び方とエラー対処)で詳しく説明しています。

Linuxにインストールする(Ubuntu・Debian・Fedora・Alpine)

Linuxも、おすすめは公式のスクリプトです(自動更新あり)。Ubuntu・Debianでaptの通常の更新に乗せたい場合は、公式の署名つきリポジトリからも入れられます。この場合はClaude Code自身では更新されず、sudo apt update && sudo apt upgrade claude-code で更新します(出典:公式 Advanced setup、2026年10月16日確認)。

# 署名キーの取得(curl・gpg が無ければ先に sudo apt install curl gnupg)
sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
  -o /etc/apt/keyrings/claude-code.asc
# キーの確認(フィンガープリントが 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE になる)
gpg --show-keys /etc/apt/keyrings/claude-code.asc

# リポジトリ(stable)の登録とインストール
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

Fedora・RHELのdnf、Alpineのapkにも同じ署名つきリポジトリがあり、更新はそれぞれ sudo dnf upgrade claude-code、apk update && apk upgrade claude-code です。登録の手順は次のとおりです(出典:公式 Advanced setup、2026年10月23日確認)。どちらも、約1週間遅れの安定版(stable)を配るリポジトリです。最新版(latest)を追う場合は、公式のページにある latest 用のURLに置き換えます。

# dnf(Fedora・RHEL)
sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code

# apk(Alpine)
wget -O /etc/apk/keys/claude-code.rsa.pub \
  https://downloads.claude.ai/keys/claude-code.rsa.pub
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add claude-code

dnfは初回のインストール時に署名キーの確認を求めるので、フィンガープリントが 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE と一致するのを確かめてから承認します。なお、Alpineには bash と curl が最初から入っていないため、公式のスクリプトを使うなら先に apk add bash curl libgcc libstdc++ ripgrep を実行し、settings.json の env に "USE_BUILTIN_RIPGREP": "0" を設定します。

メモリの少ないVPSでは、インストール中に Killed と表示されて止まることがあります(メモリ不足)。対処は10章の表にあります。

ホームフォルダをNFSなどのネットワークストレージに置いて複数の端末から使う場合は、実行中のセッションが本体のファイルを読み続けるため、別の端末の更新や削除でファイルが読めなくなるとセッションが落ちます(Linuxでは Bus error と表示されます)。公式は、本体をローカルのディスクに置き、版ごとにフォルダを分け、自動更新は DISABLE_UPDATES で止めて自前の手順で入れ替えるよう案内しています(出典:公式 Advanced setup、2026年10月23日確認)。

安定版・特定のバージョンを入れる

Windows(PowerShell・CMD)で安定版やバージョン番号を指定するコマンドは、公式の Advanced setup と、Claude CodeをWindowsで使う方法 にまとめています。

ネイティブインストーラーは、チャンネル(latest か stable)またはバージョン番号を指定できます。入れるときに選んだチャンネルが、その後の自動更新の既定になります。stable は約1週間遅れで、大きな不具合のあった版を飛ばします(出典:公式 Advanced setup、2026年10月16日確認)。

# macOS / Linux / WSL:安定版
curl -fsSL https://claude.ai/install.sh | bash -s stable

# バージョン番号を指定する場合は stable の位置に番号を書く(公式の例は 2.1.89)
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

npmでインストールする場合(Node.js 22以上・nvm/volta)

npmでも入れられます。npmパッケージはNode.js 22以上が必要で、入る本体は公式インストーラーと同じネイティブのバイナリです(実行時にNode.jsは使いません)。古いNode.jsでは EBADENGINE の警告が出ますが、公式によるとインストール自体は完了し claude も動きます(出典:公式 Advanced setup、2026年10月16日確認)。権限エラーの原因になるので、sudo は付けません。

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

更新は npm install -g @anthropic-ai/claude-code@latest です。公式は npm update -g を避けるよう案内しています(最初に入れたときのバージョン範囲に縛られ、最新に上がらないことがあるため)。

シェルで npm --version を実行して 12 から始まる番号が出る場合は、公式の「npm 12 でのインストールを修正する」の手順に従ってください(2026年11月1日確認)。

グローバル・ローカル・npxの使い分け

方法 コマンド例 向いている場面と注意点
グローバル(-g) npm install -g @anthropic-ai/claude-code ふだん使い。どのフォルダからでも claude で呼び出せます。システム領域のNode.jsだと権限エラー(EACCES)が起きやすいので、nvmやvoltaで管理したNode.jsで実行します
ローカル npm install @anthropic-ai/claude-code 特定のプロジェクトでバージョンを固定したいとき。claude を直接は使えず、npx経由になります
npx(その都度実行) npx @anthropic-ai/claude-code インストールせずに試したいとき。実行のたびに取得が走るので起動が遅く、ふだん使いには向きません

次の画面は、npxでインストールせずにバージョンを表示した例です。

npx -y @anthropic-ai/claude-code --version を実行して 2.1.316 (Claude Code) と表示された画面
npxでインストールせずに実行した画面(2026年11月1日に実際に実行して撮影)

権限エラー(EACCES)を防ぐ:nvm/voltaでNode.jsを入れる

npmのグローバルインストールがうまくいかない原因の多くは、Node.jsをシステム領域(macOSなら /usr/local/lib、Linuxなら /usr/lib のあたり)に直接入れていることです。この構成で npm install -g を実行すると、書き込み先がroot所有のフォルダになるため、EACCES: permission denied が出ます。sudo npm install -g で無理に通すと、グローバルパッケージがroot所有になって、その後の更新や削除のたびにsudoが必要になり、スクリプトがシステムのファイルを書き換える危険もあります。公式も sudo npm install -g を使わないよう明記しています。

正しい対処は、nvmかvoltaでNode.jsをホームフォルダの下(例:~/.nvm/versions/node/v22.x.x/)に入れることです。ここは自分で読み書きできるので、sudoなしで npm install -g が通ります。

# nvm(macOS / Linux / WSL)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash
# シェルを開き直してから
nvm install --lts && nvm use --lts
nvm alias default lts/*   # 既定を常にLTSに

# volta(macOS / Linux / WSL。Windowsは https://volta.sh のインストーラー)
curl https://get.volta.sh | bash
volta install node@lts

nvmは普及度が高く情報も多い一方、nvm use で切り替えたバージョンにしかグローバルパッケージが入らないため、別のバージョンへ切り替えると claude: command not found になります(プロジェクトに .nvmrc を置いて nvm use で合わせます)。voltaはWSLなしでWindowsにそのまま入れられ、プロジェクトのフォルダへ移動すると自動でバージョンが切り替わります。チーム全員がMacかLinuxならnvm、Windowsをそのまま使うメンバーがいるならvolta、が目安です。npmの権限エラーを根本から避けたいなら、Node.jsが要らないネイティブインストーラーに切り替えるのが最も簡単です。

入れたあとの確認とログイン:claude –version から初回ログインまで

インストールが終わったら、動作確認とログインまでを続けて済ませます。ここで正常に動く状態を確認しておくと、あとで問題が起きたときに原因を切り分けやすくなります。

バージョンの確認と診断コマンドを実行する様子(約13秒・音声なし。2026年10月12日に実際に実行して撮影)

ステップ1:バージョン確認

claude --version
# 2.1.296 (Claude Code) のようにバージョン番号が表示されれば成功

さらに詳しく確認したいときは claude doctor を実行します。インストール方法(nativeなど)、自動更新の状態、設定ファイルの誤りを、セッションを始めずに確認できます。問題がなければ「No installation issues found.」と表示されます。

ターミナルで claude --version を実行して 2.1.296 と表示され、続けて claude doctor を実行して No installation issues found. と表示された画面(ユーザー名の部分はぼかしてある)
claude --version と claude doctor の実行結果(2026年10月12日に実際に実行して撮影・Claude Code 2.1.296・Linux)

command not found が出た場合は、「よくある失敗パターンと原因別の対処法」のPATHの確認に進んでください。

claude doctor を実行して、インストール方法・更新の状態などが表示された画面
claude doctor の先頭10行(2026年11月1日に実際に実行して撮影)。インストール方法(native)、検索機能、自動更新の有無とチャンネル、直近の更新結果を、セッションを開始せずに確認できます

ステップ2:初回ログイン(ブラウザ経由)

claude

初めて起動すると、最初に文字の配色(テーマ)を選ぶ画面が表示されます。矢印キーで選んでEnterキーを押します。あとから /theme で変えられます。

Claude Code を初めて起動したときに表示される、文字の配色(テーマ)を選ぶ画面
初回起動で最初に表示される、配色を選ぶ画面(2026年10月12日に実際に実行して撮影)

続いてログイン方法を選びます。Pro・Max・Ultra・Team・Enterpriseのプランで使う場合は1番目の「Claude account with subscription」、APIの従量課金で使う場合は2番目の「Anthropic Console account」、Amazon Bedrockなどを経由する場合は3番目の「3rd-party platform」を選びます。

Claude Code の初回起動で表示されるログイン方法の選択画面。Claude account with subscription、Anthropic Console account、3rd-party platform の3つが並ぶ
ログイン方法を選ぶ画面(2026年10月12日に実際に実行して撮影)

選ぶとブラウザが開き、ログインを求められます。ログインが終わると認証情報が保存され、次からは claude と入力するだけで始まります。SSHで接続した先などでブラウザが自動で開かないときは、c キーを押すとログイン用のURLがコピーされるので、手元のパソコンのブラウザに貼り付けます。ブラウザにコードが表示された場合は、ターミナルの「Paste code here if prompted」の欄に貼り付けます。ログインに失敗して原因が分からないときは、/logout → Claude Codeを閉じる → claude で起動し直す、の順でやり直すと直ることが多いと公式は案内しています(出典:troubleshoot-install.md、2026年10月16日確認)。

ログインできるアカウントの種類は、前の章の表のとおりです。Consoleのアカウントで初めてログインすると「Claude Code」というワークスペースが自動で作られます。会社がAmazon Bedrock・Google CloudのAgent Platform・Microsoft Foundryを契約している場合は、公式の手順で設定すると、ブラウザでのログインなしで使えます。会社が自前のゲートウェイを用意している場合は、管理者があらかじめURLを設定してあり、/login を実行するとその画面が最初に開きます(出典:Claude Code公式クイックスタート、2026年10月23日確認)。

ステップ3:APIキーでログインを省く(CI/CD・自動実行)

CI/CDや自動化スクリプトでは、環境変数 ANTHROPIC_API_KEY にAPIキーを設定すると、ブラウザでのログインを省けます。APIキーはClaude Console(platform.claude.com)で発行します。

# 一時的に設定する場合
export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx
claude -p "こんにちは"   # 応答が返れば、キーで認証できています

# 毎回設定されるようにする場合は ~/.bashrc または ~/.zshrc に追記
echo 'export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx' >> ~/.bashrc
source ~/.bashrc

GitHub ActionsやGitLab CIでは、リポジトリのSecrets機能でキーを管理し、ワークフローの環境変数として渡します。APIキーをコードに直接書かないでください。

ステップ4:動作テスト

mkdir ~/claude-test && cd ~/claude-test
git init
echo "# Test" > README.md
claude

初めて開くフォルダでは、そのフォルダを信頼するかどうかの確認が表示されます。自分で作ったフォルダなら「Yes, I trust this folder」を選びます。入力欄が表示されたら、「このフォルダのファイル一覧を教えて」のような簡単な指示を送り、応答を確認します。ファイルの読み書きまで動けば、使える状態です。

Claude Code を初めて開くフォルダで表示される確認画面。Quick safety check と出て、No, exit と Yes, I trust this folder の2択が並ぶ
初めて開くフォルダで表示される、信頼するかの確認画面(2026年10月14日に実際に実行した画面の文言をそのまま書き起こし、スマホで読めるよう描き直したもの・Claude Code 2.1.296・Linux)。矢印キーで「Yes, I trust this folder」に合わせてEnterを押します

ログアウト・アカウントの切り替え・APIキーとの優先順位

ログインし直したいときや、別のアカウントに切り替えたいときは、入力欄で /logout を実行します。ログアウトすると初回起動のセットアップ状態もリセットされるため、次に claude を起動すると、ログインと初期設定からやり直しになります。ログインの有効期限が近づくと、起動時に「run /login to renew」と案内が出るので、/login で更新します。

仕事用と個人用のように、2つのアカウントを同時にログインしたままにしたいときは、環境変数 CLAUDE_CONFIG_DIR でアカウントごとに設定フォルダを分けます。~/.bashrc や ~/.zshrc に次のエイリアスを書くと、claude-work では仕事用、claude では個人用のアカウントで起動できます。

alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'

ログイン情報は、Linuxでは ~/.claude/.credentials.json、Windowsでは %USERPROFILE%\.claude\.credentials.json に保存されます(macOSはキーチェーン)。CLAUDE_CONFIG_DIR を指定したときは、そのフォルダの下に保存されます。

注意したいのは、ANTHROPIC_API_KEY を環境変数に設定している場合です。サブスクリプション(Pro・Max・Ultraなど)のログインがあっても、起動時に「このキーを使うか」と聞かれて承認すると、APIキーのほうが使われます。キーが無効になっている組織のものだと、認証エラーの原因になります。サブスクリプションに戻したいときは unset ANTHROPIC_API_KEY を実行し、/status でどちらが使われているかを確認します(出典:code.claude.com/docs/en/authentication.md、2026年10月16日確認)。

ログイン後の使い方全般は Claude Codeの使い方|導入から活用まで で詳しく説明しています。スラッシュコマンドの一覧は Claude Code スラッシュコマンド をご覧ください。

入れた直後の最初の1件:質問から小さな変更の承認まで

動作確認が済んだら、自分のプロジェクトのフォルダで最初の1件を頼みます。流れは公式のクイックスタート(2026年10月23日確認)の最初の4ステップと同じで、質問 → 小さな変更 → 差分の承認 → Gitの操作の順に進めます。公式の例は英語ですが、日本語の依頼でもそのまま使えます。画面つきで1つずつ進めたい場合はClaude Codeの始め方をご覧ください。

  1. フォルダで起動する:cd でプロジェクトのフォルダに入り、claude を実行します。初回はログインと、フォルダを信頼するかの確認が出ます。
  2. まず質問する:「このプロジェクトは何をするものですか」「メインの入口はどこですか」「フォルダ構成を説明して」のように、読むだけで済む依頼から始めます。Claudeは必要なファイルを自分で読むので、手でファイルを渡す必要はありません。
  3. 小さな変更を頼む:「メインのファイルにhello worldの関数を足して」のような小さな依頼にします。変更の前に確認が出たら、内容を読んで「Yes」で承認します。
  4. Gitも話しかけで操作する:「変更したファイルを教えて」「分かりやすいメッセージでコミットして」「新しいブランチを作って」のように頼めます。

どこまで確認なしで進めてよいかは、セッションごとの権限モードで決まります。Shift+Tab を押すと、使っているセッションの権限モードを切り替えられます。最初は、変更の前に必ず確認が出る状態のままにしておくのが安全です。権限の考え方はClaude Codeの権限設定にまとめています。

ターミナルで打つコマンド 動き 例
claude 対話モードを始める claude
claude "依頼" 最初の依頼つきで対話モードを始める claude "ビルドエラーを直して"
claude -p "質問" 1回だけ答えて終わる claude -p "この関数を説明して"
claude -c このフォルダで直近の会話を続ける claude -c
claude -r 過去の会話を選んで再開する claude -r
入力欄で使うコマンド 動き メモ
/help 使えるコマンドの一覧を出す 迷ったらまずここ
/clear 会話の履歴を消して白紙にする 話題を変えるとき
/resume 前の会話を続ける claude -r と同じ目的
/exit(または Ctrl+D を2回) 終了する

公式が初心者向けに勧めているコツは3つです。具体的に頼む(「バグを直して」でなく、どの画面でどうなる不具合かまで書く)、手順に分けて頼む(テーブル作成 → API → 画面、の順)、先に調べさせる(変更の前に「データベースの構造を分析して」と頼む)。毎日の回し方はClaude Codeの使い方で続けて説明しています。

最初に整えておく設定:CLAUDE.md と許可のルール

インストールとログインが済んだら、次の設定を済ませておくと使いやすくなります。どれもClaude Codeの入力欄で「/」から始まるコマンドを実行するだけです。

やること コマンド 内容
プロジェクトの説明書を作る /init 作業するフォルダで実行すると、Claudeがプロジェクトを調べて CLAUDE.md(毎回読み込まれる指示書)の下書きを作ります。使う言語やテストの実行方法、守ってほしいルールを書いておきます
今の状態を確認する /status バージョン・使っているモデル・ログイン中のアカウント・接続の状態を確認できます
モデルを選ぶ /model 使うモデルを切り替えます。迷ったら最初の設定(既定)のままで問題ありません
許可のルールを決める /permissions どのコマンドを確認なしで実行してよいか、何を禁止するかを設定します
改行キーを設定する /terminal-setup VS Codeのターミナルなどで、Shift+Enterで改行できるようにします(設定が必要なターミナルでだけ表示されます)
表示や動作を変える /config テーマや自動更新のチャンネルなどの設定画面を開きます
使えるコマンドを見る /help コマンドとショートカットの一覧を表示します

次の表は、入力欄で /help を実行したときに表示される内容です。よく使うショートカットが一覧で表示され、画面上のタブを切り替えるとコマンドの一覧も見られます。

/help を実行すると、ショートカットの一覧が表示されます(2026年10月12日に実際に実行した画面の内容を、スマホでも読めるよう表にしました。Escで閉じます)。

入力 動き
! シェルモード
/ コマンドの一覧
@ ファイルのパスを入れる
/btw 横道の質問
Esc を2回 入力を消す
Shift + Tab 変更の自動承認に切り替える
Ctrl + o 詳細な出力
Ctrl + t タスクの表示を切り替える
\ + Enter 改行
Ctrl + v 画像を貼り付ける
Alt + p モデルを切り替える
Ctrl + s 入力中の文を退避する
Ctrl + g $EDITOR で編集する
/keybindings ショートカットの設定

CLAUDE.md を置く場所と書き方

CLAUDE.md は、置く場所によって効く範囲が変わります(出典:code.claude.com/docs/en/memory.md、2026年10月16日確認)。起動したフォルダと、その上のフォルダにあるCLAUDE.mdは、起動時にまとめて読み込まれます。

種類 置く場所 効く範囲
プロジェクト用 ./CLAUDE.md または ./.claude/CLAUDE.md そのプロジェクトで作業する全員(Gitで共有する)
個人用(全プロジェクト) ~/.claude/CLAUDE.md 自分だけ・すべてのプロジェクト
個人用(そのプロジェクトだけ) ./CLAUDE.local.md(.gitignore に追加する) 自分だけ・そのプロジェクト

たとえば CLAUDE.md には、次のような内容を短く書きます(見本)。

# プロジェクトの概要
- Next.js と TypeScript で作っている社内向けの予約システム

# よく使うコマンド
- テスト: npm test
- 起動: npm run dev

# ルール
- 変更の前に、どのファイルを直すかを説明する
- .env は読まない・書き換えない
作業フォルダに CLAUDE.md を置いて、ls -a と cat で中身を確認した画面
作業フォルダに CLAUDE.md を置いた状態(2026年11月1日に実際に作って撮影。内容は上の見本を短くしたもの)。/init で作った下書きも、このようにフォルダ直下の1ファイルになります

許可のルールを settings.json に書く(公式の見本)

毎回の確認を減らしたいときは、/permissions で決めるか、settings.json に permissions を書きます。次は公式ドキュメントの見本で、npmのスクリプトとgit commitは確認なしで実行し、git push は禁止し、.env の読み取りも禁止する例です。

{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(git commit *)"
    ],
    "deny": [
      "Bash(git push *)",
      "Read(./.env)"
    ]
  }
}

ルールは「deny(禁止)→ ask(確認)→ allow(許可)」の順に判定され、最初に当てはまったものが採用されます。そのため、広い deny のルールがあると、狭い allow のルールを書いても例外にはなりません。書く場所は3つあります。プロジェクトで共有するなら .claude/settings.json、自分だけなら .claude/settings.local.json、すべてのプロジェクトに効かせるなら ~/.claude/settings.json です。確認の画面で「Yes, and don’t ask again」を選ぶと、ルールが自動で .claude/settings.local.json に保存されます(出典:code.claude.com/docs/en/permissions.md、2026年10月16日確認)。

うまくいかないとき:エラーの文言から原因と直し方を探す

公式トラブルシュートページ(code.claude.com/docs/en/troubleshoot-install.md、2026年10月16日確認)をもとに、原因ごとに整理しました。エラーの文言が分かっているときは、まずこの表で探してください。

エラー・症状 原因 直し方
インストールのコマンドを実行したあと、画面に何も出ず止まって見える インストール中は、ダウンロードの進捗が表示されない作りになっている 終わるまで待つ。プロンプトが戻ったら、新しいターミナルを開いて claude --version でバージョンを確認する(出典:公式 setup、2026年10月23日確認)
command not found: claude/'claude' is not recognized インストール先がPATHに入っていない。または複数の入れ方が混在している 新しいターミナルを開き直す。それでも出なければ次の「詳細対処」でPATHを追加する
syntax error near unexpected token '<'(bash)/iex が大量のエラー(PowerShell) スクリプトではなくHTMLページをダウンロードしている(社内プロキシやネットワークの制限) 環境変数 HTTPS_PROXY・HTTP_PROXY にプロキシを設定してやり直す。分からなければ情報システム部門にプロキシのURLを確認する
403/ETIMEDOUT/ECONNREFUSED プロキシやファイアウォールが downloads.claude.ai をブロックしている。または対応していない国・地域からのアクセス プロキシの設定(上と同じ)。App unavailable in region の場合は対応国の一覧を確認する
Linuxで Killed と出て中断(exit code 137) メモリ不足(OOM Killer)。インストールには約512MBの空きメモリが要る。小さなVPSで起きやすい 2GBのスワップを作って有効にし、やり直す:sudo fallocate -l 2G /swapfile → sudo chmod 600 /swapfile → sudo mkswap /swapfile → sudo swapon /swapfile
TLS connect error/SSL/TLS secure channel OSのCA証明書が古い OSのCA証明書を更新する(例:sudo update-ca-certificates)
permission denied(ネイティブインストーラー) ~/.local/bin や ~/.claude に書き込めない test -w ~/.local/bin で確認し、書き込めなければ sudo chown -R $(whoami) ~/.local で自分の所有にする
EACCES: permission denied(npm) npmのグローバルフォルダがroot所有(システム領域のNode.jsを使っている) nvmまたはvoltaでNode.jsを入れ直す(6章)。sudo npm は使わない。ネイティブインストーラーに切り替えてもよい
EBADENGINE の警告(npm) Node.jsが22未満 公式によると警告だけでインストールは完了し claude も動く。消したければNode.jsを22以上にする
claude native binary not installed(npm) npmの任意依存(–omit=optional 等)やpostinstallが無効で、本体のバイナリが入っていない --omit=optional・--ignore-scripts を外して入れ直す。または node node_modules/@anthropic-ai/claude-code/install.cjs を実行する
Windows PowerShellで running scripts is disabled on this system(npm) npmが作る claude.ps1 がPowerShellの実行ポリシーで止められている(PowerShellのインストーラー版には影響しない) Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser を実行するか、claude.cmd を使う。PowerShellのインストーラーに切り替える方法もある
dyld: cannot load/dyld: Symbol not found/built for Mac OS X 13.0(macOS) macOSのバージョンが、Claude Codeの対応(13.0以上)より古い Appleメニューの「このMacについて」でバージョンを確認し、13.0より古ければソフトウェアアップデートで更新する
'irm' is not recognized PowerShellではなくCMDで実行している PowerShellを開き直す(Win + X → Windows PowerShell)。またはCMD用のコマンド(curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd)を使う

command not found の詳細対処

インストールは成功しているのに claude コマンドが見つからない場合は、原因はPATHの設定か、複数の入れ方(ネイティブ・npm・古いローカル版)が混在しているかのどちらかです。まず、次のようにインストール先とPATHを確認します。

which claude でインストール先を確認し、PATHに .local/bin が入っていることを確認した画面
which claude でインストール先を、PATHの一覧から local/bin を含む行を確認した画面(2026年11月1日に実際に実行して撮影。ホームフォルダは ~ に置き換えて表示)。ネイティブインストールの場合、~/.local/bin がPATHに入っていれば claude が見つかります
# 本体があるか(ネイティブ版は ~/.local/bin/claude)
ls -la ~/.local/bin/claude

# PATH に ~/.local/bin が入っているか(何も出なければ入っていない)
echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

# 複数の claude が入っていないか
which -a claude
npm -g ls @anthropic-ai/claude-code 2>/dev/null

which -a claude に2つ以上の場所が出る場合は、入れ方が混在しています。公式はネイティブ版を残して、npm版は npm uninstall -g @anthropic-ai/claude-code で外すことを勧めています。nvmで複数のNode.jsを使っている場合は、nvm use で切り替えたバージョンにしかnpm版が入っていないため、インストールしたバージョンに戻す(例:nvm use 22)か、どのバージョンでも動くネイティブ版に切り替えます。

PATHにインストール先を追加する

ネイティブインストールの claude は、macOS・Linuxでは ~/.local/bin、Windowsでは C:\Users\(名前)\.local\bin に入ります。インストーラーはこの場所がPATHに無いと「Setup notes:」として知らせますが、PATHを書き換えることはしないので、自分で1行追加します。使っているシェルに合わせて、zshなら ~/.zshrc、bashなら ~/.bashrc に追記します(出典:troubleshoot-install.md、2026年10月16日確認)。

# zsh(macOSの既定)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# bash(Linuxの多くで既定)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# npm版の場合は、グローバルの bin を追加する(npm bin -g は廃止。prefix に /bin を付ける)
export PATH="$PATH:$(npm prefix -g)/bin"

Windows(PowerShell)では、まずインストール先がPATHに入っているかを確認し、何も表示されなければユーザーのPATHに追加して、ターミナルを開き直します。Windows特有のエラー(Claude Desktopが claude コマンドを横取りする、32ビット版PowerShellなど)はWindows向けの記事にまとめています。

$env:PATH -split ';' | Select-String '\.local\\bin'

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

VS Codeで動かないとき

まず次の2点を確認してください。(1) Spark アイコンが出ない場合は、フォルダを開いただけでなくファイルを開いているか、VS Codeが1.94.0以上か、コマンドパレットの「Developer: Reload Window」で再読み込みしたかを見ます。(2) それでも出ないときは、Cline・Continueなど他のAI拡張機能を一時的に無効にし、ワークスペースを信頼しているか(制限モードでは動きません)を確認します(出典:公式 VS Code ドキュメント、2026年11月1日確認)。詳しい使い方と、ほかのつまずきはClaude CodeをVS Codeで使う方法にまとめています。

更新するには?やめるには?アップデートとアンインストール

更新と削除の方法は、インストールした方法によって違います。自分がどの方法で入れたか分からないときは、claude doctor を実行するとインストール方法が表示されます。

入れ方 アップデート アンインストール
ネイティブインストーラー 自動で更新される。すぐ更新したいときは claude update ~/.local/bin/claude と ~/.local/share/claude を削除
Homebrew brew upgrade claude-code brew uninstall --cask claude-code(claude-code@latest を入れた場合は brew uninstall --cask claude-code@latest)
WinGet winget upgrade Anthropic.ClaudeCode winget uninstall Anthropic.ClaudeCode
apt(Debian・Ubuntu) sudo apt update && sudo apt upgrade claude-code sudo apt remove claude-code(リポジトリの設定 /etc/apt/sources.list.d/claude-code.list と /etc/apt/keyrings/claude-code.asc も削除)
dnf(Fedora・RHEL) sudo dnf upgrade claude-code sudo dnf remove claude-code(/etc/yum.repos.d/claude-code.repo も削除)
apk(Alpine) apk update && apk upgrade claude-code apk del claude-code(/etc/apk/repositories の該当行と /etc/apk/keys/claude-code.rsa.pub も削除)
npm npm install -g @anthropic-ai/claude-code@latest npm uninstall -g @anthropic-ai/claude-code

ネイティブ版のアップデート(自動更新の仕組みと止め方)

claude update を実行して Claude Code is up to date (2.1.316) と表示された画面
claude update を実行した画面(2026年11月1日に実際に実行して撮影)。すでに最新のときは「Claude Code is up to date」と表示されます

ネイティブインストーラーで入れたClaude Codeは、起動時と実行中に定期的に更新を確認し、バックグラウンドで新しい版を入れます(次に起動したときに切り替わります)。今すぐ更新したいときは claude update を実行します。更新されると「Successfully updated from …」、すでに最新なら「Claude Code is up to date」と表示されます。

自動更新を止めたい場合は、settings.json の env に "DISABLE_AUTOUPDATER": "1" を設定します(この場合も claude update での手動更新はできます)。約1週間遅れで安定した版だけを受け取りたい場合は、/config の「Auto-update channel」か、設定 autoUpdatesChannel を "stable" にします。HomebrewとWinGetで入れた場合は、環境変数 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE を 1 にすると、新しい版が出たときにClaude Codeが更新コマンドを代わりに実行します(出典:公式 Advanced setup、2026年10月16日確認)。

アンインストールと、設定ファイルの削除

# ネイティブ版(macOS / Linux / WSL)
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

# ネイティブ版(Windows PowerShell)
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

# npm版
npm uninstall -g @anthropic-ai/claude-code

# 設定・認証トークン・セッション履歴も消す場合(macOS / Linux / WSL)
rm -rf ~/.claude
rm -f ~/.claude.json

どの方法で入れた場合も、本体を削除するだけでは設定ファイルが残ります。~/.claude と ~/.claude.json を削除すると、設定・許可したツール・MCPサーバーの設定・セッション履歴がすべて消える点に注意してください。VS Codeの拡張機能やデスクトップアプリも同じ ~/.claude/ に書き込むため、それらが残っているとフォルダは作り直されます。プロジェクトごとの設定(そのフォルダの .claude と .mcp.json)は別なので、消したい場合は各プロジェクトのフォルダで削除します。

料金とプランの詳細は Claude Code 料金 と Claude Code API料金 をご覧ください。ほかのAIコーディングツールとの比較は Claude Code vs Cursor と Claude Code vs Codex にまとめています。フックによる拡張は Claude Code hooks で説明しています。

Claude Code・AIエージェントの業務導入をご検討の方は、自社での開発実例を公開しているクリスタルメソッドの無料相談をご利用ください。

チームや複数台で使うときの決まり(公式の揃え方と、クリスタルメソッドの場合)

複数人・複数台で使うときは、1台への入れ方そのものより、「全員の版と設定をどう揃えるか」のほうが運用では効いてきます。公式ドキュメントにある、揃えるための設定は次のとおりです(出典:公式 Advanced setup、2026年10月16日確認)。

目的 設定 書く場所
全員を安定版に揃え、古い版へ戻らないようにする "autoUpdatesChannel": "stable" と "minimumVersion": "2.1.100"(下限の版。例は公式の値) settings.json。組織全体に強制するなら管理者が配る managed settings
自社で配った版に固定する(手動更新も止める) 環境変数 DISABLE_UPDATES(DISABLE_AUTOUPDATER は自動更新だけを止め、claude update は残る) settings.json の env
社内プロキシを通す HTTPS_PROXY・HTTP_PROXY にプロキシのアドレス インストール前に環境変数として設定
WindowsでGit Bashの場所を固定する "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe" settings.json の env

クリスタルメソッドでは、Claude Codeを複数の端末で並列に動かして、SEO対策とアプリケーション開発に使っています。そこで決めている運用は次の2点です。

  • npmの権限エラーは、端末ごとの設定変更で直さない。システム全体のnpm設定を書き換えるのではなく、nvmやvoltaでNode.jsをユーザー領域に閉じる構成に統一しています。sudoなしでグローバルインストールできるので、端末ごとに権限の設定がばらつきません。Node.jsが不要なネイティブインストーラーに揃えるのも、同じ理由で有効です。
  • Windowsは、ファイルの読み書きが多い作業ならWSL 2側にプロジェクトを置く。ネイティブ実行とWSL 2の両方を試した範囲では、Windows側のマウントパス(/mnt/c 配下)で直接作業するより、WSL 2のLinuxファイルシステム内(/home 配下)に置いたほうが、応答が安定する傾向がありました。

よくある質問(Claude Codeのインストール)

Q. Claude Codeはnpmでインストールできますか?

A. できます。コマンドは npm install -g @anthropic-ai/claude-code で、npm版はNode.js 22以上が必要です。ただし公式が推奨するのはNode.jsを使わないネイティブインストーラーで、macOS・Linux・WSLは curl -fsSL https://claude.ai/install.sh | bash、Windows PowerShellは irm https://claude.ai/install.ps1 | iex の1行で入ります。npm版がダウンロードするのも同じネイティブのバイナリで、更新は npm install -g @anthropic-ai/claude-code@latest です(npm update -g では最新に上がらないことがあります)。

Q. Windowsにはどうやってインストールしますか?

A. PowerShellなら irm https://claude.ai/install.ps1 | iex、コマンドプロンプト(CMD)なら curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd を実行します。管理者として実行する必要はありません。winget install Anthropic.ClaudeCode でも入ります。WSL 2で使う場合は、PowerShellではなくWSLのターミナル内でLinux用のコマンドを実行します。Git for Windowsは任意ですが、入れておくとBashツールが使えます。

Q. インストールしたのに「claude: command not found」と出るのはなぜですか?

A. まず新しいターミナルを開き直して claude –version を実行してください。それでも見つからない場合は、インストール先がPATHに入っていません。ネイティブ版は ~/.local/bin、npm版は npm prefix -g の直下の bin がインストール先なので、~/.bashrc や ~/.zshrc に export PATH=”$HOME/.local/bin:$PATH” のように追記して読み込み直します。原因の切り分けには claude doctor が使えます。

Q. インストールは無料ですか?どのアカウントが必要ですか?

A. インストール自体は無料ですが、利用にはPro・Max・Ultra・Team・EnterpriseのいずれかのプランまたはConsole(API)アカウントが必要で、無料プランのclaude.aiアカウントではClaude Codeは使えません。インストール後に claude を起動するとブラウザでログインを求められます。ANTHROPIC_API_KEY を設定している場合はAPIキーでの利用も可能です(出典:Claude Code公式ドキュメント「Advanced setup」)。

Q. Claude CodeのインストールにNode.jsは必要ですか?

A. 公式が推奨するネイティブインストーラー、Homebrew、WinGetで入れる場合は不要です。npmで入れる場合だけNode.js 22以上が要件になっています。

Q. Claude Codeをアップデートするにはどうすればいいですか?

A. ネイティブインストーラーで入れた場合は自動で更新されます。すぐに更新したいときは claude update を実行します。Homebrewは brew upgrade claude-code、WinGetは winget upgrade Anthropic.ClaudeCode、npmは npm install -g @anthropic-ai/claude-code@latest で更新します。

Q. Claude Codeをアンインストールするにはどうすればいいですか?

A. ネイティブ版は、macOS・Linux・WSLなら ~/.local/bin/claude と ~/.local/share/claude を削除します。npm版は npm uninstall -g @anthropic-ai/claude-code です。設定や履歴も消す場合は ~/.claude と ~/.claude.json を削除しますが、設定・許可したツール・MCPサーバーの設定・セッション履歴がすべて消えます。

Q. ターミナルを使ったことがなくても、Claude Codeは始められますか?

A. 始められます。ターミナルを使わずに始めたい場合は、公式のデスクトップアプリ(macOS・Windows・Linux)があり、「Code」タブならNode.jsやコマンドラインのインストールは要りません(有料プランが必要です)。ターミナルで使う場合も、公式にターミナルの開き方とコマンドの貼り付け方を説明した「ターミナルガイド」があります。

Q. Windowsで「The token ‘&&’ is not a valid statement separator」や「’irm’ is not recognized」と出るのはなぜですか?

A. 開いている画面とコマンドの種類が合っていません。「&&」のエラーは、PowerShellでCMD用のコマンドを実行したときに出ます。「’irm’ is not recognized」のエラーは、CMDでPowerShell用のコマンドを実行したときに出ます。画面の先頭が「PS C:\」で始まればPowerShell(irm … | iex を使う)、「PS」が付かない「C:\」ならCMD(curl … install.cmd を使う)です。

Q. Claude Codeのログアウトやアカウントの切り替えはどうしますか?

A. 入力欄で /logout を実行します。次に claude を起動すると、ログインと初期設定からやり直しになります。2つのアカウントを同時に使いたいときは、環境変数 CLAUDE_CONFIG_DIR でアカウントごとに設定フォルダを分けます。ANTHROPIC_API_KEY を設定して承認していると、サブスクリプションのログインよりAPIキーが使われる点に注意してください。

Q. WindowsではネイティブとWSL 2のどちらで入れればよいですか?

A. Windowsのプロジェクトやツールを扱うならネイティブWindows、Linuxのツールチェーンを使う場合やサンドボックスでコマンドを実行したい場合はWSL 2、というのが公式の整理です。サンドボックスに対応しているのはWSL 2で、ネイティブWindowsとWSL 1は非対応です(2026年10月23日確認・公式 setup)。ネイティブはPowerShellかCMDで、WSLはWSLのターミナルの中で、それぞれ別のコマンドを実行します。

Q. インストールしたあと、最初に何を頼めばよいですか?

A. 自分のプロジェクトのフォルダで claude を起動し、「このプロジェクトは何をするものですか」のような読むだけの質問から始めてください。慣れたら、小さな変更を1つ頼み、確認の画面で内容を読んでから承認します。Shift+Tab で権限モードを切り替えられますが、最初は変更の前に確認が出る状態のままが安全です。


関連記事

参考文献



Claude Code・AIエージェントの業務活用をご検討の方へ

クリスタルメソッドは、Claude Codeを日々の業務で使いながら、AIエージェント・社員AIの導入と開発効率化を支援しています。自社サイトの表示速度をAI社員(Claude Code)で12.89秒→2.03秒に短縮した実例も事例記事として公開しています。「自社の開発・業務にAIをどう組み込むか」といったご相談を承っています。

関連タグ一覧

AIニュースのまとめをメールで

毎週月曜、海外AIニュースの日次ダイジェストを1週間分まとめてお届けします。無料・いつでも配信を停止できます。

監修

河合 継(クリスタルメソッド株式会社 代表取締役)

AI・ディープラーニングに関する特許16件の発明者。過去、国立がん研究センターとの共同研究や、テレビ番組でのAI解説実績を持つAI研究者として、AIの研究開発を主導している。
運営会社について | 編集方針

Read next

あわせて読みたい

  • 対話・チャットLLMのイメージ

    Claude Codeの始め方・使い方|インストールから最初の依頼まで初心者向けに解説【2026年10月】

    Claude Codeの始め方は、①有料プラン(Pro以上)かConsoleのアカウントを用意する → ②インストールする(または、デスクトップアプリの「Cod...

  • claude code 動かない原因と対処法|環境別トラブル完全解説

    claude code 動かない|『完了しました』を信じるな——環境系と生成系の対処【2026】

    Claudeが動かないときに最初に確認すること(結論) Claudeが動かないときは、①公式の稼働状況ページで障害が出ていないかを確認し、②使っているのが「Cl...

  • 対話・チャットLLMのイメージ

    Claude Codeの使い方|初心者が2日目から毎日回す手順と設定の育て方【2026年11月】

    Claude Codeの使い方は、作業するフォルダで claude を起動し、日本語で頼み、差分を読んで承認する、の繰り返しです。毎日うまく回すコツは、①自分で...

View more