n8n を QCode に接続する図解チュートリアル(Windows 11・1 ステップ 1 枚)

13 ステップ・13 枚のスクリーンショットで、Windows 11 に Node.js 24 を入れて n8n 2.48.7 を起動し、OpenAI ノードを QCode の OpenAI 互換エンドポイントに接続して、gpt-6.2-sol で中国語の返答を受け取るところまで解説します。

最終更新 2026-11-23

API キーが必要ですか? 登録する →エンドポイントと Base URL →

目次

以下の 13 ステップどおりに進めれば、自分の Windows 11 PC でワークフロー自動化ツール n8n を起動し、その OpenAI ノードから QCode 経由で一言返してもらえます。

一言で言うと:n8n のキャンバスにある「Message a model」ノードで「Connect to OpenAI」をクリックし、「OpenAI account」という認証情報を新規作成して、Base URL を https://api.qcode.cc/openai/v1 に、API Key を cr_ で始まるキーに書き換え、Model で gpt-6.2-sol を選ぶだけです。

項目 入力内容
ローカルで開くアドレス http://localhost:5678
認証情報の名前 OpenAI account
接続先(Base URL) https://api.qcode.cc/openai/v1
キー(API Key) cr_xxxxxxxx
推奨モデル(Model) gpt-6.2-sol

2026-11-22 時点で確認 · n8n 2.48.7 · Windows 11

n8n はオープンソースの自動化ツールです。「トリガー条件」と「やること」をキャンバスに置いてつなげれば、決まった時刻やイベントに合わせて代わりに実行してくれます。OpenAI ノードは接続先アドレスをカスタマイズできるので、アドレスを QCode に向けるだけで、同じキーで QCode のモデルを呼び出せます。別のベンダーのアカウントを開く必要はありません。

先に一言:n8n の UI は現在英語のみで、中国語版 Windows で開いても英語で表示されます。本記事で「」で囲んだボタン名とメニュー名は、スクリーンショットに写っている英語の原文です。そのまま入力してください。

  • 対象環境:Windows 10 / 11(64 ビット)
  • ソフトウェアのバージョン:n8n 2.48.7(Node.js v24.22.3 LTS、npm 11.19.1 と組み合わせ)
  • スクリーンショット更新:2026-11
  • 所要時間:20 分(初回の npx n8n は依存関係のダウンロードに時間がかかるので、気長に待ってください)
  • 用意するもの:cr_ で始まる QCode の API キー 1 本、Node.js 20.19–24.x(LTS 推奨)、Edge または Chrome ブラウザ
  • PC が Windows 10 / 11(64 ビット)で、「Windows PowerShell」または「Windows ターミナル」を開けること
  • nodejs.org、registry.npmjs.org、localhost:5678、api.qcode.cc にアクセスできること
  • QCode.cc に登録済みで、ダッシュボードで cr_ で始まる API キーをコピーしてあること。アカウントがまだない場合は、先にQCode に登録し、料金ページでプランを選んでから、ダッシュボードでキーを作成してください
  • n8n 公式サイトのアカウントも OpenAI アカウントも不要です。n8n を初めて開いたときに作るローカルアカウントは、自分の PC の中だけに存在します
  • 中断されない約 20 分を確保してください。途中で PowerShell のウィンドウを閉じないでください

ダウンロードとインストール

n8n には Windows 用の .exe インストーラーがありません。公式の旧デスクトップ版はすでにメンテナンスが終了しているので、もうダウンロードしないでください。Windows で最も手軽な方法は、先に Node.js を入れてから、PowerShell で npx n8n を直接実行するやり方です。管理者権限もグローバルインストールも要りません。

公式の入口:

