友人を招待して無料トークンを獲得！詳細を見る

🪄 Claude Code を CodingPlanX カスタムモデルと連携する

> Claude Code は Anthropic が提供する強力な AI プログラミングアシスタントです。お使いのターミナルに直接組み込まれ、コードベースを理解し、コードの作成、リファクタリング、デバッグをシームレスに共同作業で行うことができます。 > > 本チュートリアルでは、環境の準備、ツールのインストール、そして codingplanx.ai プロキシインターフェース専用の設定手順をご案内します。

📋 システム要件

始める前に、お使いのシステムが以下の最小要件を満たしていることを確認してください：

  • Node.js：バージョン >= 18.0
  • OS：macOS、Linux、Windows (WSLの利用を推奨)

🚀 クイックスタート

1. Node.js のインストール

> 💡 ヒント：すでに Node.js 18.0 以降のバージョンをインストール済みの場合は、この手順をスキップしてください。

🍎 macOS ユーザー

Homebrew を使用したインストールを推奨します：

# 1. Xcode コマンドラインツールのインストール
sudo xcode-select --install

# 2. Homebrew のインストール（未インストールの場合）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 3. Homebrew を使って Node.js をインストール
brew install node

# 4. インストールの確認
node --version

🐧 Ubuntu / Debian ユーザー

NodeSource の公式スクリプトを使用して LTS バージョンをインストールします：

# 1. インストールスクリプトのダウンロードと実行
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -

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

# 3. インストールの確認
node --version

🪟 Windows ユーザー

winget コマンドラインを使用したインストール、または Node.js 公式サイト からインストーラーをダウンロードすることを推奨します：

# winget を使用して Node.js LTS バージョンをインストール
winget install OpenJS.NodeJS.LTS

# インストールの確認 (インストール後にターミナルの再起動が必要な場合があります)
node --version

2. Claude Code のインストール

ターミナルを開き、npm を使用して Claude Code をグローバルにインストールします：

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

# インストールが成功したか確認
claude --version

(注：権限エラーが発生した場合、macOS/Linux ユーザーは sudo npm install -g @anthropic-ai/claude-code を使用する必要があるかもしれません)

3. 設定して使い始める

🔑 必要な設定情報の取得

本サービスを利用するには、以下の2つの環境変数を準備する必要があります：

設定項目説明取得方法
ANTHROPIC_AUTH_TOKENAPI 認証トークン登録後、APIトークン ページで トークン追加 をクリックして取得（sk- で始まります）
ANTHROPIC_BASE_URLAPI サービスアドレス固定値：https://api.codingplanx.ai

> 📝 トークン作成時の推奨設定： > - 名称：任意の名前（例：claude-code-cli） > - 利用枠：無制限 に設定 > - グループ：Claude code専用 または 公式転送Claude3以上 を選択 > - その他のオプション：デフォルトのままでOK

💻 Claude Code の起動

お使いのOSとターミナルに合わせて、対応する起動コマンドを選択してください。まずプロジェクトディレクトリに移動してください：

cd your-project-folder

🟢 Linux / macOS (Bash/Zsh)

# 環境変数の設定（現在のターミナルのみ有効）
export ANTHROPIC_AUTH_TOKEN="sk-あなたの実際のトークン"
export ANTHROPIC_BASE_URL="https://api.codingplanx.ai"
export API_TIMEOUT_MS="300000"  # 長文回答時の切断を防ぐため、300秒のタイムアウトを設定

# Claude Code の起動
claude

🔵 Windows PowerShell

# 環境変数の設定（現在のターミナルのみ有効）
$env:ANTHROPIC_BASE_URL = "https://api.codingplanx.ai"
$env:ANTHROPIC_AUTH_TOKEN = "sk-あなたの実際のトークン"
$env:API_TIMEOUT_MS = "300000"

# Claude Code の起動
claude

⚫ Windows CMD

set ANTHROPIC_BASE_URL=https://api.codingplanx.ai
set ANTHROPIC_AUTH_TOKEN=sk-あなたの実際のトークン
set API_TIMEOUT_MS=300000

claude

> 💡 高度なヒント：毎回環境変数を入力したくない場合は、上記の export 文を ~/.bashrc や ~/.zshrc ファイルに追加するか（Mac/Linux）、Windows のシステム設定で永続的な環境変数として追加できます。

⚙️ 初回起動時の設定ウィザード

初めて claude を起動すると、システムのガイドに従って基本設定を行います：

  1. テーマの選択 (Theme) 👉 お好みのターミナル配色を選択し、Enter を押して確認します。
  2. 安全に関する注意事項 (Safety) 👉 安全に関するヒントを読み、Enter を押します。
  3. ターミナル設定 (Terminal) 👉 デフォルト設定の使用を推奨します。Enter を押します。
  4. ディレクトリの信頼 (Trust) 👉 現在の作業ディレクトリを信頼することを確認し、Enter を押します。

✨ おめでとうございます！ 入力プロンプトが表示されたら、AIプログラミングパートナーとの対話を開始できます！「このプロジェクトの主要な構造を説明して」と入力してみてください。

❓ よくある質問 (FAQ)

Q: Invalid API Key · Please run /login エラーが発生しました。

A: これは、Claude Code が環境変数を正常に読み込めていないことを示しています。以下を確認してください：

  1. ANTHROPIC_AUTH_TOKEN と ANTHROPIC_BASE_URL が正しく設定されているか。
  2. トークンの形式が正しいか（sk- で始まる必要があり、余分なスペースや引用符を含めないでください）。
  3. 永続的な環境変数を設定した場合は、設定を反映させるためにターミナルを再起動したか。

Q: ターミナルの左下に offline 状態と表示されるのはなぜですか？

A: Claude Code はデフォルトで google.com に ping を送信してネットワーク状態を判断します。中国国内のネットワーク環境などで offline と表示されるのは正常な現象であり、通常の使用やコード生成には全く影響しません。

Q: Claude にウェブページを閲覧（Fetch）させると失敗するのはなぜですか？

A: Claude Code は外部のウェブページにアクセスする前に、公式サービスを呼び出してセキュリティチェックを行う必要があります。Fetch に失敗する場合：

  1. コンピュータが安定した国際インターネット接続を持っているか確認してください。
  2. 必要に応じて、ターミナルのグローバルプロキシを有効にしてください（例：export https_proxy=...）。

Q: リクエスト時に常に fetch failed やタイムアウトが表示されます。

A: 通常、ネットワークの変動やプロキシ転送が原因です。解決策：

  1. タイムアウトの環境変数が正しく設定されているか確認してください：API_TIMEOUT_MS=300000。
  2. ローカルのプロキシノードを変更してみてください。
  3. Ctrl+C を押して現在のセッションを終了し、再度 claude コマンドを実行してください。

Q: ウェブページでのログインエラーが発生しました。

A: Token を取得するウェブページで異常が発生した場合は、ブラウザの Cookie キャッシュをクリアするか、シークレットモードを使用して codingplanx.ai に再度ログインしてみてください。

📌 注意事項

  • 🛡️ インターフェースの説明：本サイトは公式の Claude Code 転送サービスに直接接続しており、CLI ツールに完全対応しています。
  • 🚦 トラフィック制限：現在の設定は Claude Code の API トラフィックのみをサポートしており、他のサードパーティクライアントの通常の API 呼び出しには対応していません。
  • 🔒 セキュリティ警告：API トークン (sk-...) は厳重に保管し、コード内にハードコーディングしたり、公開されている GitHub リポジトリにアップロードしたりしないでください。

🔗 関連リンク