Claude Code インストール手順｜Mac・Windows・Linuxの導入から初期設定まで | Rust・Go・TypeScriptの実践テックブログ

Claude Codeは、Anthropicが提供するターミナルベースのAIコーディングアシスタントです。自然言語でコードの生成・修正・リファクタリング・Git操作を指示でき、ソフトウェア開発の生産性を大幅に高められます。

ただし、導入時にOS別の手順の違いやNode.jsの要否、認証方式の選択など、つまずきやすいポイントがいくつかあります。このページではmacOS・Windows・Linuxそれぞれの環境で、最短ルートでClaude Codeを使い始めるための手順を整理しました。

Claude Codeとは

Claude Codeは、ターミナル上で動作するエージェント型コーディングツールです。プロジェクトのディレクトリでclaudeコマンドを実行すると対話セッションが始まり、コードベース全体を読み取ったうえで質問への回答やコード変更を行います。

主な機能は次のとおりです。

コード生成・編集: 自然言語の指示でファイルの作成・修正を実行
デバッグ支援: バグの原因調査と修正案の提示
Git操作: コミットメッセージ生成、ブランチ作成、マージコンフリクト解消
テスト作成: 関数やモジュールのユニットテスト自動生成
リファクタリング: 既存コードの構造改善提案と実装
CLAUDE.md: プロジェクト固有のルールや慣習を記述したファイルをClaude Codeが参照し、チーム規約に沿ったコードを生成

ChatGPTやCopilotなどのエディタ統合型AIとの大きな違いは、ターミナルからプロジェクト全体を横断的に操作できる点です。単一ファイルの補完ではなく、複数ファイルにまたがるタスクを一度の指示でこなせます。

導入前に確認するシステム要件

Claude Codeをインストールする前に、自分の環境が要件を満たしているか確認が必要です。

項目	要件
OS	macOS 13.0以上 / Ubuntu 20.04以上・Debian 10以上 / Windows 10以上
RAM	4GB以上
ネットワーク	インターネット接続が必須
シェル	Bash または Zsh（推奨）
Node.js	18以上（npm経由でインストールする場合のみ）
地域	Anthropic対応国であること

Windowsの場合、WSL 1 / WSL 2 / Git for Windowsのいずれかが必要です（詳細は後述）。

追加の依存関係としてripgrepがありますが、通常はClaude Codeのネイティブインストーラーに同梱されています。検索機能がうまく動かない場合は手動でインストールしてください。

OS別インストール手順

Claude Codeには複数のインストール方法があります。Anthropicが推奨しているのはネイティブインストーラーで、Node.jsが不要・自動更新付きという利点があります。

方法ごとの特徴比較

方法	Node.js不要	自動更新	対応OS	備考
ネイティブ（推奨）	○	○	macOS / Linux / Windows	最も簡単
Homebrew	○	×	macOS / Linux	`brew upgrade`で手動更新
WinGet	○	×	Windows	`winget upgrade`で手動更新
npm（非推奨）	×	×	全OS	Node.js 18以上が必要

macOSへの導入

ターミナル（Terminal.appまたはiTerm2など）を開き、次のコマンドを実行します。

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

Homebrewを使う場合は次のとおりです。

brew install --cask claude-code

インストール後、バージョンを確認します。

claude --version

バージョン番号が表示されれば導入完了です。

Windowsへの導入

Windowsでは2つの方法があります。

方法A: WSL（Windows Subsystem for Linux）を使う場合

WSLを有効化済みであれば、WSLターミナルから次を実行します。

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

WSL 1・WSL 2どちらもサポートされています。

方法B: Git for Windowsを使う場合（ネイティブWindows）

Git for Windowsをインストールしたうえで、PowerShellから次を実行します。

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

コマンドプロンプト（CMD）の場合は次のとおりです。

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

ポータブル版Gitを利用している場合は、bash.exeのパスを環境変数で指定します。

$env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"

WinGetを使う場合

winget install Anthropic.ClaudeCode

WinGet経由ではインストール後にwinget upgrade Anthropic.ClaudeCodeで手動更新が必要です。

Linux（Ubuntu / Debian）への導入

ターミナルで次のコマンドを実行します。

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

Alpine Linuxなどmuslベースのディストリビューションでは、事前に追加パッケージが必要です。