地域によってネットワークの状況が異なるので、まず自分の地域を選んでください:

  • 同じく nodejs.org/en/download から v24.22.3 LTS の Windows Installer (.msi) をダウンロードし、ダブルクリックしてインストールします。ウィザードは既定のオプションでかまいません。
  • winget も使えますが注意が必要です。OpenJS.NodeJS.LTS は現在 v26 を指しており、それを入れると n8n が起動に失敗することがあるため、やはり上記の方法で v24.x の MSI を選ぶことをおすすめします。
  • ブラウザからダウンロードした .msi は「Windows によって PC が保護されました」で止まることがあります。「詳細情報」→「実行」で先に進めます。
  • nodejs.org/en/download を開き、ページ上部のバージョン選択欄で手動で v24.22.3 LTS を選びます(既定は v26 で、n8n はまだ安定して動きません)。プラットフォームは Windows、アーキテクチャは x64 を選びます。
  • ページ下部の緑色のボタン「Windows Installer (.msi)」をクリックしてインストーラーをダウンロードし、ダブルクリックしてウィザードの「Next」を順にクリックします。「ユーザーアカウント制御」が出たら「是」(はい)をクリックします。
  • ページのバージョン選択欄が開かない、またはダウンロードが非常に遅いときは、しばらく待ってからもう一度クリックしてください。インストール後は必ず PowerShell のウィンドウを閉じて開き直してください。新しい Node はそれから有効になります。

スクリーンショットのとおりに進める:Windows を 1 ステップ 1 枚で

以下の 13 ステップは 1 ステップにつき 1 つだけ行います。コマンドはすべて同じ「Windows PowerShell」ウィンドウに入力します。スクリーンショット上のオレンジ色の番号と本文の ①②③ は 1 対 1 で対応しています。

n8n が使える Node.js インストーラーをダウンロードする

ブラウザで https://nodejs.org/en/download を開き、まず ① のバージョン選択欄で v24.22.3 LTS を選び、プラットフォームは Windows、アーキテクチャは x64 のままにします。次に ② の緑色のボタン「Windows Installer (.msi)」をクリックしてインストーラーをダウンロードします。

Node.js 公式ダウンロードページ。上部のバージョン選択欄は v24.22.3 LTS と Windows が選ばれており(1)、ページ下部に緑色の Windows Installer (.msi) ボタンがある(2)

うまくいけば:バージョン選択欄に v24.22.3 LTS が表示され、node-v24.22.3-x64.msi のような名前のファイルのダウンロードが始まります。

困ったとき:ダウンロードページの既定が v24 ではない

ページの既定はより新しい v26 で、n8n 2.48.7 はこれだと起動に失敗します。必ず選択欄で v24.22.3 LTS に切り替え、ボタンのバージョン番号も変わったことを確認してからダウンロードをクリックしてください。

インストール後に PowerShell を開き直してバージョンを確認する

ダウンロードした .msi をダブルクリックし、ウィザードの「Next」を順にクリックしてインストールします。その後、PowerShell のウィンドウを完全に閉じて、新しいウィンドウを開き直し、node -v と npm -v を順に入力します。① には v24.22.3、② には 11.19.1 が出力されるはずです。

Windows ターミナル(PowerShell)で node -v を実行して v24.22.3 を出力(1)、続いて npm -v を実行して 11.19.1 を出力(2)。プロンプトのユーザー名はマスク済み

うまくいけば:v24.22.3 と 11.19.1 の 2 行がきれいに表示され、その前に自分のプロンプトがあり、赤いエラーは出ていません。

困ったとき:node または npm が内部コマンドまたは外部コマンドとして認識されない

Node.js が正しく入っていないか、インストール後にウィンドウを開き直していない可能性があります。まず今の PowerShell を閉じて(最小化ではなく)、開き直してからもう一度試してください。それでもだめなら MSI インストーラーをもう一度実行し、インストールウィザードの「Add to PATH」にチェックが入っていることを確認してください。

npx で n8n のローカルサービスを起動する

同じ PowerShell ウィンドウで npx n8n と入力して Enter を押します。初回は依存関係のダウンロードで 1〜2 分かかることがあります。ターミナルのスクロールが止まったら、2 行を確認します。① が Version: 2.48.7、② が Editor is now accessible via: http://localhost:5678 です。

