Claude Code のインストール・API 設定・Windows トラブル対処

I Code Easy の API Key を Claude Code で使うには、CLI をインストールし、ANTHROPIC_AUTH_TOKEN と ANTHROPIC_BASE_URL を設定します。ターミナルを開き直し、プロジェクト内で claude を起動してください。Claude Desktop の場合はアプリ内の Gateway 設定を使います。手順は後半にあります。

準備：アカウント・キー・モデル

1. アカウント登録後、ログインして API Keys から当サイトのキーをコピーします。ログイン用パスワードは使いません。
2. エンドポイント選択で使用するモデル系列のエンドポイントを選択して保存します。詳細は はじめにを参照してください。
3. 料金・残高・使用量とモデル機能でモデル ID、利用条件、対応プロトコルを確認します。クライアントをインストールしても API 残高やモデルの利用権限は付与されません。

キーは自分のクライアント設定内だけに保存してください。Git にコミットしたり公開画像に載せたりせず、漏えいした場合は API Keys ページで再発行します。

ステップ 1: Claude Code をインストール

ネイティブ版か npm 版のどちらかを選びます。npm に必要な Node.js とターミナルの準備は環境設定を参照してください。

MacOS / Linux / WSL

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

Windows PowerShell

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

Windows CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

ネイティブインストーラーは Claude Code をバックグラウンドで自動更新します。

npm でのインストール（環境設定の完了後）

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

ステップ 2: API を設定

以下の環境変数は Claude Code CLI 専用です。Desktop はこの ANTHROPIC_BASE_URL や CLI の settings.json を読み込まないため、後半の専用設定を使ってください。

Linux / MacOS

次のコマンドは現在の shell に適用されます。次回以降も使うには、使用する shell に対応した ~/.bashrc または ~/.zshrc に追加します。キーの仮の値を自分の API Key に置き換えてください:

export ANTHROPIC_AUTH_TOKEN="your API Key"
export ANTHROPIC_BASE_URL="https://api.icodeeasy.cc"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

CLAUDE_CODE_ATTRIBUTION_HEADER=0 は設定しないでください。一部の Claude Code 専用チャネルでは、クライアント本来の attribution メタデータを検証します。

利用中のネットワークで api.icodeeasy.cc が遅い場合は、ANTHROPIC_BASE_URL を https://jp.icodeeasy.cc または https://sg.icodeeasy.cc に変更してください。

ファイルを保存し、source ~/.bashrc または source ~/.zshrc を実行します。

Windows

PowerShell で実行します:

# Set API key
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your API Key", "User")

# Set API base URL
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.icodeeasy.cc", "User")

# Disable non-essential traffic
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", "User")

利用中のネットワークで api.icodeeasy.cc が遅い場合は、ANTHROPIC_BASE_URL を https://jp.icodeeasy.cc または https://sg.icodeeasy.cc に変更してください。

環境変数を設定した後、新しい PowerShell ウィンドウを開いてください。

新しいウィンドウでユーザーレベルの環境変数を確認します:

-not [string]::IsNullOrWhiteSpace([Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "User"))
[Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", "User")
[Environment]::GetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "User")

SetEnvironmentVariable は永続的なユーザーレベル環境変数を書き込みます。現在の PowerShell セッションは更新されないため、claude を起動する前に新しい PowerShell ウィンドウを開いてください。

CLI が読み込む環境を確認

macOS / Linux / WSL では、キーを表示せず有無だけを確認します:

[ -n "$ANTHROPIC_AUTH_TOKEN" ] && echo "Token configured" || echo "Token missing"
printf '%s\n' "$ANTHROPIC_BASE_URL"

Windows では、新しく開いた PowerShell でプロセスの環境変数を確認します:

-not [string]::IsNullOrWhiteSpace($env:ANTHROPIC_AUTH_TOKEN)
$env:ANTHROPIC_BASE_URL

最初の結果が True で、アドレスが選択したドメインと一致していれば設定が読み込まれています。ユーザー変数にはキーがあるのに False になる場合は、起動元の環境が更新されていません。IDE 内のターミナルはエディター起動時の値を引き継ぐ場合があるため、必要に応じてエディター自体を終了して開き直します。

WSL は Linux 環境です。Windows PowerShell に保存した変数とは別に、WSL の shell で Linux の手順に従って設定してください。Base URL はドメインまでとし、/v1/messages を追加しません。

ステップ 3: Claude Code を起動

まずターミナルでインストール済みバージョンを確認します:

claude --version

cd your-project-folder
claude

起動後に /status を入力し、現在のモデル、アカウント、認証情報の取得元、Gateway URL を確認します。これは設定確認であり、実際のリクエスト成功を示すものではありません。

短い質問を一つ送り、応答を確認してからリクエストログでモデル、状態、使用量を確認します。インストール完了、CLI の起動、キーの存在確認だけでは API リクエストの成功を証明できません。

Claude Code のよくある問題

予備アドレスは https://jp.icodeeasy.cc と https://sg.icodeeasy.cc です。当サイトの同じキーを使います。ドメイン切り替えは接続回復用であり、アカウントやモデルの変更ではありません。詳しくは接続と復旧を参照してください。

問い合わせにはクライアントのバージョン、OS、北京時間、秘密情報を除いたエラー本文、リクエスト識別子を添えてください。API Key や環境変数全体は送らないでください。

Claude Code で Kimi・GLM を使う

クライアント、API アドレス、モデル名はそれぞれ別の設定です。Base URL の指定だけでは Kimi や GLM は選択されません。Kimi 設定またはGLM 設定に従ってモデルを設定し、起動後に選択を確認します。現在の利用条件は各ガイドと機能一覧を参照してください。

Claude Desktop の設定

Claude Desktop は Developer Mode からサードパーティリレーに接続できます。

Desktop は専用の third-party inference 設定を使い、上記の CLI 環境変数を引き継ぎません。メニューの表示はインストール済みバージョンによります。モデルの利用には当サイトの一覧とエンドポイントの条件も適用され、モデル名の入力だけでは互換性は確認できません。

Developer Mode を有効化

メニューバーで Help -> Troubleshooting -> Enable Developer mode をクリックし、Claude Desktop を再起動します。

リレーを設定

再起動後、メニューバーで Developer -> Configure third-party inference をクリックし、次を入力します:

利用中のネットワークで api.icodeeasy.cc が遅い場合は、Base URL を https://jp.icodeeasy.cc または https://sg.icodeeasy.cc に変更してください。

モデルを設定

claude-opus-5-5、claude-sonnet-5-5 など使いたいモデル名を入力し、保存して Claude Desktop を再起動します。Claude モデルは Claude 系エンドポイントを利用できます。

Kimi と GLM のモデル設定は Kimi 設定とGLM 設定を参照してください。Claude Fable 5 を固定して使う場合は、Claude Fable 5 ガイドを参照してください。

公式リファレンス

• インストールと更新
• 環境変数
• モデル設定
• サードパーティ Gateway と Desktop