apk add libgcc libstdc++ ripgrep

さらに環境変数を設定します。

export USE_BUILTIN_RIPGREP=0

npmでのインストール（非推奨）

npm経由のインストールはAnthropicとしては非推奨ですが、既存のNode.js環境に合わせたい場合は利用できます。

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

sudoを付けて実行すると権限問題やセキュリティリスクが生じるため避けてください。npm版からネイティブ版に移行するには、claude installを実行します。

認証とアカウント設定

インストールが完了したら、プロジェクトディレクトリに移動してclaudeコマンドを実行します。

cd your-project
claude

初回起動時にログインが求められます。認証方式は2種類あります。

サブスクリプション認証（推奨）

Claude.aiのPro・Max・Teams・Enterpriseプランのアカウントでログインする方法です。ブラウザが自動的に開き、認証が完了するとターミナルに戻ります。

料金プランの概要は次のとおりです。

プラン	月額（税別）	Claude Code利用	主な用途
Free	$0	×	Web版のみの基本利用
Pro	$20（年払い$17）	○	個人での日常的な開発
Max 5x	$100	○	大規模コードベースでの集中開発
Max 20x	$200	○	企業内パワーユーザー
Teams Standard	$25/席（年払い$20）	○	チーム向け一元管理
Teams Premium	$125/席（年払い$100）	○	チーム向け高使用量

（出典: Claude公式料金ページ）

API認証（Claude Console）

Anthropic Consoleのアカウントで接続する方式です。プリペイドクレジットを購入し、使用量に応じた従量課金となります。初回認証時に「Claude Code」ワークスペースが自動生成され、コスト追跡に利用できます。

APIの主なモデル料金は次のとおりです。

モデル	入力（100万トークンあたり）	出力（100万トークンあたり）
Claude Opus 4.6	$5	$25
Claude Sonnet 4.5	$3	$15
Claude Haiku 4.5	$1	$5

（出典: Anthropic API Pricing）

Claude Code内でアカウントを切り替えるには/loginコマンドを使います。同じメールアドレスでサブスクリプションとAPIの両方を保持できます。

インストール後の初期設定

claude doctorで環境チェック

インストール直後に次のコマンドを実行すると、インストールタイプやバージョン、依存関係の状態をまとめて確認できます。

claude doctor

問題が検出された場合は対処法が表示されます。

CLAUDE.mdによるプロジェクトルール設定

Claude Codeはプロジェクトルートに配置されたCLAUDE.mdファイルを自動的に読み込みます。ここにコーディング規約やアーキテクチャの方針を記述しておくと、Claude Codeがそのルールに従ったコードを生成します。

# CLAUDE.md

## コーディング規約
- TypeScriptを使用、any型禁止
- 関数名はcamelCase、型名はPascalCase
- 早期returnを推奨

## テスト
- 変更後は必ず `npm run test` を実行
- カバレッジ80%以上を維持

## Git
- コミットメッセージは日本語で、prefixにfeat/fix/refactorを付ける

CLAUDE.mdはプロジェクトごとの設定です。ユーザーごとのグローバル設定は~/.claude/CLAUDE.mdに配置します。

エディタ連携

Claude CodeはVS Code拡張としても利用可能です。ターミナルとエディタのどちらからでもアクセスでき、ワークフローに合わせて使い分けられます。

更新とアンインストール

更新方法

ネイティブインストールの場合、Claude Codeはバックグラウンドで自動更新されます。起動時と実行中に定期的に更新チェックが行われ、次回起動時に新バージョンが適用されます。

手動で更新する場合は次のコマンドを使います。

claude update

Homebrew・WinGetでインストールした場合は自動更新されないため、定期的に手動更新が必要です。

# Homebrew
brew upgrade claude-code

# WinGet
winget upgrade Anthropic.ClaudeCode

リリースチャネル設定

自動更新のリリースチャネルは2種類から選べます。

latest（デフォルト）: 新機能がリリースされ次第配信
stable: 約1週間遅延で配信され、大きな不具合を含むリリースがスキップされる

設定は/configメニューまたはsettings.jsonで変更します。

{
  "autoUpdatesChannel": "stable"
}

自動更新を完全に無効化するには環境変数を設定します。

export DISABLE_AUTOUPDATER=1

