OpenCode 主要コマンドガイド

OpenCodeの主要コマンドを「CLI基本コマンド、対話モードショートカット、設定/運用コマンド」の3カテゴリーに整理しました。日常使用の90%のシナリオをカバーし、プライベートデプロイ後の企業利用シナリオに対応しています。コピーペーストしてそのまま使用できます。

一、基本CLIコマンド(ターミナルで直接実行)

OpenCodeを起動・管理するための最も基本的なコマンド群です。プライベートデプロイ後、頻繁に使用されます。

# 1. OpenCode対話インターフェースの起動(最も一般的な使用法)
opcode

# 2. OpenCodeバージョンの確認(インストール/アップグレードの成功を検証)
opcode -v
# または
opcode --version

# 3. すべてのコマンドヘルプの表示(コマンドを忘れた場合に使用)
opcode -h
# または
opcode --help

# 4. 単回コーディングコマンドの直接実行(対話インターフェースに入らずに実行)
# 書式:opcode -p "コーディング要件"
opcode -p "Python関数でフィボナッチ数列を計算し、コメントと単体テストを含める"

# 5. モデル指定でのコマンド実行(プライベートデプロイ時にローカルモデルを接続)
# --provider:モデルプロバイダーを指定(OpenAI互換モード)
# --base-url:ローカルモデルAPIアドレス
# --model:ローカルモデル名
opcode -p "Vue3コンポーネントでテーブルページング機能を実装" \
  --provider OpenAI \
  --base-url http://localhost:11434/v1 \
  --model qwen-coder-plus:latest

# 6. OpenCodeローカルキャッシュのクリーンアップ(プライベートデプロイ後の不要データ削除)
opcode clean

# 7. OpenCodeアップデートの確認(企業内で指定バージョンか検証)
opcode check-update

二、対話モードショートカット(opcode起動後使用)

OpenCode対話インターフェース(TUI)に入った後、これらのショートカットは日常のコーディング効率の核心となります。プライベートデploy後の社内利用シナリオに対応しています。

ショートカット 機能説明(企業シナリオでの高頻度使用)
i 入力モードに入る(コーディング要件/質問入力、例:「このコードをリファクタリングしてパフォーマンスを最適化」)
/ コマンドモードに入る(設定、ツール呼び出しを実行、プライベートデプロイ後によく使用)
Esc 現在のモードから退出(入力/コマンドモードからブラウズモードに戻る)
q OpenCode対話インターフェースを終了
? すべてのショートカットヘルプを表示(社内利用時にドキュメント確認不要)
Ctrl + s 現在のセッション/コードを保存(プライベートデプロイ後のローカル保存)
Ctrl + c 現在のモデル応答を中断(要件入力ミス/応答遅延時に使用)
Tab 入力中のコマンド/コードの自動補完(コーディング時の効率化)

三、コマンドモードコマンド(/入力後実行)

対話インターフェースで/を押してコマンドモードに入った後、これらのコマンドはプライベートデプロイ後の企業向け設定・管理要件に対応しています。

# 1. 設定インターフェースに入る(重要!プライベートデプロイ後のローカルモデル接続)
config
# 設定項目の重点(ローカルモデル対応):
# - Provider:OpenAIを選択(Ollama/vLLMなどのローカルモデルと互換)
# - Base URL:http://社内モデルアドレス:ポート/v1(例:http://192.168.1.100:11434/v1)
# - API Key:任意の文字列(ローカルモデルでは実際のキー不要)
# - Model Name:ローカルモデル名(例:qwen-coder-plus:latest)

# 2. すべてのセッションを一覧表示(プライベートデプロイ後のローカルセッション管理)
list-sessions

# 3. セッションの切り替え(過去のコーディング対話を再利用)
switch-session [セッションID]  # 例:switch-session 654321

# 4. 指定セッションの削除(不要なローカルデータのクリーンアップ)
delete-session [セッションID]

# 5. 現在のセッションコードをエクスポート(プライベートデプロイ後のローカルファイル保存)
export-code ./my_project.js  # 指定ファイルにエクスポート

# 6. 組み込みツールの呼び出し(企業コーディングで頻繁使用)
tool git status  # Git状態の確認
tool file read ./src/main.js  # ローカルコードファイルの読み込み
tool file write ./src/test.js "console.log('test')"  # コードをファイルに書き込み

四、企業向けプライベートデプロイ専用コマンド(高頻度)

社内セキュリティ利用シナリーに対応するため、2つの核心コマンドを追加しました。

# 1. ローカル設定ファイルの強制指定(企業内設定の統一)
opcode --config ~/.opencode/enterprise_config.json
# 設定ファイルの例(統一配布可能):
# {
#   "provider": "OpenAI",
#   "baseUrl": "http://社内モデルアドレス:11434/v1",
#   "model": "qwen-coder-plus:latest",
#   "apiKey": "local-company-key"
# }

# 2. オフラインモードでの起動(完全なネットワーク切断、ローカルモデルのみ使用)
opcode --offline

まとめ

  1. 基本起動opcodeで対話インターフェースに入り、opcode -p "要件"で単回実行;
  2. 対話効率iで入力、/でコマンド、Escで退出が高頻度ショートカット;
  3. プライベート設定configコマンドでローカルモデル接続、--configで統一設定ファイル指定;
  4. 企業管理cleanでキャッシュクリーンアップ、--offlineオフライン起動でデータセキュリティ保証。

タグ: OpenCode CLI コマンド プライベートデプロイメント 企業向け

7月28日 16:29 投稿