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