OpenCode TUI の常用コマンドラインオプションとスラッシュコマンド ─ システムコマンドを一気に習得 【OpenCode 002】

本回では、OpenCode の CLI（コマンドラインインターフェース）オプションと、TUI（テキストユーザーインターフェース）のスラッシュコマンドを紹介します。どちらも OpenCode のさまざまなシステム機能を提供します。

1 コマンドラインオプション

OpenCode のコマンドラインを何も指定せずに実行すると TUI モードが起動しますが、引数としてオプションを指定すると別の機能が動作します。以下に、よく使うコマンドオプションを紹介します。

2 スラッシュコマンド

2.1 スラッシュコマンド（Slash Commands）とは？

OpenCode の入力欄で / を入力すると、コマンドパネルが表示されます。スラッシュで始まるこれらのコマンドを使えば、複雑なショートカットを覚えなくても、さまざまな操作をすばやく実行できます。AI エージェントの呼び出しや自動化機能への「入り口」として機能します。

スラッシュコマンドは「クイックメニュー」のようなものだと考えてください。Discord や Notion で / を入力すると機能メニューが出てくるのと同じように、OpenCode でも一式のコマンドシステムが用意されています。

2.2 基本コマンド：まず覚えるべきもの

これらのコマンドは、OpenCode を開くたびに使う可能性が高いものです。最優先で覚えましょう。

2.2.1 会話管理（Session）

2.2.2 モデル切り替え（Models）

2.2.3 編集と復元

2.3 高度なコマンド：効率をさらに上げる

基本を押さえたら、これらのコマンドで作業フローをよりスムーズにできます。

2.3.1 インターフェース制御

2.3.2 Skills（スキルシステム）

Skills は OpenCode の「プラグインスクリプト」のようなもので、AI に特定分野の能力を持たせます。

おすすめのよく使う Skills：

2.4 実用テクニック：スラッシュコマンドをもっと便利に使う

2.4.1 @ でファイルを参照する

入力欄で @ を入力すると、作業ディレクトリ内のファイル一覧が表示され、ファイル名の一部を入力すればすばやく絞り込めます。

@index.jsp の SQL インジェクション脆弱性を確認してください

2.4.2 複数行入力で誤送信しない

• 改行：Shift + Enter または Ctrl + J（最も安定）
• 送信：Enter
• クリア：Ctrl + C

2.4.3 コマンドパネル

Ctrl + P を押すとコマンドパネルが開き、方向キーで選択できます。コマンド名を丸暗記する必要はありません。

2.4.4 カスタムコマンド（Custom Commands）

よく使うプロンプトを 1 回の呼び出しにまとめる形で、自分専用のスラッシュコマンドを作成できます。定義方法は 2 つあります。

2.4.4.1 Markdown ファイル（推奨）

以下のディレクトリに .md ファイルを作成します。ファイル名がコマンド名になります。

---
description: コードレビュー
agent: plan
model: anthropic/claude-sonnet-4-20250514
---

現在のファイルをコードレビューしてください。以下の点に注目してください：
1. 潜在的なパフォーマンス問題
2. セキュリティ脆弱性
3. コードの可読性
4. ベストプラクティスへの準拠状況

2.4.4.2 JSON 設定

opencode.json で JSON として定義することもできます。

{
  "command": {
    "review": {
      "template": "現在のファイルをコードレビューしてください。以下の点に注目してください：\n1. 潜在的なパフォーマンス問題\n2. セキュリティ脆弱性\n3. コードの可読性\n4. ベストプラクティスへの準拠状況",
      "description": "コードレビュー",
      "agent": "plan",
      "model": "anthropic/claude-sonnet-4-20250514"
    }
  }
}

2.4.5 引数の受け渡し

$ARGUMENTS を使うと、コマンドの後ろに続く文字列をプロンプトに渡せます。

---
description: 新しいコンポーネントを作成
---

TypeScript を使って、$ARGUMENTS という名前の React コンポーネントを作成し、適切な型定義と基本構造を含めてください。

/component Button を実行すると、$ARGUMENTS は Button に置き換えられます。

位置引数で個別の値を取得することもできます（$1、$2、$3…）。

---
description: ファイルを作成
---

$2 ディレクトリに、$1 という名前のファイルを作成し、内容を次のようにしてください：$3
```

```bash
/create-file config.json src "{ \"key\": \"value\" }"
```

• $1 → config.json
• $2 → src
• $3 → { "key": "value" }

2.4.6 Shell コマンドの埋め込み

!\command`` 構文を使って、Bash コマンドの出力をプロンプトに埋め込めます。

---
description: テストカバレッジを分析
---

現在のテスト結果は以下のとおりです：
!\`npm test\`

以上の結果をもとに、テストカバレッジを向上させる方法を提案してください。

---
description: 最近の変更をレビュー
---

最近の Git コミット履歴：
!\`git log --oneline -10\`

これらの変更をレビューし、改善案を提示してください。

コマンドはプロジェクトのルートディレクトリで実行され、その出力はそのままプロンプトの一部になります。

2.4.7 ファイル参照

コマンド内で @ を使ってファイルを参照できます。

---
description: コンポーネントをレビュー
---

@src/components/Button.tsx コンポーネントをレビューしてください。
パフォーマンス問題を確認し、改善案を提案してください。

ファイルの内容は自動的にプロンプトへ含まれます。

2.5 早見表：よく使うスラッシュコマンド一覧

3 関連リンク

• OpenCode 公式ドキュメント（繁体字中国語）
• OpenCode 公式ショートカットドキュメント
• Obsidian + OpenCode ナレッジ管理の組み合わせ

✅ 解説記事（繁体字中国語）
✅ Explanation article(English)
✅ 解説記事（日本語）

4 教学動画

https://youtu.be/fkLr0diCMrk

＃＃