PowerShell で npx n8n を実行した後の起動ログ。ターミナル下部に Version: 2.48.7(1)と Editor is now accessible via: http://localhost:5678(2)が表示されている

うまくいけば:ターミナルが Editor is now accessible via: http://localhost:5678 で止まり、カーソルが勝手にスクロールしなくなります。このウィンドウはこの後もずっと開いたままにしてください。

困ったとき:「パブリックネットワークとプライベートネットワークでこのアプリにアクセスを許可しますか?」というダイアログが出る

これは Windows ファイアウォールが、Node.js にローカルポートを待ち受けさせてよいかを尋ねているものです。「許可」をクリックすればよく、以後は出ません。ターミナルでポートが使用中と表示された場合は、まずこのウィンドウの n8n を止め、$env:N8N_PORT = 5679; npx n8n に変えてから、http://localhost:5679 を開いてください。

n8n を開いてローカルアカウントを作成する

ブラウザで http://localhost:5678 にアクセスすると、自動的に Set up owner account ページに移動します。① のフォームに Email、First Name、Last Name、Password を順に入力します(パスワードは 8 文字以上で、数字 1 つと大文字 1 つを含めます)。入力できたら ② のピンク色のボタン「Next」をクリックします。

n8n の Set up owner account ページ。中央のフォームにメールアドレス、名、姓、パスワードが順に並び(1)、下にピンク色の Next ボタンがある(2)。メールアドレスと氏名はマスク済み

うまくいけば:「Next」をクリックするとページが切り替わり、Customize n8n to you という小さなアンケートが表示されます。ローカルアカウントが作成できた証拠です。

困ったとき:ページが開かない、または先ほどのパスワードを忘れた

ページが開かないときは、まず PowerShell に戻ってターミナルが Editor is now accessible via: で止まっていることを確認し、ウィンドウを閉じていないことを確かめてから再読み込みしてください。ローカルのパスワードを忘れた場合は、Ctrl+C で n8n を停止し、npx n8n user-management:reset を実行してローカルアカウントをリセットしてから、もう一度 http://localhost:5678 にアクセスしてください。

初回ガイドを順に進めて空のキャンバスに入る

続けて順にクリックします:アンケートダイアログ右下の「Get started」→ ライセンスダイアログ左下の「Skip」→ アシスタントページの「Got it」→ ページ下部の「Set up later in Settings」→ Let's build your first automation ページ右側の「Build a workflow」。キャンバスに入ると、中央に ① の「Add first step...」プラスブロックがあります。

アンケート、ライセンスの案内、n8n Assistant のガイドをスキップした後、空のワークフローキャンバス中央に Add first step... のプラスブロックがある(1)

うまくいけば:キャンバスの中央に「Add first step...」ブロックが 1 つだけあり、周囲は空のグレーの背景で、左側のナビゲーションバーは折りたたまれています。

OpenAI ノードを検索して選択する

キャンバス中央の「Add first step...」をクリックすると、右側にノードパネルがスライドして出てきます。① の検索欄に OpenAI と入力し、次に ② の最初の項目「OpenAI」をクリックします(下に Message an assistant or GPT... と書かれています)。

右側のノードパネルの検索欄に OpenAI を入力(1)。検索結果の最初の項目が OpenAI ノード(2)

うまくいけば:検索欄の下に OpenAI に関係する結果だけが数件残り、最初の項目が「OpenAI」になります。

困ったとき:OpenAI が見つからない

検索欄には OpenAI の 6 文字だけを入力し、他の単語や引用符を付けないでください。一覧には「OpenAI Chat Model」と「Microsoft Foundry Chat Model」もありますが、本記事で使うのはそれらではないのでクリックしないでください。

TEXT ACTIONS の下で Message a model を選ぶ

「OpenAI」をクリックするとアクション一覧に進みます。まず下にスクロールして TEXT ACTIONS グループを探し、① の「Message a model」をクリックします。

OpenAI のアクション一覧で、TEXT ACTIONS グループの下にある Message a model の項目(1)

