OpenCodeとは？使い方・基本ガイド【AIエージェントCLIツール入門】
OpenCodeの基本から使い方まで解説。AIエージェントを活用したCLIツールでコーディングを効率化する方法を紹介。初心者向けの入門ガイド。
OpenCode使い方AIエージェントコーディングCLIツール入門2026/5/25
OpenCodeとは
OpenCodeは、ターミナル上で動作するAIエージェント型のCLIツールです。開発者が自然言語で指示を出すと、AIがコードの生成・編集・実行・デバッグを自動で行います。従来のコーディング支援ツールとは異なり、ファイル操作やシェルコマンドの実行もエージェントが自律的に行うため、開発フロー全体を効率化できます。
主な特徴
OpenCodeのインストール方法
OpenCodeはNode.js製のツールで、npmまたはHomebrewでインストールできます。
前提条件
npmを使用する場合
npm install -g opencode
Homebrewを使用する場合
brew install opencode
インストール後、APIキーを設定します。
export OPENAI_API_KEY="sk-your-key"
永続的に設定するには、シェルの設定ファイル（.bashrcや.zshrc）に追記してください。
基本的な使い方
OpenCodeの基本的なワークフローは、ターミナルでopencodeコマンドを実行し、指示を入力するだけです。
1. 対話モードで開始
opencode
例:
> 新しいReactコンポーネントを作成して。ボタンをクリックするとカウントが増えるシンプルなもの。
AIが自動的にファイルを作成し、コードを記述します。
2. ワンショットコマンド
引数として直接指示を渡すこともできます。opencode "このプロジェクトにESLintを設定して"
3. ファイルを指定して修正
opencode --file src/app.js "このファイルにエラーハンドリングを追加して"
4. コンテキストを与える
プロジェクト全体を理解させるには、--contextオプションでディレクトリを指定します。
opencode --context ./src "全APIエンドポイントにバリデーションを追加して"
実践的なユースケース
コード生成
「PythonでCSVを読み込んで、特定の列の平均を計算するスクリプトを作って」といった要求を自然言語で行うと、AIが即座にコードを生成し、ファイルに保存します。リファクタリング
「この関数を非同期に書き換えて」「クラスコンポーネントを関数コンポーネントに変換して」など、コードの改善も指示一つで可能です。バグ修正
エラーメッセージをそのまま貼り付けて「このエラーを修正して」と指示すると、AIが原因を特定し、修正コードを提案・適用します。テスト作成
既存のコードに対して「ユニットテストを書いて」と指示するだけで、テストファイルが生成されます。設定とカスタマイズ
OpenCodeは設定ファイル（opencode.config.json）で動作をカスタマイズできます。
{
"model": "gpt-4",
"temperature": 0.2,
"maxTokens": 4096,
"systemPrompt": "あなたは優秀なソフトウェアエンジニアです。簡潔で効率的なコードを書いてください。"
}
model: 使用するLLMモデル（デフォルトはgpt-4）temperature: 出力のランダム性（0〜1）maxTokens: 最大トークン数systemPrompt: AIへのシステムプロンプト（役割やルールを指定）注意点とベストプラクティス
まとめ
OpenCodeは、AIエージェントを活用してコーディング作業を大幅に効率化するCLIツールです。インストールも簡単で、自然言語で指示を出すだけでコード生成・編集・実行まで自動化できます。ただし、生成されたコードの品質やセキュリティは最終的に開発者が責任を持つ必要があります。まずは小さなタスクから試してみて、徐々にワークフローに組み込んでいくことをおすすめします。