Betaflight CLI入門｜diff・dump・setだけ覚えれば怖くない

BetaflightのCLI（Command Line Interface）は黒い画面に文字だけ——初心者が避けて通りがちですが、実際に使うコマンドは4つだけです。むしろGUIより速くて確実な場面が多く、覚えると設定作業が別物になります。

日常で使う4コマンド

• diff all：デフォルトから変更した設定の一覧を出力。これをコピーして保存する＝機体の完全バックアップです。設定をいじる日は作業前後で必ず取る
• get <名前>：設定値の確認。名前の一部でも検索できます（例：get vtxでVTX関連が全部出る）
• set <名前> = <値>：設定の変更（例：set small_angle = 180）
• save：保存して再起動。saveを打つまで変更は反映されません（打ち忘れが初心者の定番）

これにファーム更新時の復元（diffの貼り付け）が加わる程度で、日常のCLIは完結します。

コピペ設定の正しい使い方

当サイトのBetaflight設定コピペ集を含め、CLIスニペットを貼る文化がFPVにはあります。安全に使う3原則：

1. 貼る前にdiff allでバックアップ（戻せる状態を作る）
2. 1行ずつ意味を眺める：setが何を変えるのか、雰囲気だけでも把握する。理解できない長文スニペットは貼らない
3. 貼ったらsave→ペラなしベンチ確認：モード・回転方向・フェイルセーフの3点だけでも

ちょっと便利な応用

• status：アーム拒否の理由・センサー状態・CPU負荷が一望できる万能診断（アームしない時の第一手）
• resource：ピン割り当ての確認。改造・修理時に
• beeper_all系ではなくbeacon：失機ビーパーの設定（ロスト対策）
• bl：DFUモードに入って再起動（ボタンを押しにくい機体で便利）

❓ FAQ — よくある質問

Q.CLIで変な値を入れて壊れない？▾

A.

設定値で物理的に壊れることはまずなく、diffがあれば必ず戻せます。最悪でも「defaults」コマンド＋diff貼り直しで工場出荷からやり直せます。バックアップさえあればCLIは安全な遊び場です。

Q.GUIとCLI、どっちで設定すべき？▾

A.

どちらでも同じ設定を触っています。視覚的に分かりやすいものはGUI（モード・OSD配置）、確実に記録・再現したいものはCLI、が実用的な使い分けです。

---

▶ あわせて読みたい：Betaflight設定コピペ集 ／ ファームウェア更新のやり方 ／ 初期設定ガイド