ガイド一覧へ戻る
設定·2026年9月5日·最終更新 2026年10月3日·読了7分

Claude Codeのインストール — 1行のコマンドと、その後につまずく2つのポイント

インストール自体は1行のコマンドです。実行に至るまでには、さらに2つの関門があります — npmのグローバルインストール権限と、ログイン時の支払いです。

Claude Codeのインストール自体は1行のコマンドで済みますが、実際に詰まるのはその後です。 インストールを扱う記事の多くは「インストール完了」で終わります。しかし韓国で実行まで進むには、さらに2つの関門があります――グローバルインストール権限とログイン・決済です。この記事では3段階を順に説明し、それぞれで詰まった場合の解決方法もまとめます。

第1段階――インストール（1行のコマンド）

前提条件はNode.js 18以上だけです。macOS、Windows（WSL）、Linuxで同じコマンドを使います。

# Node.js 18 이상이 필요합니다. 먼저 확인하세요.
node --version

# 설치
npm install -g @anthropic-ai/claude-code

# 확인 — 버전이 출력되면 설치 자체는 끝난 것입니다
claude --version

claude --versionがバージョンを出力すれば、インストールは完了です。ここで止まる場合は、以下の2つの節のいずれかに該当します。

第2段階――権限とパスのエラー

インストール段階で最もよくある2つのエラーです。

症状原因と解決策
EACCES権限エラーnpmグローバルディレクトリへの書き込み権限がない――グローバルパスをホームに移す
command not found: claudenpmグローバルbinがPATHにない――PATHに追加して新しいターミナルを開く

EACCESにsudoを付ける方法は推奨しません。その場ではインストールできますが、更新のたびに同じ問題が繰り返され、グローバルディレクトリの所有者がrootになってさらに複雑になります。パスをホームに移す方がすっきりします。

# npm 전역 설치에서 EACCES가 나면 sudo를 붙이지 말고
# 전역 경로를 홈 디렉터리로 옮기는 편이 안전합니다.
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global

# 셸 설정에 추가한 뒤 새 터미널을 엽니다
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc

Windowsの場合はWSL内にインストールしてください。プロジェクトファイルもWSLファイルシステムに置く必要があります。そうしないとファイル監視とパス処理が正常に動作しません。

第3段階――ログインと決済（韓国で実際に詰まる箇所）

インストールが終わり、claudeを実行するとログインを求められます。ここで止まるケースが韓国では最も多く、原因はインストールとは無関係です。

  • 海外決済がブロックされたカード――サブスクリプション決済に失敗します。カード会社のアプリまたはウェブサイトで海外決済を許可すれば、ほとんどの場合解決します。
  • KakaoPay・Toss――claude.aiのウェブ決済ではサポートされません（モバイルアプリのサブスクリプションにおけるストア決済手段にのみ存在します）。国内の簡易決済を期待して試すと、この段階で詰まります。
  • 海外決済に対応したカードがない場合は、ウェブサブスクリプションの経路を利用できません。以下のキー認証ではKunavo残高にチャージして利用します。決済画面が韓国ウォンで表示される場合、KakaoPay・Naver Pay・PAYCO・Samsung Payと、韓国国内カード（海外決済が有効でないカード）が支払い手段として提供されるため、海外決済カードなしでチャージできます（Tossはサポートされていません）。

決済手段ごとに何が使えて何が使えないかは、Claudeの決済方法にまとめています。

サブスクリプション決済で詰まった場合――インストールしたままキーで実行する

Claude CodeはサブスクリプションログインのほかにAPIキー認証もサポートしています。以下の2つの環境変数が設定されていればログイン画面を経由せずに実行でき、変数を削除すれば元に戻ります。再インストールは不要です。

~/.zshrc
# 구독 결제가 막혔을 때 설치한 클로드 코드를 그대로 쓰는 방법.
# 이 두 줄이 있으면 로그인 대신 키로 인증하고, 지우면 원래대로 돌아갑니다.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

