コンテンツにスキップ
ショーケース エコシステム ドキュメント

クイックスタート

5 分以内に OpenCode を使い始めましょう。

前提条件

  • macOS、Linux、または Windows（WSL2 対応）
  • Node.js 18+（一部の言語サーバー用）
  • API キー（内蔵モデルを使用する場合はオプション）

インストール

ターミナルで次のコマンドを実行して、バイナリをダウンロードしてインストールします：

curl -fsSL https://opencode.ai/install | bash

その他のインストールオプションについては、インストールページをご覧ください。

認証

OpenCode は、すぐに使い始めるための複数の認証オプションを提供しています。

オプション 1：内蔵無料モデル（Zen）

最も簡単な始め方は、コーディング用に最適化された厳選された AI モデルを提供する OpenCode Zen を使用することです：

opencode auth login --provider zen

API キーは不要 - すぐにコーディングを始められます！

オプション 2：GitHub Copilot

GitHub Copilot サブスクリプションをお持ちの場合：

opencode auth login --provider github

ブラウザが開き、GitHub で認証します。

オプション 3：ChatGPT Plus/Pro

ChatGPT Plus または Pro サブスクリプションをお持ちの場合：

opencode auth login --provider openai

ChatGPT サブスクリプションを直接使用します。

オプション 4：カスタム API キー

その他のプロバイダーについては、独自の API キーを設定できます：

# インタラクティブ認証を開始
opencode auth login

# または特定のプロバイダーで認証
opencode auth login --provider anthropic
opencode auth login --provider google

サポートされているプロバイダー：

API キーは ~/.local/share/opencode/auth.json に安全に保存されます。

プロジェクトの初期化

OpenCode がプロジェクト構造をよりよく理解できるように、/init コマンドでプロジェクトを初期化してください。

/init コマンドの使用

オプション 1：ターミナルから

プロジェクトディレクトリに移動して実行：

opencode init

オプション 2：TUI から

OpenCode TUI を起動：

opencode tui

次に /init コマンドを入力：

/init

/init コマンドの動作

/init コマンドは：

  1. プロジェクトディレクトリ構造をスキャン
  2. 主要なファイルとコンポーネントを特定
  3. プロジェクトルートに AGENTS.md ファイルを作成
  4. AI が参照するための重要なプロジェクト情報を文書化

これにより、AI はコードベースをよりよく理解し、より正確で関連性の高い応答を提供できます。

最初のタスク

認証を設定し、プロジェクトを初期化したので、OpenCode を使い始める準備ができました。

TUI を起動

opencode tui

エージェントの切り替え

OpenCode には 2 つの内蔵エージェントが含まれています：

  • build（デフォルト）：開発作業のための完全アクセスエージェント
  • plan：分析とコード探索のための読み取り専用エージェント

Tab キーを押してエージェントを切り替えます。

例のタスク

試してみる例のタスクをいくつか紹介します：

  1. コードの説明: “このプロジェクトの認証フローがどのように機能するか説明してください”
  2. バグ修正: “ログインコンポーネントのバグを見つけて修正してください”
  3. リファクタリング: “ユーザープロファイルコンポーネントをフックを使用するようにリファクタリングしてください”
  4. ドキュメント: “API エンドポイントのドキュメントを生成してください”
  5. テスト: “チェックアウト機能のユニットテストを書いてください”

マルチセッションサポート

同じプロジェクト内で複数のエージェントを並行して実行できます：

# 新しいセッションを開始
opencode tui

# 別のターミナルで、別のセッションを開始
opencode tui

各セッションは独立して動作し、異なるタスクを同時に処理できます。

セッションリンクの共有

参照やデバッグのためにセッションリンクを共有できます：

opencode share <session-id>

これにより、他のユーザーがセッションを表示するために使用できる共有可能なリンクが生成されます。

検証

セットアップが正しく動作していることを確認：

  1. opencode models を実行して、設定したプロバイダーから利用可能なモデルを確認
  2. opencode stats を実行して使用統計を確認
  3. “JavaScript でプロミスを使用する方法を説明してください” のような簡単なクエリを試す

次のステップ

  • 設定ページを探索して、OpenCode をワークフローにカスタマイズ
  • CLI リファレンスをチェックして、より多くのコマンドを学ぶ
  • エコシステムページを訪れて、コミュニティツールとリソースを発見
  • OpenCode Zen について学んで、最適化された AI モデルを入手

OpenCode で楽しいコーディングを！