アンインストール

ネイティブインストールの場合（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

Homebrew

brew uninstall --cask claude-code

WinGet

winget uninstall Anthropic.ClaudeCode

npm

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

設定ファイルも削除する場合は、~/.claudeディレクトリと~/.claude.jsonを手動で削除します。

よくあるトラブルと対処法

`claude: command not found`と表示される

PATHに~/.local/binが含まれていない可能性があります。シェルの設定ファイルに追加します。

# .bashrc または .zshrc に追記
export PATH="$HOME/.local/bin:$PATH"

追記後、source ~/.bashrc（またはsource ~/.zshrc）で反映させます。

npmインストール時の権限エラー

sudo npm install -gは使わないでください。代わりにnpmのグローバルインストール先をユーザーディレクトリに変更します。

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH="$HOME/.npm-global/bin:$PATH"

そもそもnpm版は非推奨のため、ネイティブインストーラーへの移行を推奨します。claude installコマンドで移行できます。

WSLでのネットワーク接続エラー

WSL内からAnthropicのAPIに接続できない場合、企業のプロキシやファイアウォールが原因の場合があります。プロキシ設定が必要な環境では次のように環境変数を設定します。

export HTTPS_PROXY=http://your-proxy:port

ログインが完了しない

ブラウザが自動的に開かない場合は、ターミナルに表示される認証URLを手動でブラウザにコピーしてアクセスしてください。WSL環境ではWindowsのブラウザが起動しないケースがあるため、URLの手動コピーが確実です。

日本語入力の文字化けや変換の問題

ターミナルの文字コードがUTF-8であることを確認してください。Windows Terminalを使用している場合は設定からUTF-8を指定します。macOSのTerminal.appでは通常問題ありませんが、古いターミナルエミュレータを使っている場合はLANG=ja_JP.UTF-8を設定します。

基本的な使い方（インストール後の動作確認）

導入が完了したら、プロジェクトディレクトリで次の操作を試してみてください。

cd your-project
claude

対話セッションが開始したら、まずプロジェクトの概要を確認します。

> what does this project do?

Claude Codeがファイルを読み込んで回答します。続いて簡単なコード変更を試します。

> add a hello world function to the main file

変更内容が表示され、承認を求められます。承認するとファイルが更新されます。

よく使うコマンドは次のとおりです。

コマンド	機能
`claude`	対話セッション開始
`claude "タスク"`	単発タスク実行
`claude -p "質問"`	質問して結果を出力後終了
`claude -c`	直前の会話を再開
`claude commit`	Gitコミット作成
`/clear`	会話履歴クリア
`/help`	ヘルプ表示
`/cost`	セッションのコスト確認

セッションを終了するにはexitと入力するかCtrl+Cを押します。

まとめ

Claude Codeの導入はネイティブインストーラーを使えば1コマンドで完了します。macOS・Linuxはcurlコマンド、WindowsはPowerShellまたはCMDのワンライナーで即座にインストール可能です。

導入後はCLAUDE.mdをプロジェクトルートに配置し、チーム固有のルールを記述しておくと、生成されるコードの品質が安定します。料金面ではProプラン（月額$20）から利用でき、大量に使う場合はMax 5x（$100）・Max 20x（$200）も選択できます。

公式ドキュメント（Claude Code セットアップ）には最新のインストール手順やトラブルシューティングが掲載されているため、問題が発生した場合はあわせて参照してください。

Claude Codeとは#

導入前に確認するシステム要件#

OS別インストール手順#

方法ごとの特徴比較#

macOSへの導入#

Windowsへの導入#

Linux（Ubuntu / Debian）への導入#

npmでのインストール（非推奨）#

認証とアカウント設定#

サブスクリプション認証（推奨）#

API認証（Claude Console）#

インストール後の初期設定#

claude doctorで環境チェック#

CLAUDE.mdによるプロジェクトルール設定#

エディタ連携#

更新とアンインストール#

更新方法#

リリースチャネル設定#

アンインストール#

よくあるトラブルと対処法#

claude: command not foundと表示される#

npmインストール時の権限エラー#

WSLでのネットワーク接続エラー#

ログインが完了しない#

日本語入力の文字化けや変換の問題#

基本的な使い方（インストール後の動作確認）#

まとめ#