QMKの使い方｜ファームとビルド基礎

January 1, 2026April 15, 2026

結論：初心者ならまずVIA/VIALを使い、より細かいカスタマイズをしたくなったらQMKに移行するのが最も効率的です。

QMKは自由度が非常に高い反面、環境構築や設定に手間がかかるため、最初から使うより段階的に移行したほうが失敗しにくいです。

QMKファームウェアとは？VIAやVIALとの違いも解説

QMKファームウェアは、カスタムキーボードのキー配列や機能を自分好みに変更するためのオープンソースソフトウェアです。キー入力の挙動をプログラムレベルで制御できるため、市販のキーボードでは不可能な高度なカスタマイズを実現します。

例えば、特定のキーを長押しした時だけ別のキーとして機能させたり、複数のキー入力を一つのキーに割り当てるマクロを作成したりできます。自由度が高い反面、設定には専門的な知識が少し必要です。

一方で、VIAやVIALはQMKをベースにした、より直感的にキーマップを変更できるツールです。プログラミング不要で、専用のアプリケーション上でリアルタイムに設定を反映できます。

QMKとVIA/VIAL、あなたに合うのはどっち？

どちらを選ぶべきか迷う方のために、それぞれの特徴を比較表にまとめました。手軽に始めたいならVIA/VIAL、究極のカスタマイズを求めるならQMKがおすすめです。

項目	QMK Firmware	VIA / VIAL
設定方法	C言語（keymap.c）の編集とビルドが必要	専用GUIアプリでリアルタイムに変更
自由度	非常に高い（マクロ、LED制御など全て可能）	QMKの機能の一部に限定される
難易度	高い（環境構築やコマンド操作が必要）	低い（プログラミング不要）
設定反映	変更の都度、ファームウェアの書き込みが必要	即時反映（書き込み不要）
おすすめな人	・キーボードの機能を極限まで追求したい人・プログラミングに挑戦したい人	・手軽にキーマップを変更したい初心者・複数の配列を試したい人

この記事では、最も自由度の高いQMKファームウェアのビルドと書き込み方法に焦点を当てて、初心者でも再現できるよう丁寧に解説します。

QMKファームウェア導入の前に｜必要な準備と注意点

QMKのビルド作業を始める前に、必要なツールと環境を整えましょう。事前の準備をしっかり行うことで、後のトラブルを大幅に減らすことができます。

必要なソフトウェア・ツール一覧

以下のソフトウェアを公式サイトからダウンロードし、PCにインストールしてください。すべて無料で利用できます。

QMK MSYS：WindowsでQMKのビルド環境を簡単に構築するためのツールです。コマンドライン操作の基盤となります。
QMK Toolbox：ビルドしたファームウェアをキーボードに書き込む（フラッシュする）ためのGUIツールです。ドライバーのインストールも自動で行ってくれます。
テキストエディタ：キーマップを編集するためのソフトウェアです。「Visual Studio Code」や「Sublime Text」など、プログラミング向けのものがおすすめです。Windows標準のメモ帳は文字コードの問題を起こす可能性があるため避けてください。

必要なハードウェアと予備部品

作業にはPCと対象のキーボード本体の他に、以下のものがあると安心です。

PCとキーボードを接続するUSBケーブル：データ転送に対応したケーブルが必要です。充電専用ケーブルではキーボードが認識されないため注意してください。
リセット用具（ピンセットやクリップ）：キーボードを書き込みモード（DFUモード/Bootloaderモード）にする際に、基板上のリセットボタンや特定のピンをショートさせるために使います。金属製のものを用意しましょう。
（任意）予備のマイクロコントローラー：万が一、書き込みに失敗してマイクロコントローラー（Pro Microなど）が故障した場合に備えて、予備があると精神的に安心です。必須ではありません。

全体の所要時間と作業時の注意点

全体の所要時間は、初めての方で約1時間〜2時間が目安です。環境構築で30分、キーマップ編集とビルドで30分、書き込みとトラブルシューティングで30分程度を見込んでおくと良いでしょう。

作業中は以下の点に注意してください。

公式ドキュメントを併用する：QMKは常にアップデートされています。この記事と合わせて、QMK公式ドキュメントも参照することをおすすめします。
バックアップを取る：編集する前のキーマップファイル（keymap.c）は必ずコピーしてバックアップを取っておきましょう。いつでも元の状態に戻せるようにしておくことが重要です。
焦らず一つずつ確認する：エラーが出ても慌てず、メッセージをよく読んでください。ほとんどのエラーは、タイプミスや手順の見落としが原因です。

