CoreCodeドキュメント

接続

Windows での Claude Code

Windows で Claude Code を使う方法は 2 つあります。PowerShell でそのまま動かすか、WSL にインストールして Linux と同じように使うかです。このページでは、ネイティブ Windows でのインストール、設定、トラブルシューティングを扱います。WSL については最後のセクションを参照してください。

インストール

おすすめ:ネイティブインストール

PowerShell を開き(管理者権限は不要です)、次を実行します。

irm https://claude.ai/install.ps1 | iex

完了したら、そのウィンドウを閉じて新しい PowerShell を開き、claude --version を実行します。バージョン番号が表示されれば成功です。インストーラーは claude のあるフォルダーをユーザーの PATH に追加しますが、反映されるのは新しく開いたターミナルだけです。

別の方法:npm でインストール

Node.js 22 以降がインストールされていれば、次でもインストールできます。

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

ダウンロードが遅いときは、中国本土の npm ミラーが役立ちます。方法は 1 つだけにしてください。両方入れると、どちらの claude が動くか予測できません。

Git for Windows(任意)

ネイティブ Windows では Git for Windows は任意です。なくても Claude Code は PowerShell 経由でコマンドを実行します。入れておくと Claude Code は Git Bash を使い、Bash ツールと Monitor ツールには Git Bash が必要です(公式のセットアップガイドを参照)。すでに Git を使っているなら入れておきましょう。

Git を入れていても Claude Code が Git Bash を見つけられない場合は、settings.json の env ブロックにある CLAUDE_CODE_GIT_BASH_PATH に bash.exe のパスを指定します。たとえば "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe" です(JSON ではバックスラッシュを二重にします)。

設定

方法 1:設定ファイル(おすすめ)

エクスプローラーのアドレスバーに %USERPROFILE%\.claude と入力し(フォルダーがなければ .claude フォルダーを作成します)、メモ帳または VS Code で settings.json を作成または編集します。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://corecode.live",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

UTF-8 で保存してください。ファイルにすでに内容がある場合は、env ブロックだけを統合し、カンマと引用符の対応を崩さないようにします。PowerShell、Git Bash、VS Code 拡張機能はどれもこのファイルを読むので、1 回の編集ですべてに反映されます。

方法 2:環境変数

いまのウィンドウだけで試す場合は次のとおりです。

$env:ANTHROPIC_BASE_URL = "https://corecode.live"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-key"
claude

恒久的にするには、setx でユーザー環境変数を書き込み、新しいターミナルを開きます(setx はすでに開いているウィンドウを変更しません)。

setx ANTHROPIC_BASE_URL https://corecode.live
setx ANTHROPIC_AUTH_TOKEN sk-your-key

ANTHROPIC_API_KEY を同時に設定しないでください。Auth conflict になります。エラーを参照してください。

動作を確認する

claude -p "reply ok"

「ok」と返ってくれば接続できています。Claude Code で /status を入力すると、Base URL が https://corecode.live になっているはずです。

よくある問題

症状対処法
The term 'claude' is not recognized、または「内部コマンドまたは外部コマンドとして認識されていません」新しいターミナルを開いて再試行します。それでも直らなければ、Claude Code のインストール先フォルダーがユーザーの PATH に入っているか確認してください。npm でインストールした場合は、npm config get prefix が示すフォルダーが入っているか確認します。
running scripts is disabled on this systemPowerShell の実行ポリシーが、npm の作る claude.ps1 をブロックしています。Set-ExecutionPolicy -Scope CurrentUser RemoteSigned を実行して新しいターミナルを開くか、ネイティブインストールを使ってください。
初回起動で Unable to connect to Anthropic services と表示される%USERPROFILE%\.claude.json のトップレベルに "hasCompletedOnboarding": true を追加します。エラーを参照してください。
変更後も公式サービスのままになる、または /login を求められるsettings.json が %USERPROFILE%\.claude\ にあり、メモ帳がファイル名の末尾に .txt を付けていないか確認してから、新しいターミナルを開きます。
中国語の文字が文字化けするClaude Code を Windows Terminal で実行し、設定ファイルを UTF-8 で保存してください。

VS Code と JetBrains

VS Code の Claude Code 拡張機能は、コマンドラインと %USERPROFILE%\.claude\settings.json を共有します。方法 1 のあと、VS Code を完全に終了してから開き直してください。拡張機能に claude.ai アカウントでサインインしている場合は、先にサインアウトします。JetBrains プラグインは IDE のターミナルでコマンドライン版を動かすので、設定方法は同じです。

WSL で使う

すでに WSL で開発しているなら、WSL の中に Claude Code をインストールし、Linux と同じように設定します。

curl -fsSL https://claude.ai/install.sh | bash

設定は WSL 側の ~/.claude/settings.json にあり、Windows の %USERPROFILE%\.claude とは別です。プロジェクトは WSL のファイルシステム上(~/project など)に置いてください。/mnt/c よりずっと高速です。

そのほかの設定や日常のコマンドは Claude Code にあります。