# 클로드 코드의 기본 모델과 opus·sonnet 별칭은 Anthropic의 최신 모델을 따라가므로,
# Kunavo가 제공하는 모델로 고정해 404를 막습니다. sonnet 별칭은 Kunavo가 제공하지
# 않는 Sonnet 5.5를 요청하므로, 고정하지 않으면 /model sonnet, opusplan의 실행 단계,
# sonnet 서브에이전트가 404로 실패합니다. opus는 Opus 5.5로 고정하며,
# 클로드 코드 v2.1.280 이상이 필요합니다(이전 버전은 claude update).
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

claude

この経路では月額料金ではなく実際に使用したトークン分だけ請求されるため、作業しない月には費用が発生しません。キーの発行手順はClaude APIキーの発行、サブスクリプションと従量課金のどちらが安いかはClaude Codeの料金で説明しています。

インストール後の初回実行――確認の3分

起動したら、プロジェクトディレクトリでclaudeを起動し、/initを1回実行してください。リポジトリを読み取りCLAUDE.mdを作成し、以後すべてのセッションで自動的に読み込まれます。ここからの運用――ルール作成、権限設定、カスタムコマンド――はClaude Codeの使い方で続けて説明します。

起動後に発生する401・429・529エラーは、インストール段階とは原因がまったく異なります。見分け方はClaude Codeのエラーまとめに別途整理しています。

よくある質問

Claude Codeはどのようにインストールしますか？

npmでグローバルインストールする1行のコマンドです。npm install -g @anthropic-ai/claude-codeを実行し、claude --versionで確認します。前提条件はNode.js 18以上だけで、macOS・Windows・Linuxで同じコマンドを使います。WindowsではWSL内にインストールする方が問題が少なくなります。

インストール済みなのに起動できません。何を確認すべきですか？

まずclaude --versionが出力されるか確認してください。出力されればインストールは完了しており、残る問題は認証です。コマンドが見つからない場合は、npmのグローバルパスがPATHにない可能性があります。npm config get prefixで表示されたパスのbinをPATHに追加し、ターミナルを開き直してください。

インストール時にEACCES権限エラーが発生します。

npmのグローバルディレクトリに書き込む権限がないという意味です。sudoでインストールすれば一時的には動きますが、その後も権限問題が繰り返されるため推奨しません。npm config set prefix ~/.npm-globalでグローバルパスをホームディレクトリへ移し、PATHに追加する方法が安全です。

インストール後のログイン時に支払いが失敗します。

韓国で最も頻繁に問題になる点です。海外決済がブロックされたカードはサブスクリプション決済で失敗しますが、カード会社のアプリまたはウェブサイトで海外決済を許可すればほとんどの場合解決します。KakaoPayとTossはclaude.aiのウェブ決済ではサポートされておらず、モバイルアプリのサブスクリプションで利用するApp Store・Google Playの韓国向け支払い方法一覧にのみ掲載されています。決済を回避する必要がある場合は、サブスクリプションではなくAPIキーで認証する方法があります。この経路のKunavo残高チャージでは、決済画面が韓国ウォンで表示される場合、KakaoPay・Naver Pay・PAYCO・Samsung Pay・韓国国内カードを支払い手段として利用できます（Tossはサポートされていません）。

サブスクリプションなしでClaude Codeを使えますか？

可能です。Claude Codeはサブスクリプションログインに加えてAPIキー認証をサポートしています。ANTHROPIC_BASE_URLとANTHROPIC_AUTH_TOKENの2つの環境変数を設定すれば、ログインなしで実行できます。この場合、月額料金ではなく使用したトークン分だけ請求され、使わない月には費用が発生しません。

Windowsにはどのようにインストールしますか？

WSL（Windows Subsystem for Linux）内へのインストールを推奨します。WSLターミナルでNode.js 18以上をインストールした後、同じnpmコマンドを実行してください。このとき作業するプロジェクトもWSLファイルシステム内に置く必要があります。そうしないとファイル監視とパス処理が正常に動作しません。