【5ステップ】QMKファームウェアの使い方｜ビルドから書き込みまでの全手順

ここからは、QMKファームウェアをビルドし、キーボードに書き込むまでの具体的な手順を5つのステップに分けて解説します。Windows環境での「QMK MSYS」を使った方法を基本とします。

STEP1：QMKビルド環境をセットアップする

最初に、お使いのPCでQMKファームウェアをビルド（プログラムをコンパイルして実行ファイルを作ること）できる環境を構築します。QMK MSYSを使えば、必要なツールを一括でインストールできます。

QMK公式サイトから「qmk_msys.exe」をダウンロードし、実行します。
インストーラーの指示に従い、デフォルト設定のままインストールを進めます。
インストールが完了したら、デスクトップに作成された「QMK MSYS」のショートカットをダブルクリックして起動します。黒いコマンドプロンプト画面が表示されればOKです。
以下のコマンドを入力し、Enterキーを押してQMKのセットアップを実行します。必要なファイルが自動でダウンロード・設定されます。 qmk setup
「QMK is ready to go!」というメッセージが表示されたら、環境構築は完了です。この処理には数分かかる場合があります。

もし途中で「Do you want to clone the QMK firmware repository?」と聞かれたら、「y」と入力してEnterを押してください。これにより、QMKの全ソースコードがPCにダウンロードされます。

STEP2：自分のキーボード用のキーマップファイルを用意する

次に、カスタマイズの土台となるキーマップファイルを作成します。既存のキーボードのテンプレートをコピーするのが最も簡単で確実な方法です。

エクスプローラーでそのフォルダを開き、中にkeymap.cというファイルがあることを確認してください。このファイルが、あなたのキーボードの設計図です。

自分のキーボード名が分からない場合は、qmk_firmware\keyboardsフォルダ内を探すか、キーボードの販売元の商品ページで確認できます。

STEP3：キーマップファイル（keymap.c）を編集する

いよいよ、キーボードの配列をカスタマイズする工程です。STEP2で作成したkeymap.cファイルを、VS Codeなどのテキストエディタで開いて編集します。

ファイルを開くと、const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = { ... };という記述が見つかります。この{ ... }の中身がキー配列を定義している部分です。

基本的なキーの変更方法

キーの割り当ては、KC_A（Aキー）、KC_ENT（Enterキー）のような「キーコード」で指定します。例えば、AキーとBキーの位置を入れ替えたい場合は、KC_AとKC_Bの記述を入れ替えるだけです。

// 変更前
KC_A, KC_B, KC_C,
// 変更後
KC_B, KC_A, KC_C,

主要なキーコードは公式ドキュメントのキーコード一覧で確認できます。最初は、Caps LockをCtrlキーに変更する（KC_CAPSをKC_LCTLに変更）など、簡単な変更から試してみるのがおすすめです。

レイヤー機能を使ってみよう

QMKの強力な機能の一つが「レイヤー」です。Fnキーを押している間だけ、数字キーをファンクションキー（F1, F2…）として機能させる、といった設定が可能です。

keymap.c内で、[0]や_BASEと書かれている部分が基本レイヤー、[1]や_RAISEと書かれている部分がFnキーなどを押したときのレイヤーです。レイヤーを切り替えるためのキーコード（MO(1)など）を基本レイヤーのどこかに配置し、対応するレイヤーの配列を定義します。

STEP4：編集したキーマップをビルド（コンパイル）する

キーマップの編集が完了したら、それをキーボードが読み込める形式のファイル（ファームウェアファイル）に変換します。この作業を「ビルド」または「コンパイル」と呼びます。

ビルドが開始され、処理中のログが流れます。これには数分かかることがあります。
最後に緑色の文字で「.hex firmware is available at:」や「.bin firmware is available at:」と表示され、.hexまたは.binファイルの場所が示されたらビルド成功です。

もしビルド中にエラー（赤色の文字）が出た場合は、keymap.cの記述にミスがある可能性が高いです。エラーメッセージをよく読み、カンマの抜けやスペルミスがないか確認しましょう。

STEP5：ファームウェアをキーボードに書き込む（フラッシュ）

最後に、ビルドして作成されたファームウェアファイルをキーボード本体に書き込みます。この作業を「フラッシュ」と呼び、QMK Toolboxを使用します。

