インストール

Windows、macOS、Linux で Claude Code をインストールして設定

最終更新 2026-09-03

⚡ 推奨：ワンクリック設定 — コマンド 1 行で本ページの全手順を自動実行（エンドポイント計測・設定書き込み・Node.js / Claude Code インストール・疎通確認、sudo 不要）。手動インストールはこのまま読み進めてください。

# macOS / Linux
curl -fsSL https://qcode.cc/install/claude-code.sh | bash

# Windows PowerShell
irm https://qcode.cc/install/claude-code.ps1 | iex

詳細はワンクリック設定スクリプト（フラグ / トラブルシュート / ロールバック）。

📖 ANTHROPIC_BASE_URL に何を設定すべきか、4 つのアクセスドメインのどれを選ぶか迷ったらエンドポイントと API パスを参照してください。

このガイドに従って、お使いのコンピューターに Claude Code を簡単にインストールして使用できます。全体のプロセスはわずか 5 分で完了します。

前提条件 ¶

Claude Code の実行には Node.js が必要です。Node.js 18.0 以上がインストールされていることを確認してください（推奨 Node.js 22 LTS）。

Windows ¶

ステップ 1：Node.js のインストール ¶

オプション A：公式ダウンロード（推奨）¶

ブラウザで https://nodejs.org/ にアクセス
「LTS」バージョンをダウンロード（推奨される長期サポート版）
ダウンロードした .msi ファイルをダブルクリック
インストールウィザードに従ってデフォルト設定でインストール

オプション B：パッケージマネージャーを使用 ¶

Chocolatey または Scoop がインストールされている場合：

# Chocolatey を使用
choco install nodejs

# または Scoop を使用
scoop install nodejs

インストールの確認 ¶

node --version
npm --version

ステップ 2：Claude Code のインストール ¶

PowerShell または CMD を開く：

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

インストールの確認：

claude --version

ステップ 3：環境変数の設定 ¶

一時的（現在のセッションのみ）¶

$env:ANTHROPIC_BASE_URL = "https://api.qcode.cc/api"
$env:ANTHROPIC_AUTH_TOKEN = "your-api-key"

永続的（推奨）¶

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.qcode.cc/api", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your-api-key", [System.EnvironmentVariableTarget]::User)

your-api-key を QCode.cc ダッシュボードから取得した実際のキーに置き換えてください。

設定の確認 ¶

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

ステップ 4：使用開始 ¶

# プロジェクトのディレクトリに移動
cd C:\path\to\your\project

# Claude Code を起動
claude

Windows のよくある問題 ¶

権限エラーが出る？

PowerShell を管理者として実行してください
または npm をユーザーディレクトリ配下に設定します：npm config set prefix %APPDATA%\npm

PowerShell の実行ポリシーでエラーになる？

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

環境変数が反映されない？

永続設定のあと、PowerShell か CMD を再起動してください
または Windows からサインアウトして入り直してください

macOS ¶

ステップ 1：Node.js のインストール ¶

オプション A：Homebrew を使用（推奨）¶

brew update
brew install node

オプション B：公式ダウンロード ¶

https://nodejs.org/ にアクセス
macOS LTS バージョンをダウンロード
ダウンロードした .pkg ファイルを開く
インストール手順に従う

インストールの確認 ¶

node --version
npm --version

ステップ 2：Claude Code のインストール ¶

オプション A：Homebrew（推奨）¶

brew install --cask claude-code

オプション B：npm でインストール ¶

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

権限エラーが発生した場合：

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

ステップ 3：環境変数の設定 ¶

一時的（現在のセッションのみ）¶

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="your-api-key"

永続的（推奨）¶

シェルの設定ファイルを編集します：

# zsh の場合（macOS デフォルト）
echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.zshrc
source ~/.zshrc

# bash の場合
echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.bash_profile
source ~/.bash_profile

your-api-key を QCode.cc ダッシュボードから取得した実際のキーに置き換えてください。

ステップ 4：使用開始 ¶

# プロジェクトのディレクトリに移動
cd /path/to/your/project

# Claude Code を起動
claude

macOS のよくある問題 ¶

権限エラーが出る？

sudo でインストールします：sudo npm install -g @anthropic-ai/claude-code
または npm をユーザーディレクトリ配下に設定します：npm config set prefix ~/.npm-global

macOS が実行をブロックする？

「システム設定」→「プライバシーとセキュリティ」を開きます
「このまま開く」または「許可」をクリックします

Linux / WSL2 ¶

ステップ 1：Node.js のインストール ¶

オプション A：NodeSource を使用（推奨）¶

# NodeSource リポジトリを追加
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

# Node.js をインストール
sudo apt-get install -y nodejs

オプション B：システムパッケージマネージャーを使用 ¶

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm

インストールの確認 ¶

node --version
npm --version

ステップ 2：Claude Code のインストール ¶

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

権限の問題が出る場合：

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

インストールの確認：

claude --version

ステップ 3：環境変数の設定 ¶

一時的 ¶

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="your-api-key"

永続的 ¶

# bash の場合（既定）
echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.bashrc
source ~/.bashrc

# zsh の場合
echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.zshrc
source ~/.zshrc

ステップ 4：使用開始 ¶

cd /path/to/your/project
claude

Linux のよくある問題 ¶

ビルド用の依存ライブラリが足りない？

# Ubuntu/Debian
sudo apt install build-essential

# CentOS/RHEL
sudo dnf groupinstall "Development Tools"

詳細設定（オプションの環境変数）¶

必須の 2 つの環境変数に加えて、以下のオプション変数で詳細設定が可能です：

ANTHROPIC_MODEL ¶

デフォルトモデルを指定します。日常用途では Sonnet 5 を明示することを推奨します。未設定時は Claude Code そのバージョンの内蔵デフォルトに従います（CLI の更新で変わり得るので、このページの古いデフォルト名に頼らないでください）。claude-sonnet-4-6 や claude-opus-4-8 などの 4.x は引き続き販売中です。

# 日常の推奨（Sonnet 5）
export ANTHROPIC_MODEL=claude-sonnet-5

# 重い作業（Opus 5、コスト高）
export ANTHROPIC_MODEL=claude-opus-5

MAX_THINKING_TOKENS ¶

モデルの思考プロセスの最大トークン数を制御（0 で思考を無効化）：

export MAX_THINKING_TOKENS=16000

CLAUDE_CODE_EFFORT_LEVEL ¶

Claude の作業努力レベルを調整：

# 選択肢：low / medium / high
export CLAUDE_CODE_EFFORT_LEVEL=high

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ¶

不要なネットワークリクエスト（テレメトリなど）を無効化：

export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

次のステップ ¶

Claude Code のインストールが完了しました！次は：

クイックスタートで基本的な使い方を学ぶ
CLI テクニックで効率アップ

← 前のページ

エンドポイントと API パス

環境変数の設定

インストール

関連ドキュメント