# OpenCodeの機能と実践的な使い方
✨ 「まず計画、それから実装」。OpenCodeの基本操作を覚えると、AIに安心して任せながら、いつでも変更を巻き戻せる開発リズムが手に入ります。
🏷️ タイトル: @検索・Plan/Build・画像・/undo・/redo
🔗 URL:
📘 概要
OpenCodeの日々の操作は、ファイル参照・エージェントモードの切替・画像入力・取り消し/やり直しといった少数の基本操作に集約されます。これらを押さえるだけで、対話的なコーディングがスムーズになります。
⚙️ 機能の説明
・`@`によるファイル参照: メッセージ内で `@` を入力するとファイル名のあいまい検索(fuzzy search)が起動し、対象ファイルを文脈に含めて質問できます。`!` を先頭に付けるとシェルコマンドを実行し、その出力をツール結果として渡せます。
・Plan/Buildの切替: Planは編集やbashが「ask(確認)」に制限された計画用モード、Buildは全ツールにアクセスできる実装モードです。`Tab` キーで両者を切り替えます。
・画像入力: 画像をターミナルにドラッグ&ドロップして、エラー画面やデザインなどを視覚情報として渡せます。
・`/undo`と`/redo`: `/undo` は直前のメッセージとそれに伴うファイル変更を取り消します。複数回実行でさらに前へ戻れます。`/redo` は取り消した変更をやり直します。
🛠️ 実践的な使い方
1. まずPlanモードで `@/src/api/handler.ts のリファクタ計画を立てて` のように依頼し、計画を確認します。
2. 納得したら `Tab` でBuildに切り替え、実装させます。
3. 結果が思わしくなければ `/undo` で巻き戻し、必要なら `/redo` でやり直します。
具体的には `@/src/payment.ts のバグを調べて` のように `@` で参照し、`Tab` でPlanからBuildへ、`/undo` で取り消し(複数回可)、`/redo` でやり直し、という流れです。
💡 ユースケース
影響範囲の大きいリファクタは、まずPlanで方針を固めてからBuildで実装すると安全です。AIの変更が期待と違っても `/undo` で即座に元に戻せるため、試行錯誤のコストが下がります。
⚠️ 注意点
・`/undo` はメッセージ単位での巻き戻しです。手動で加えた変更との混在には注意してください。
・Planモードでも編集が「ask」で許可される構成だと、確認に応じれば変更され得ます。承認時はよく確認しましょう。
・画像のドラッグ&ドロップ対応はターミナルエミュレータに依存します。
#
OpenCode# #
AICoding#