QMK Toolboxを起動します。
「Open」ボタンを押し、STEP4で作成された.hexまたは.binファイルを選択します。
キーボードをPCに接続します。
キーボードをリセット（DFU/Bootloader）モードにします。方法はキーボードによって異なりますが、主に以下の方法があります。
- 基板の裏にある物理的な「リセットボタン」を短く押す。
- 特定のキー（多くはSpace + B）を押しながらUSBケーブルを接続する。
- 基板上の「RESET」と「GND」と書かれた2つのピンをピンセットなどで一瞬だけ接触させる（ショートさせる）。
正しくリセットモードになると、QMK Toolboxのログウィンドウに黄色い文字で「*** DFU device connected」や「*** Caterina device connected」といったメッセージが表示されます。
このメッセージが表示されたのを確認したら、すぐに「Flash」ボタンをクリックします。
書き込みが始まり、数秒後に「Flash complete」や「Rebooting」といったメッセージが表示されれば成功です。

キーボードが自動的に再起動し、編集した新しいキーマップで動作するようになります。変更したキーが意図通りに機能するか確認してください。

もっと簡単に！GUIで完結する「QMK Configurator」の使い方

コマンドライン操作やC言語の編集に抵抗がある初心者の方には、Webブラウザ上で完結する「QMK Configurator」がおすすめです。ビルド環境の構築が不要で、直感的にキーマップを作成できます。

QMK Configuratorにアクセスします。
「KEYBOARD」のドロップダウンメニューから、お使いのキーボードを選択します。
画面に表示されたキーボードレイアウト上で、変更したいキーをクリックします。
画面下のキーコード一覧から、割り当てたい機能のキーをドラッグ＆ドロップで配置します。
レイヤーの追加や変更も、画面上部のタブで切り替えながら同様に行えます。
カスタマイズが完了したら、画面右上の「COMPILE」ボタンをクリックします。ビルドが開始され、しばらくすると「FIRMWARE」ボタンが緑色に変わります。
「FIRMWARE」ボタンをクリックすると、.hexまたは.binファイルがダウンロードされます。
ダウンロードしたファイルを、前述の「STEP5」と同様の手順でQMK Toolboxを使って書き込めば完了です。

QMK Configuratorは非常に手軽ですが、マクロの複雑な設定やLED制御など、一部の高度な機能には対応していません。基本的なキー配列の変更であれば、こちらで十分対応可能です。

QMKでつまずきやすいポイントと解決策

QMKの導入では、いくつかの定番のつまずきポイントがあります。エラーが出ても焦らず、以下の対処法を試してみてください。

ビルドエラーが出てしまい、ファームウェアが作成できない

最もよくあるトラブルがビルドエラーです。原因のほとんどはkeymap.cファイルの記述ミスです。

解決策1：エラーメッセージを読む
QMK MSYSに表示されるエラーメッセージには、エラーが発生したファイル名と行数が記載されています。その箇所を中心に、カンマ（,）の抜け、括弧（{}）の閉じ忘れ、キーコードのスペルミスがないか確認してください。
解決策2：元のファイルと比較する
バックアップしておいた変更前のkeymap.cと、編集後のファイルを見比べてみましょう。差分を確認できるツール（WinMergeなど）を使うと、間違いを見つけやすくなります。
解決策3：デフォルトのキーマップでビルドしてみる
まず、何も編集していないデフォルトのキーマップ（default）でビルdができるか試してみましょう。（qmk compile -kb <keyboard> -km default）これで成功するなら、問題はあなたの編集したkeymap.cファイル内に限定されます。

キーボードをリセットモードにできない・PCが認識しない

ファームウェアの書き込みには、キーボードをリセットモードにする必要がありますが、ここで手こずるケースも多いです。

解決策1：リセット方法を再確認する
キーボードによってリセット方法は様々です。リセットボタンの場所、ショートさせるピンの位置、特定のキーの組み合わせなど、お使いのキーボードの公式ドキュメントや説明書で正しい方法をもう一度確認してください。
解決策2：USBケーブルとポートを変える
使用しているUSBケーブルがデータ転送に対応しているか確認してください。また、PCの別のUSBポートに接続すると認識されることがあります。特にUSBハブを介している場合は、PC本体のポートに直接接続してみてください。
解決策3：ドライバーを再インストールする
QMK Toolboxのメニューから「Tools」→「Install Drivers」を実行し、ドライバーを再インストールしてみてください。これにより認識の問題が解決することがあります。