うまくいけば:n8n がキャンバス左側に手動トリガー「When clicking 'Execute workflow'」を自動で追加し、同時に「Message a model」のパラメーターダイアログが表示されます。

まず Connect to OpenAI をクリックして認証情報を作成する

パラメーターダイアログではパラメーターを変更せず、まず認証情報を作成します。① の「Connect to OpenAI」をクリックします。同時に ② の 2 行の既定値を確認します。Resource が Text、Operation が Message a Model で、そのままにしておけば正しいです。

Message a model ノードのパラメーターパネル。Credential の下に Connect to OpenAI ボタン(1)、既定のままの Resource: Text と Operation: Message a Model(2)

うまくいけば:画面中央に「OpenAI account」というタイトルの認証情報ダイアログが表示され、キャンバス上のノードは一時的に隠れます。

QCode のキーと接続先を入力する

認証情報ダイアログで:① の API Key に cr_ で始まるキーを貼り付け(図ではマスク済み)、Organization ID は空のままにします。② の Base URL はまず Ctrl+A で全選択して既定値を削除し、https://api.qcode.cc/openai/v1 を入力します。最後に ③ の右上の「Save」をクリックします。

OpenAI account の認証情報ダイアログ。API Key にはマスクされた cr_ キー(1)、Base URL は https://api.qcode.cc/openai/v1 に変更済み(2)、右上が Save ボタン(3)

うまくいけば:Base URL の行に https://api.qcode.cc/openai/v1 が完全に表示され(末尾は /v1 で、/v1/v1 ではありません)、Organization ID の中は空です。

API キーが必要ですか?

QCode のアカウントがまだない場合は、先にQCode に登録してください。実際の使用量に応じて支払う場合は、先にクォータパックを購入し、ダッシュボードでキーを作成します。cr_ で始まる文字列を丸ごとコピーして、API Key に貼り付けてください。クレジットカード / デビットカード(Visa / Mastercard)、Apple Pay / Google Pay、暗号資産で支払えます。詳しくは支払い方法をご覧ください。

認証情報が保存できたことを確認する

「Save」をクリックすると、n8n が自動的にこのキーでモデル一覧を 1 回取得し、通ればダイアログが自然に閉じます。2 か所を確認します。① の Credential に「OpenAI account」が自動選択され、② の右下に緑色の「Credential successfully created inside your personal space」が表示されます。

認証情報ダイアログが閉じた後、Credential は OpenAI account が選択済み(1)、右下に緑色の Credential successfully created inside your personal space の通知(2)

うまくいけば:右下から緑色の通知が現れ、Credential のドロップダウンに「OpenAI account」が表示され、ノードに赤い感嘆符が付いていません。

困ったとき:保存時にエラーになる、またはモデルが見つからないと表示される

3 つのことを順に確認してください。1)キーは cr_ で始まる文字列だけをコピーし、前後に空白や引用符がないか。2)Base URL は https://api.qcode.cc/openai/v1 で、/chat/completions を付けたり /v1/v1 にしたりしていないか。3)Organization ID が空か。直したらもう一度「Save」をクリックしてください。

Model で gpt-6.2-sol を選ぶ

Model の「Choose...」ドロップダウンをクリックすると、n8n が QCode のモデル一覧を自動で取得します。① の検索欄に gpt-6.2-sol と入力し、下に表示される「GPT-6.2-SOL」をクリックします。

Model ドロップダウンで gpt-6.2-sol を入力すると、一覧に選択可能な GPT-6.2-SOL が表示される(1)

うまくいけば:Model の行に「GPT-6.2-SOL」が表示され、ドロップダウンが閉じます。一覧には GLM-5.2、DEEPSEEK-V4-FLASH などの他のモデルも見えます。

困ったとき:ドロップダウンが空

前のステップの Base URL が正しく保存されていないためです。Credential の「OpenAI account」をクリックして編集し直し、Base URL が https://api.qcode.cc/openai/v1 であることを確認してから「Save」をクリックします。その後ノードのダイアログを閉じて開き直すと、ドロップダウンがモデル一覧を再読み込みします。

