OpenCode: OpenCode TUI (Terminal User Interface)
最終更新：2026-08-31
--- title: OpenCode TUIターミナルインターフェース description: OpenCodeのターミナルユーザーインターフェース（TUI）を深く理解し、スラッシュコマンド、ファイル参照、ショートカットキーなどのコアインタラクション方式を習得する order: 7 lang: ja
TUIはOpenCodeのコア使用方式で、すべてのコード分析、修正、実行はこのインターフェースを通じて行われます。
1. 学習内容
- TUIの起動と基本インタラクション
- ファイル参照（@）機能
- Shellコマンド実行（!）
- スラッシュコマンドの完全リスト
- ショートカットキー操作
2. TUIの起動
BASH
# カレントディレクトリ
opencode
# プロジェクトディレクトリを指定
opencode /path/to/project
3. 基本インタラクション
入力ボックスに自然言語を直接入力：
TEXT
📖 参照専用
このプロジェクトの構造を簡単にまとめて
OpenCodeはプロジェクトコードに基づいて分析結果を提供します。
4. ファイル参照（コア機能）
@を使ってプロジェクトファイルを参照：
TEXT
📖 参照専用
このプロジェクトの認証ロジックはどう実装されていますか？@packages/functions/src/api/index.tsを確認して
特徴：
- ファイルパスのあいまい検索に対応
- ファイル内容を自動読み込み
- コードのコピー不要
見知らぬコードを読むのに非常に適しています。
5. Bashコマンドの実行
!でShellモードに切り替え：
TEXT
📖 参照専用
!ls -la
実行結果は自動的に会話コンテキストに追加され、AIは結果に基づいて操作を継続可能。
6. スラッシュコマンド（/ コマンド）
/を入力して内蔵コマンドを実行：
| コマンド | 作用 | ショートカット |
|---|---|---|
/connect |
LLMプロバイダーの追加 | — |
/compact |
現在のセッションコンテキストを圧縮 | Ctrl+X → C |
/details |
ツール実行詳細の切り替え | Ctrl+X → D |
/editor |
外部エディタを開く | Ctrl+X → E |
/exit |
TUIを終了 | Ctrl+X → Q |
/export |
会話をMarkdownでエクスポート | Ctrl+X → X |
/help |
ヘルプパネルを開く | Ctrl+X → H |
/init |
AGENTS.mdの作成/更新 | Ctrl+X → I |
/models |
利用可能モデル一覧 | Ctrl+X → M |
/new |
新規セッション | Ctrl+X → N |
/redo |
取り消した操作をやり直し | Ctrl+X → R |
/sessions |
セッション一覧と切り替え | Ctrl+X → L |
/share |
現在のセッションを共有 | Ctrl+X → S |
/themes |
テーマ一覧/切り替え | Ctrl+X → T |
/thinking |
推論過程の表示/非表示 | — |
/undo |
前のメッセージを取り消し | Ctrl+X → U |
7. ショートカットキー
Ctrl + Xはデフォルトの「リーダーキー」で、VimのLeaderキーに類似：
| 機能 | ショートカット |
|---|---|
| コマンドパレット | Ctrl+X → H |
| 新規セッション | Ctrl+X → N |
| 取り消し | Ctrl+X → U |
| やり直し | Ctrl+X → R |
| モデル一覧 | Ctrl+X → M |
| テーマ切り替え | Ctrl+X → T |
| 会話エクスポート | Ctrl+X → X |
8. エディタ統合
BASH
export EDITOR="code --wait"
その後、TUIで/editorを使用して外部エディタで複雑なプロンプトを作成。
対応：VS Code、Cursor、Vim/Neovim、Nano。
9. セッション管理
| 操作 | コマンド |
|---|---|
| 新規セッション | /new |
| セッション確認 | /sessions |
| 前回のセッションを継続 | opencode --continue |
| セッション指定 | opencode --session <id> |
10. TUI設定
JSON
{
"tui": {
"scroll_speed": 3,
"scroll_acceleration": {
"enabled": true
}
}
}
11. TUIの本質
OpenCode TUIはLLM + プロジェクトコンテキスト + Git状態管理 + コマンドパレットの複合インタラクションレイヤー：
| プレフィックス | 機能 | 比喩 |
|---|---|---|
/ |
動作制御 | IDEコマンドパレット |
@ |
コンテキスト注入 | ファイルレベルRAG |
! |
実行環境操作 | Shellツール呼び出し |
Ctrl+X |
効率的なショートカット操作 | Vim Leaderキー |
❓ FAQ
Q WindowsターミナルでTUIの表示が異常な場合どうすれば？
A Windows Terminalの使用またはWSLへの切り替えを推奨。デフォルトのcmd.exeはTUIレンダリングのサポートが不十分。
Q TUIで複数行メッセージを入力するには？
A
/editorコマンドで外部エディタを開いて作成するか、Shift+Enterで改行を入力。Q Aliceが@で大きなファイルを参照し、コンテキストが長くなりすぎた場合どうすれば？
A
/compactでコンテキストを圧縮。ファイル全体ではなく、重要な部分のみを参照することも可能。📖 まとめ
- TUIはOpenCodeのコアインタラクションインターフェース
@でファイル参照、!でコマンド実行、/で内蔵コマンド呼び出し- Ctrl+Xはショートカットのリーダーキー
- @によるファイル参照で精度向上
- 重要な操作前にGitがコミット済みであることを確認
📝 練習問題
-
基本問題：TUIで@を使ってファイルを参照し、AIにコードロジックを分析させてください。
-
応用問題：!でShellコマンドを実行し、AIに結果に基づいて提案させてください。
-
チャレンジ問題：/editorで複雑な複数行プロンプトを作成し、AIに複数ステップのタスクを完了させてください。
