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

クイックスタート

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

前提条件

  • macOS または Linux (Windows WSL2をサポート)
  • Node.js 18+ (一部の言語サーバー用)
  • APIキー (OpenAI, Anthropic, または Gemini)

インストール

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

curl -sL opencode.ai/install | bash

APIキーの設定

インストール後、選択したAIプロバイダーのAPIキーを設定する必要があります。これにより、OpencodeがAIモデルにリクエストを送信できるようになります。

ステップ1: APIキーを取得する

まず、お好みのAIプロバイダーからAPIキーを取得する必要があります：

  • Anthropic: Anthropic Console にサインアップし、APIキーを作成します
  • OpenAI: OpenAI Platform にサインアップし、APIキーを作成します
  • Gemini: Google AI Studio にサインアップし、APIキーを作成します

ステップ2: APIキーを設定する

opencode auth login コマンドを実行して、APIキーを設定します：

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

# 特定のプロバイダーで認証する
opencode auth login --provider anthropic

APIキーの入力を求められます。入力すると、~/.local/share/opencode/auth.json に安全に保存されます。

プロジェクトの初期化

Opencodeがプロジェクト構造をよりよく理解できるようにするには、/init コマンドでプロジェクトを初期化する必要があります。これにより、プロジェクトの構造と主要コンポーネントを文書化する AGENTS.md ファイルが作成されます。

/init コマンドの使用

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

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

opencode init

オプション2: TUIから

Opencode TUIを起動します：

opencode tui

次に、/init コマンドを入力します：

/init

/init コマンドの役割

/init コマンドは以下を行います：

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

これにより、AIがコードベースをよりよく理解できるようになり、より正確で関連性の高い応答が得られます。

最初のタスク

APIキーを設定し、プロジェクトを初期化したので、Opencodeを使用し始める準備ができました。

TUIを起動する

opencode tui

タスクの例

いくつかの例を試してみましょう：

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

検証

設定が正しく機能しているかどうかを確認するには：

  1. opencode models を実行して、設定されたプロバイダーの利用可能なモデルを表示します
  2. opencode stats を実行して、使用状況の統計を確認します
  3. “JavaScriptでpromisesを使用する方法を説明してください”などの簡単なクエリを試してみます

次のステップ

  • 設定 ページを探索して、ワークフローに合わせてOpencodeをカスタマイズします
  • CLIリファレンス を確認して、より多くのコマンドを知りましょう
  • エコシステム ページを訪れて、コミュニティツールとリソースを発見しましょう

Opencodeを使用して快適なコーディングをお楽しみください！