Claude Code Ubuntu インストールガイド【完全版】

Ubuntu環境でClaude Codeをインストールする方法を、前提条件から実際の手順、トラブルシューティングまで詳しく解説します。

12分で読めます

Claude Code Ubuntu インストールガイド

Ubuntu環境でClaude Codeをインストールする方法を詳しく解説します。

前提条件

Claude CodeをUbuntuにインストールする前に、以下の要件を満たしていることを確認してください。

システム要件

  • Ubuntu 20.04 LTS以降
  • Node.js 18.0以降
  • npm 8.0以降
  • 2GB以上の空きメモリ

必要なツール

  • curl または wget
  • git
  • ターミナルアクセス

インストール方法

1. npmを使用したインストール

もっとも推奨される方法は、npmを使用したインストールです。

# Node.jsとnpmがインストールされているか確認
node --version
npm --version

# Claude Codeをグローバルにインストール
npm install -g @anthropic-ai/claude-code

2. 公式インストーラーの使用

公式のインストールスクリプトを使用することもできます。

# インストールスクリプトのダウンロードと実行
curl -fsSL https://claude.ai/install.sh | bash

3. インストールの確認

インストールが正常に完了したか確認します。

# Claude Codeのバージョン確認
claude-code --version

# ヘルプコマンドの確認
claude-code --help

初期設定

認証設定

Claude Codeを使用するには、Anthropic APIキーの設定が必要です。

# Claude Codeを起動して認証
claude-code

# ブラウザが開き、認証画面が表示されます

環境変数の設定(オプション)

# .bashrcまたは.zshrcに追加
export ANTHROPIC_API_KEY="your-api-key-here"

# 設定を反映
source ~/.bashrc

トラブルシューティング

Node.jsのバージョンが古い場合

# nvmを使用してNode.jsを更新
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 18
nvm use 18

権限エラーが発生する場合

# sudoを使用せずにグローバルパッケージをインストールできるよう設定
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

インストールが失敗する場合

# npmキャッシュのクリア
npm cache clean --force

# 再度インストール
npm install -g @anthropic-ai/claude-code

アップデート方法

Claude Codeを最新バージョンにアップデートする方法:

# 最新バージョンへのアップデート
npm update -g @anthropic-ai/claude-code

# または再インストール
npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code

アンインストール方法

必要に応じてClaude Codeをアンインストールできます。

# Claude Codeのアンインストール
npm uninstall -g @anthropic-ai/claude-code

# 設定ファイルの削除(オプション)
rm -rf ~/.claude-code

まとめ

Ubuntu環境でのClaude Codeインストールは、npmを使用することで簡単に行えます。インストール後は認証設定を行い、すぐに使用を開始できます。

問題が発生した場合は、トラブルシューティングセクションを参照するか、公式ドキュメントを確認してください。

関連記事