OpenCode: OpenCode First Use
最終更新:2026-08-31
--- title: OpenCode初回使用 description: ゼロからOpenCodeを体験し、初回の会話、コード分析、ファイル修正の完全なフローを完了する order: 5 lang: ja
インストールと設定が完了したら、OpenCodeを初めて使用してみましょう。
1. 学習内容
- OpenCodeの起動とTUIへの入り方
- 初回の会話体験
- AIにコードを分析させる
- AIにコードを修正させる
- 操作の取り消し
2. OpenCodeの起動
プロジェクトディレクトリに移動して実行:
BASH
cd my-project
opencode
TUIインターフェースが表示されます。下部に入力ボックス、上部に会話エリアがあります。
3. 初回の会話
入力ボックスに次のように入力:
TEXT
📖 参照専用
このプロジェクトの構造を簡単にまとめて
OpenCodeがプロジェクトファイルを読み込み、分析後にプロジェクト構造の概要を提供します。
出力例:
TEXT
📖 参照専用
これはNode.jsプロジェクトです。主な構造は以下の通り:
- src/ - ソースコードディレクトリ
- index.ts - エントリーファイル
- routes/ - ルートモジュール
- utils/ - ユーティリティ関数
- tests/ - テストファイル
- package.json - プロジェクト設定
4. ファイル参照による分析
@を使ってプロジェクト内のファイルを参照:
TEXT
📖 参照専用
このプロジェクトの認証ロジックはどう実装されていますか?@src/auth/index.tsを確認して
特徴:
- ファイルパスのあいまい検索に対応
- ファイル内容を自動読み込み
- コードの手動コピー不要
5. AIにコードを修正させる
修正指示を出す:
TEXT
📖 参照専用
src/utils/format.tsのすべてのvar宣言をconstまたはletに置換して
OpenCodeは:
- ファイル内容を読み込む
- すべてのvar宣言を特定
- コンテキストに基づいてconstかletかを判断
- ファイルを直接修正
6. コマンドの実行
!プレフィックスでShellコマンドを実行:
TEXT
📖 参照専用
!npm test
実行結果は自動的に会話コンテキストに追加され、AIは結果に基づいて次の操作を行えます。
7. 操作の取り消し
AIの修正が期待に合わない場合、取り消し可能:
TEXT
📖 参照専用
/undo
これにより:
- 前のメッセージを取り消し
- コード修正をロールバック
やり直し操作:
TEXT
📖 参照専用
/redo
重要: 取り消し機能はGitに依存します。プロジェクトでGitバージョン管理を有効にすることを推奨。
8. モデルの切り替え
現在のモデルの効果が良くない場合、切り替え可能:
TEXT
📖 参照専用
/model
リストから他のモデルを選択し、Enterで確定。
9. セッション管理
(1) 新規セッション
TEXT
📖 参照専用
/new
(2) 履歴セッションの確認
TEXT
📖 参照専用
/sessions
(3) 前回のセッションを継続
BASH
opencode --continue
10. OpenCodeの終了
TEXT
📖 参照専用
/exit
またはショートカットCtrl + X → Q。
❓ FAQ
Q 初回使用時にどのモデルを選ぶべきか?
A OpenCode Zenの無料モデルでまず体験し、フローが確認できたら必要に応じてより強力な有料モデルに切り替えることを推奨。
Q AIがコードを修正したが正しくない場合どうすれば?
A 直ちに
/undoで取り消し。重要な操作の前にはgit commitすることを推奨。undoが失敗してもGitでロールバック可能。Q AliceがOpenCodeに関数を書かせ、Bobが設定ファイルを修正させた場合、どちらのリスクが低いか?
A Bobの方がリスクが低い。設定ファイルの修正は影響範囲が限定されるが、新規関数の作成はコード全体のロジックに影響する可能性がある。ただし、両者とも操作前にGitがコミット済みであることを確認すべき。
Q 非対話モードの使い方は?
A
opencode run "あなたの質問"コマンドを使用。TUIに入らず結果を直接返す。クイック質問やスクリプト統合に適している。📖 まとめ
- プロジェクトディレクトリで
opencodeを実行して起動 @でファイルを参照、!でコマンドを実行/undoで修正を取り消し、/redoでやり直し/modelでモデル切り替え、/newで新規セッション- 重要な操作前にGitがコミット済みであることを確認
📝 練習問題
-
基本問題:OpenCodeを起動し、現在のプロジェクトの構造を分析させてください。
-
応用問題:OpenCodeにプロジェクト内のファイルを修正させ、その後
/undoで修正を取り消してください。 -
チャレンジ問題:非対話モード
opencode runでコード分析を完了し、結果をファイルにリダイレクトしてください。