コンテンツにスキップ
OpenCode
app.header.homeapp.header.docs

トゥイ

OpenCode terminal ユーザー インターフェイスの使用。

OpenCode は、LLM を使用してプロジェクトを作業するための対話型terminal インターフェイスまたは TUI を提供します。

OpenCode を実行すると、現在のディレクトリの TUI が開始されます。

Terminal window
opencode

または、特定の作業ディレクトリに対して起動することもできます。

Terminal window
opencode /path/to/project

TUI に入ったら、メッセージを表示することができます。

Give me a quick summary of the codebase.

ファイル参照

@ を使用してメッセージ内のファイルを参照できます。これにより、現在の作業ディレクトリ内であいまいなファイル検索が行われます。

How is auth handled in @packages/functions/src/api/index.ts?

ファイルの内容は会話に自動的に追加されます。

Bash コマンド

メッセージを ! で開始して、shell コマンドを実行します。

!ls -la

コマンドの出力は、ツールの結果として会話に追加されます。

コマンド

OpenCode TUI を使用する場合、「/」に続いてコマンド名を入力すると、アクションをすばやく実行できます。例えば：

/help

ほとんどのコマンドには、ctrl+x をリーダー キーとして使用するキーバインドもあります。ctrl+x がデフォルトのリーダー キーです。 詳細はこちら。

利用可能なすべてのスラッシュ コマンドは次のとおりです。

接続する

OpenCode にプロバイダーを追加します。利用可能なプロバイダーから選択し、その API キーを追加できます。

/connect

コンパクト

現在のセッションを圧縮します。 別名: /summarize

/compact

キーバインド: ctrl+x c

詳細

ツール実行の詳細を切り替えます。

/details

キーバインド: ctrl+x d

エディタ

メッセージを作成するために外部エディタを開きます。 EDITOR 環境変数に設定されたエディタを使用します。 詳細はこちら。

/editor

キーバインド: ctrl+x e

出口

OpenCodeを終了します。 エイリアス: /quit、/q

/exit

キーバインド: ctrl+x q

輸出

現在の会話を Markdown にエクスポートし、デフォルトのエディターで開きます。 EDITOR 環境変数に設定されたエディタを使用します。 詳細はこちら。

/export

キーバインド: ctrl+x x

ヘルプ

ヘルプダイアログを表示します。

/help

キーバインド: ctrl+x h

初期化

AGENTS.md ファイルを作成または更新します。 詳細はこちら。

/init

キーバインド: ctrl+x i

モデル

利用可能なモデルをリストします。

/models

キーバインド: ctrl+x m

新しい

新しいセッションを開始します。 別名: /clear

/new

キーバインド: ctrl+x n

やり直し

以前に取り消したメッセージをやり直します。 /undo を使用した後にのみ使用できます。

Internally, を使用してファイルの変更を管理します。したがって、あなたのプロジェクトは ** する必要があります Git リポジトリ** であること。

/redo

キーバインド: ctrl+x r

セッション

セッションを一覧表示して切り替えます。 エイリアス: /resume、/continue

/sessions

キーバインド: ctrl+x l

共有

現在のセッションを共有します。 詳細はこちら。

/share

キーバインド: ctrl+x s

テーマ

利用可能なテーマをリストします。

/theme

キーバインド: ctrl+x t

考え

会話内の思考/推論ブロックの表示を切り替えます。有効にすると、拡張思考をサポートするモデルの推論プロセスを確認できます。

/thinking

元に戻す

会話の最後のメッセージを元に戻します。最新のユーザー メッセージ、その後のすべての応答、およびファイルの変更を削除します。

Internally, を使用してファイルの変更を管理します。したがって、あなたのプロジェクトは ** する必要があります Git リポジトリ** であること。

/undo

キーバインド: ctrl+x u

共有を解除する

現在のセッションの共有を解除します。 詳細はこちら。

/unshare

エディターのセットアップ

/editor および /export コマンドはどちらも、EDITOR 環境変数で指定されたエディターを使用します。

Terminal window
# Example for nano or vim
export EDITOR=nano
export EDITOR=vim


# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
export EDITOR="code --wait"

これを永続的にするには、これをshell プロファイルに追加します。 ~/.bashrc、~/.zshrcなど

一般的なエディター オプションには次のものがあります。

  • code - VS Code
  • cursor - Cursor
  • windsurf - Windsurf
  • nvim - Neovim エディター
  • vim - Vim エディター
  • nano - ナノエディター
  • notepad - Windows メモ帳
  • subl - Sublime Text

一部のモードでは実行にコマンドライン引数が必要です。--wait フラグを使うと、エディターが閉じるまでプロセスが待機します。

設定する

OpenCode 構成ファイルを通じて TUI の動作をカスタマイズできます。

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "tui": {
    "scroll_speed": 3,
    "scroll_acceleration": {
      "enabled": true
    }
  }
}

オプション

  • scroll_acceleration - macOS スタイルのスクロール アクセラレーションを有効にして、スムーズで自然なスクロールを実現します。有効にすると、高速スクロール ジェスチャではスクロール速度が向上し、ゆっくりとした動きでは正確なままになります。 この設定は scroll_speed よりも優先され、有効になっている場合は上書きされます。
  • scroll_speed - スクロール コマンドを使用するときに TUI がスクロールする速度を制御します (最小: 1)。デフォルトは 3 です。 注: scroll_acceleration.enabled が true に設定されている場合、これは無視されます。

カスタマイズ

コマンド パレット (ctrl+x h または /help) を使用して、TUI ビューのさまざまな側面をカスタマイズできます。これらの設定は再起動後も維持されます。

ユーザー名の表示

チャット メッセージにユーザー名を表示するかどうかを切り替えます。これには次の方法でアクセスします。

  • コマンドパレット:「ユーザー名」または「ユーザー名を隠す」を検索します。
  • 設定は自動的に保持され、TUI セッション全体で記憶されます。