コンテンツにスキップ
レシピ エコシステム ソースコード ドキュメント

はじめに

OpenCode を使い始めましょう。

OpenCode はオープンソースの AI コーディングエージェントです。ターミナルベースのインターフェース（TUI）、デスクトップアプリ、または IDE 拡張として利用可能です。

OpenCode TUI with the opencode theme

始めましょう。

前提条件

ターミナルで OpenCode を使用するには、以下が必要です：

  1. 次のような最新のターミナルエミュレータ：
    • WezTerm、クロスプラットフォーム
    • Alacritty、クロスプラットフォーム
    • Ghostty、Linux および macOS
    • Kitty、Linux および macOS
  2. 使用する LLM プロバイダの API キー。

インストール

OpenCode をインストールする最も簡単な方法は、インストールスクリプトを使用することです。

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

以下のコマンドでもインストールできます：

Node.js を使用

npm install -g opencode-ai
# または
bun install -g opencode-ai
# または
pnpm install -g opencode-ai
# または
yarn global add opencode-ai

Homebrew を使用（macOSおよび Linux）

brew install anomalyco/tap/opencode

Arch Linux にインストール

sudo pacman -S opencode           # Arch Linux（安定版）
paru -S opencode-bin              # Arch Linux（AUR 最新版）

Windows

推奨：WSL を使用してください。Windows で最適な体験を得るには、Windows Subsystem for Linux（WSL）の使用を推奨します。パフォーマンスが向上し、OpenCode の機能との完全な互換性が確保されます。

choco install opencode # Chocolatey
scoop install opencode    # Scoop
npm install -g opencode-ai    # NPM
mise use -g github:anomalyco/opencode    # Mise
docker run -it --rm ghcr.io/anomalyco/opencode    # Docker

Windows で Bun を使用して OpenCode をインストールするサポートは、現在開発中です。

Releases からバイナリをダウンロードすることもできます。

設定

OpenCode では、API キーを設定することで任意の LLM プロバイダを使用できます。

LLM プロバイダの使用が初めての場合は、OpenCode Zen の使用を推奨します。OpenCode チームによってテストおよび検証されたモデルの厳選リストです。

  1. TUI で /connectコマンドを実行し、opencode を選択して opencode.ai/auth にアクセスします。
/connect
  1. サインイン請求の詳細を追加し、API キーをコピーします。
  2. API キーを貼り付けます。

または、他のプロバイダを選択することもできます。詳細を見る。

初期化

プロバイダを設定したので、作業したいプロジェクトに移動します。

cd /path/to/project
opencode

次に、以下のコマンドを実行してプロジェクトの OpenCode を初期化します。

/init

これにより、OpenCode がプロジェクトを分析し、プロジェクトルートに AGENTS.md ファイルを作成します。

使用方法

プロジェクトの作業に OpenCode を使用する準備ができました。気軽に質問してください！

AI コーディングエージェントの使用が初めての場合は、以下の例が役立つかもしれません。

質問する

OpenCode にコードベースの解説を依頼できます。

@packages/functions/src/api/index.ts の認証処理はどのようになっていますか？

これは、あなたが作業していないコードベースの部分がある場合に便利です。

機能を追加する

OpenCode にプロジェクトに新機能を追加を依頼できます。ただし、まず計画を作成するよう依頼することをお勧めします。

1. 計画を作成する

OpenCode には Plan モード があり、変更能力を無効化し、代わりに どのように 機能を実装するかを提案します。

Tab キーを使用してそれに切り替えます。右下隅にインジケーターが表示されます。

<TAB>

次に、実行してほしいことを説明します。

ユーザーがメモを削除的时候、希望将其在数据库中标记为已删除。
然后创建一个屏幕显示所有最近删除的メモ。
从这个屏幕，用户可以恢复メモ或永久删除它。

OpenCode があなたのしたいことを理解するのに十分な詳細を提供してください。チームの下請け開発者と話す感覚で話すのが有帮助です。

2. 計画を反復する

計画が表示されたら、フィードバックを提供したり、詳細を追加したりできます。

以前使用したデザインを使用してこの新しい画面を設計したいと考えています。
[Image #1] この画像を確認し、参照として使用してください。

3. 機能をビルドする

計画に満足したら、もう一度 Tab キーを押して Build モード に戻ります。

<TAB>

変更を行うよう依頼します。

没问题！続けて変更を行ってください。

変更を加える

より単純な変更については、計画を先に確認することなく、OpenCode に直接ビルドを依頼できます。

/settings ルートに認証を追加する必要があります。@packages/functions/src/notes.ts
の /notes ルートの処理方法を確認し、@packages/functions/src/settings.ts に
同じロジックを実装してください。

OpenCode が正しい変更を行うように、十分な詳細を提供してください。

変更を元に戻す

OpenCode に変更を加えるよう依頼したとしましょう。

@packages/functions/src/api/index.ts の関数をリファクタリングできますか？

しかし、それが你想要のものではないことに気づきました。/undo コマンドを使用して変更を元に戻すことができます。

/undo

OpenCode は、加えた変更を元に戻し、元のメッセージを再度表示します。

@packages/functions/src/api/index.ts の関数をリファクタリングできますか？

ここから、プロンプトを調整して OpenCode に再試行を依頼できます。

共有

OpenCode との会話は、チームと共有できます。

/share

これにより、現在の会話へのリンクが作成され、クリップボードにコピーされます。

OpenCode の会話例をご覧ください。

カスタマイズ

以上就是 OpenCode の使い方のすべてです！

自分仕様にカスタマイズするには、テーマの選択、キーバインドのカスタマイズ、コードフォーマッターの設定、カスタムコマンドの作成、または OpenCode 設定の試用をお勧めします。