一言書いてこのノードを実行する

① の Prompt 入力欄に一言を入力します。たとえば「你好,用一句话介绍你自己」です。次に ② の「Execute step」をクリックしてリクエストを送り、数秒待って ③ の OUTPUT パネルを見ます。

ノードのパラメーターで Prompt に中国語の質問を入力済み(1)、上部が Execute step ボタン(2)、右側の OUTPUT パネルに緑のチェックマークとモデルから返った中国語の返答(3)

うまくいけば:OUTPUT の上部に緑のチェックマークが付き、中に role: assistant、status: completed があり、モデルの中国語の返答は output[0].content[0].text フィールドに入っています。

パラメーターダイアログを閉じてワークフローを保存する

ノードダイアログの右上の × をクリックしてキャンバスに戻り、Ctrl+S で保存します。① で囲まれた位置に 2 つのノードが見えます。左が手動トリガー、右が「Message a model」で、どちらにも緑のチェックマークが付いています。

保存後のワークフローキャンバス。手動トリガーと Message a model の 2 つのノードに緑のチェックマークが付いている(1)

うまくいけば:キャンバス上の 2 つのノードが 1 本の線でつながり、どちらも緑色です。F5 でページを再読み込みしても、このワークフローは残っています。

動作を確認する

4 つがすべて当てはまれば、n8n は QCode に完全につながっています:

  • PowerShell の node -v が v24.22.3、npm -v が 11.19.1 を出力する
  • ターミナルが Editor is now accessible via: http://localhost:5678 で止まり、ブラウザで http://localhost:5678 を開ける
  • 認証情報の保存時にエラーがなく、Model のドロップダウンで「GPT-6.2-SOL」を選べる
  • 「Execute step」をクリックすると OUTPUT に緑のチェックマークが現れ、output[0].content[0].text にモデルの中国語の返答が入っている

すべて完了

自分の Windows 11 で n8n を起動し、QCode のモデルで作業できるようになりました。次はこちらへ:

よくあるエラー

エラーメッセージ 原因 対処
Error ブラウザが n8n の Web サービスより先に開かれ、ローカルページがまだ応答を返していない PowerShell に戻って Editor is now accessible via: http://localhost:5678 が表示されていることを確認し、ページを再読み込みしてください。アドレスは http://localhost:5678 でなければならず、https は使えません
https://api.openai.com/v1 認証情報の Base URL がまだ公式の既定値で、リクエストが QCode にまったく届いていない Base URL を https://api.qcode.cc/openai/v1 に変更して「Save」をクリックし、ノードのダイアログを閉じて開き直してモデル一覧を再読み込みさせてください
Import Workflow? カーソルが入力欄にない状態で貼り付けを行い、キャンバスがクリップボードの中身をワークフローのインポートとみなした キャンセルをクリックし、「OpenAI account」の認証情報ダイアログを開き直して、API Key 入力欄にカーソルを置いてから cr_ キーを貼り付けてください
sqlite3 使用している Node.js のバージョンが新しすぎる(たとえば v26)ため、n8n のネイティブ依存関係に対応するプリビルドファイルがない Node.js 20.19–24.x(本記事では v24.22.3 LTS)に戻し、PowerShell を閉じて開き直してから、もう一度 npx n8n を実行してください
confluent-kafka-javascript 同上。Node.js のバージョンが n8n のサポート範囲外で、依存関係をローカルでビルドし直す必要がある 同上:v24.22.3 LTS に変えて入れ直し、npx n8n を実行してください。winget で入る v26 は使わないでください

よくある質問

キーの有効期限が切れたらどうなりますか?

2 つの場合があります:

  • 個人プランのキーは、期限が切れると更新できません。新しく契約し直して、新しいキーに切り替える必要があります。
  • クォータパックのキーは、期限が切れた後にもう一度パックを購入すると、同じキーがそのまま使えるようになります。

