# インストール
> ⚡ **推奨：ワンクリック設定** — コマンド 1 行で本ページの全手順を自動実行（エンドポイント計測・設定書き込み・Node.js / Claude Code インストール・疎通確認、sudo 不要）。手動インストールはこのまま読み進めてください。
```bash
# macOS / Linux
curl -fsSL https://qcode.cc/install/claude-code.sh | bash
```
```powershell
# Windows PowerShell
irm https://qcode.cc/install/claude-code.ps1 | iex
```
> 詳細は [ワンクリック設定スクリプト](/docs/getting-started/one-click-install)（フラグ / トラブルシュート / ロールバック）。
> 📖 `ANTHROPIC_BASE_URL` に何を設定すべきか、4 つのアクセスドメインのどれを選ぶか迷ったら [エンドポイントと API パス](./endpoints-and-api-paths) を参照してください。
このガイドに従って、お使いのコンピューターに Claude Code を簡単にインストールして使用できます。全体のプロセスはわずか 5 分で完了します。
## 前提条件
Claude Code の実行には Node.js が必要です。Node.js 18.0 以上がインストールされていることを確認してください（推奨 **Node.js 22 LTS**）。
## Windows
### ステップ 1：Node.js のインストール
#### オプション A：公式ダウンロード（推奨）
1. ブラウザで [https://nodejs.org/](https://nodejs.org/) にアクセス
2. 「LTS」バージョンをダウンロード（推奨される長期サポート版）
3. ダウンロードした `.msi` ファイルをダブルクリック
4. インストールウィザードに従ってデフォルト設定でインストール
#### オプション B：パッケージマネージャーを使用
Chocolatey または Scoop がインストールされている場合：
```powershell
# Chocolatey を使用
choco install nodejs
# または Scoop を使用
scoop install nodejs
```
#### インストールの確認
```powershell
node --version
npm --version
```
### ステップ 2：Claude Code のインストール
PowerShell または CMD を開く：
```powershell
npm install -g @anthropic-ai/claude-code
```
インストールの確認：
```powershell
claude --version
```
### ステップ 3：環境変数の設定
#### 一時的（現在のセッションのみ）
```powershell
$env:ANTHROPIC_BASE_URL = "https://api.qcode.cc/api"
$env:ANTHROPIC_AUTH_TOKEN = "your-api-key"
```
#### 永続的（推奨）
```powershell
[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 ダッシュボード](https://qcode.cc/dashboard) から取得した実際のキーに置き換えてください。
#### 設定の確認
```powershell
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
```
### ステップ 4：使用開始
```powershell
# プロジェクトのディレクトリに移動
cd C:\path\to\your\project
# Claude Code を起動
claude
```
### Windows のよくある問題
**権限エラーが出る？**
- PowerShell を管理者として実行してください
- または npm をユーザーディレクトリ配下に設定します：`npm config set prefix %APPDATA%\npm`
**PowerShell の実行ポリシーでエラーになる？**
```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```
**環境変数が反映されない？**
- 永続設定のあと、PowerShell か CMD を再起動してください
- または Windows からサインアウトして入り直してください
## macOS
### ステップ 1：Node.js のインストール
#### オプション A：Homebrew を使用（推奨）
```bash
brew update
brew install node
```
#### オプション B：公式ダウンロード
1. [https://nodejs.org/](https://nodejs.org/) にアクセス
2. macOS LTS バージョンをダウンロード
3. ダウンロードした `.pkg` ファイルを開く
4. インストール手順に従う
#### インストールの確認
```bash
node --version
npm --version
```
### ステップ 2：Claude Code のインストール
#### オプション A：Homebrew（推奨）
```bash
brew install --cask claude-code
```
#### オプション B：npm でインストール
```bash
npm install -g @anthropic-ai/claude-code
```
権限エラーが発生した場合：
```bash
sudo npm install -g @anthropic-ai/claude-code
```
### ステップ 3：環境変数の設定
#### 一時的（現在のセッションのみ）
```bash
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="your-api-key"
```
#### 永続的（推奨）
シェルの設定ファイルを編集します：
```bash
# 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 ダッシュボード](https://qcode.cc/dashboard) から取得した実際のキーに置き換えてください。
### ステップ 4：使用開始
```bash
# プロジェクトのディレクトリに移動
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 を使用（推奨）
```bash
# NodeSource リポジトリを追加
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
# Node.js をインストール
sudo apt-get install -y nodejs
```
#### オプション B：システムパッケージマネージャーを使用
```bash
# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm
# CentOS/RHEL/Fedora
sudo dnf install nodejs npm
```
#### インストールの確認
```bash
node --version
npm --version
```
### ステップ 2：Claude Code のインストール
```bash
npm install -g @anthropic-ai/claude-code
```
権限の問題が出る場合：
```bash
sudo npm install -g @anthropic-ai/claude-code
```
インストールの確認：
```bash
claude --version
```
### ステップ 3：環境変数の設定
#### 一時的
```bash
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="your-api-key"
```
#### 永続的
```bash
# 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：使用開始
```bash
cd /path/to/your/project
claude
```
### Linux のよくある問題
**ビルド用の依存ライブラリが足りない？**
```bash
# 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 は引き続き販売中です。
```bash
# 日常の推奨（Sonnet 5）
export ANTHROPIC_MODEL=claude-sonnet-5
# 重い作業（Opus 5、コスト高）
export ANTHROPIC_MODEL=claude-opus-5
```
### MAX_THINKING_TOKENS
モデルの思考プロセスの最大トークン数を制御（0 で思考を無効化）：
```bash
export MAX_THINKING_TOKENS=16000
```
### CLAUDE_CODE_EFFORT_LEVEL
Claude の作業努力レベルを調整：
```bash
# 選択肢：low / medium / high
export CLAUDE_CODE_EFFORT_LEVEL=high
```
### CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC
不要なネットワークリクエスト（テレメトリなど）を無効化：
```bash
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
```
## 次のステップ
Claude Code のインストールが完了しました！次は：
1. [クイックスタート](/docs/getting-started/quick-start) で基本的な使い方を学ぶ
2. [CLI テクニック](/docs/usage/cli-tips) で効率アップ