Claude Code のインストール方法【完全ガイド】

「Claude Codeを使ってみたいけど、何から始めればいいかわからない」と感じていませんか?
実は npm install -g @anthropic-ai/claude-code の1コマンドで完了し、APIキーを設定するだけですぐに使い始められます。

この記事で得られること:

  • インストールに必要な環境と事前準備
  • Step by Step の具体的なインストール手順
  • API キーの取得・設定方法と初回起動の流れ
  • 「command not found」などよくあるエラーの解決法

対象読者:Claude Code を初めてインストールしたい方、ターミナル操作に慣れた開発者

結論:Node.js 18以上があれば、インストールから初回起動まで5分で完了します。

Claude Code とは?

Claude Code は、Anthropic が開発した AI エンジニアリングツールです。ターミナル上で動作し、コードの作成・編集・デバッグ・テスト・Git 操作などをすべて自然言語で指示できます。単なるコード補完ではなく、プロジェクト全体のコンテキストを理解した上で、ファイルの読み書きやコマンド実行まで自律的にこなすエージェント型ツールです。

必要な環境

インストール前に以下の環境を準備してください。
  • Node.js 18 以上(推奨: 最新の LTS 版)
  • npm または npx(Node.js に同梱)
  • Anthropic API キーconsole.anthropic.com で取得)
  • macOS / Linux / Windows(WSL2 推奨)

インストール手順

Step 1: Node.js のバージョンを確認する

まずターミナルを開き、Node.js がインストールされているか確認します。
node --version
# v18.0.0 以上であればOK
インストールされていない場合は nodejs.org からインストールしてください。

Step 2: Claude Code をインストールする

npm を使ってグローバルインストールします。
npm install -g @anthropic-ai/claude-code
または、インストールせずにそのまま実行することも可能です。
npx @anthropic-ai/claude-code

Step 3: インストールを確認する

claude --version
バージョン番号が表示されれば成功です。

Step 4: API キーを設定する

Anthropic のコンソールで API キーを取得し、環境変数に設定します。
# macOS / Linux の場合(~/.zshrc または ~/.bashrc に追記)
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxx"

# 設定を反映
source ~/.zshrc
または Claude Code の初回起動時に対話形式で設定することもできます。

初回起動と認証

プロジェクトのディレクトリに移動して claude コマンドを実行します。
cd /path/to/your/project
claude
初回起動時にブラウザが開き、Anthropic アカウントへのログインと API キーの紐付けが行われます。認証が完了するとターミナルに対話形式のプロンプトが表示されます。

基本的な使い方

起動後はチャット形式で指示を送るだけです。
# ファイルの内容を説明してもらう
> このファイルの処理を説明して

# バグ修正
> login.py の認証エラーを修正して

# 新機能の追加
> ユーザー一覧ページに検索機能を追加して

# Git コミット
> 変更内容をコミットして

VS Code との連携

Claude Code は VS Code 拡張機能としても利用できます。拡張機能マーケットプレイスで「Claude Code」を検索してインストールすることで、エディタ上から直接利用できます。

さらに、【Claude Code × Pencil】IDEで完結するAI駆動UIデザインの使い方 のように MCP サーバーと連携することで、UIデザイン生成まで IDE 内で完結させることもできます。

スキルでできることを拡張する

Claude Code はインストール後にスキルを追加することで機能をさらに広げられます。たとえば skills.sh の find-skills スキルを使えば、「〇〇をするスキルを探して」と話しかけるだけで必要なスキルを自動で検索・インストールしてくれます。

フロントエンド開発に役立つ skills.sh のおすすめスキル3選もあわせて確認してみてください。

よくある問題と対処法

「command not found: claude」と表示される

npm のグローバルインストールパスが PATH に含まれていない可能性があります。以下を確認してください。
npm config get prefix
# 表示されたパス/bin を PATH に追加する

API キーの認証エラーが出る

API キーが正しく設定されているか確認します。
echo $ANTHROPIC_API_KEY
空白や改行が混入していないかも確認してください。

よくある質問

Q1. Windows でも使えますか?

使えますが、WSL2(Windows Subsystem for Linux 2)の使用を強く推奨します。PowerShell やコマンドプロンプトでも動作しますが、一部コマンドの挙動がLinux/macOSと異なる場合があります。WSL2 + Ubuntu 環境が最もスムーズです。

Q2. API キーの料金はどのくらいかかりますか?

Claude API は従量課金制です。Claude Code ではモデルに応じて入出力トークンあたりの料金が発生します。月額 $20 の Claude Pro プランに含まれる Claude Code サブスクリプションを使うと、API 費用を気にせず使えるためおすすめです。詳細は Anthropic 公式の料金ページを確認してください。

Q3. Claude.ai と Claude Code の違いは何ですか?

Claude.ai はブラウザで使うチャット UI です。Claude Code はターミナルで動作するエージェント型 CLI ツールで、ファイルの読み書き・コマンド実行・Git 操作を自律的にこなせる点が大きく異なります。コーディング作業には Claude Code が圧倒的に向いています。

Q4. 複数プロジェクトで同時に使えますか?

グローバルインストールされた claude コマンドは、ターミナルを複数開けばプロジェクトごとに同時起動できます。ただし API キーのレート制限はアカウント単位で共有されます。

Q5. 企業・チームでの利用に制限はありますか?

Claude Code の API 利用規約に従う必要があります。機密コードを含む場合はデータの取り扱いポリシーを確認してから導入してください。Anthropic の利用ポリシーも参照してください。

まとめ

Claude Code のインストールは npm install -g @anthropic-ai/claude-code の1コマンドで完了します。API キーさえ用意すれば、すぐに AI エージェントとしてのコーディング支援を受けられます。

  • Node.js 18以上があればインストール可能
  • API キーは ~/.zshrc に export して永続化する
  • 「command not found」は npm の PATH 設定で解決できる
  • VS Code / Cursor 拡張機能と組み合わせるとさらに便利

インストール後は find-skills スキルを使ってできることを広げるのがおすすめです。