新しいキーに替えた後は、n8n の「OpenAI account」認証情報ダイアログに戻り、API Key を新しいものに変えて「Save」をクリックするだけです。他のフィールドは変更不要です。

n8n の UI は中国語にできますか?

いいえ。n8n 2.48.7 は英語の UI しか内蔵しておらず、中国語版 Windows で開いても英語のままです。本記事で「」で囲んだボタン名は、スクリーンショット上の英語の原文です。そのとおりにクリックしてください。会話の内容自体は中国語でかまいません。

Claude モデルを使いたいときは?

n8n の OpenAI ノードは OpenAI 互換のアドレスにしかリクエストを送れません。QCode の OpenAI 互換エンドポイント https://api.qcode.cc/openai/v1 は Claude シリーズを提供していないため、このチュートリアルでは gpt-6.2-sol を使います。Claude は Anthropic 互換アドレス https://api.qcode.cc/api を使い、既定の推奨モデルは claude-opus-5-5、軽量な代替は claude-haiku-5-5 です。

PowerShell を閉じても n8n は使えますか?

いいえ。npx n8n はそのウィンドウの中で動いているので、ウィンドウを閉じるとサービスが止まり、http://localhost:5678 も開けなくなります。バックグラウンドで常駐させたい場合は、公式の Docker でのデプロイに切り替えてください。自分で使うだけなら、毎回そのウィンドウを開き直して npx n8n をもう一度実行すれば十分です。以前に作成したワークフローと認証情報はローカルに保存されているので、失われません。

ポート 5678 が使用中なときは?

別のポートで起動します。PowerShell で $env:N8N_PORT = 5679; npx n8n を実行し、ブラウザで http://localhost:5679 を開いてください。ポートを変えると古いアドレスは開けなくなる点に注意してください。

その他の接続ポイント

QCode には 3 つの接続ドメインがあり、機能は同じでネットワーク経路だけが異なります。同じキーがそのまま使えます。中国本土のネットワークで api.qcode.cc が不安定な場合は、アジアノードに切り替えて、認証情報の Base URL を書き換えてから「Save」をクリックするだけです:

ノード OpenAI 互換(本記事で使用) Anthropic 互換(Claude)
グローバル https://api.qcode.cc/openai/v1 https://api.qcode.cc/api
アジア https://asia.qcode.cc/openai/v1 https://asia.qcode.cc/api
北米 / ヨーロッパ https://us.qcode.cc/openai/v1 https://us.qcode.cc/api

パラメーターの説明

「Message a model」ノードでよく使う項目:

パラメーター 入力内容 説明
Credential OpenAI account QCode のキーと Base URL を保持し、複数のノードで同じものを共有できます
Resource Text 既定のまま
Operation Message a Model 既定のまま
Model gpt-6.2-sol ドロップダウンに QCode が提供するすべてのモデルが並びます
Prompt 中国語の質問を 1 文 モデルに送る内容
Simplify 既定で有効 オフにすると元の戻り値の構造を完全に見られます

出力パスは output[0].content[0].text で、同時に role: assistant、status: completed、phase: final_answer の各フィールドを持ちます。後続のノードでこの返答を使いたいときは、このパスを参照します。

応用:定期的に自動実行させる

動作確認ができたら、左側の「When clicking 'Execute workflow'」トリガーを別のトリガーに置き換えれば、手動でクリックせずに実行できます:

  • 定期実行:手動トリガーを削除し、キャンバスで Schedule Trigger を検索して、時間単位または日単位で時刻を設定します
  • メッセージ受信で実行:Webhook トリガーに置き換えると、n8n がローカルのアドレスを発行し、他のプログラムがそこにアクセスすると実行されます
  • 結果の処理:「Message a model」の後ろに Set ノードをつなぎ、output[0].content[0].text をフィールドとして保存してから、メール、表、チャットツールにつなぎます

関連ドキュメント

QCode を始める

API キーひとつで Claude Code・Codex などに対応。トークン単位の課金で、各モデルの単価は qcode.cc/models に掲載

企業版 →