文档
日本語ドキュメント
はじめに

はじめに

OpenCodeは、ターミナルインターフェース、デスクトップアプリケーション、またはIDE拡張機能として利用できるオープンソースのAIコーディングエージェントです。開発者がコード関連のタスクでAIと対話することを可能にします。

前提条件

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

  1. モダンターミナルエミュレータ - 以下のオプションがあります:

    • WezTerm(クロスプラットフォーム)
    • Alacritty(クロスプラットフォーム)
    • Ghostty(LinuxおよびmacOS)
    • Kitty(LinuxおよびmacOS)
  2. APIキー - 選択したLLMプロバイダーの認証情報

インストール

ユニバーサルインストール

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

Node.js パッケージマネージャー

# npm
npm install -g opencode-ai
 
# Bun
bun install -g opencode-ai
 
# pnpm
pnpm install -g opencode-ai
 
# Yarn
yarn global add opencode-ai

システムパッケージマネージャー

# Homebrew (macOS/Linux)
brew install anomalyco/tap/opencode
 
# Paru (Arch Linux)
paru -S opencode-bin
 
# Chocolatey (Windows)
choco install opencode
 
# Scoop (Windows)
scoop bucket add extras && scoop install extras/opencode
 
# Docker
docker run -it --rm ghcr.io/anomalyco/opencode

設定

  1. ターミナルインターフェース内で /connect コマンドを実行
  2. 希望のプロバイダーを選択
  3. opencode.ai/auth で認証
  4. 課金情報を設定
  5. APIキーを取得して入力

初心者には、厳選されテスト済みのモデルコレクションである OpenCode Zen をお勧めします。

プロジェクトの初期化

プロジェクトディレクトリに移動して起動:

cd /path/to/project
opencode

以下のコマンドでプロジェクトを初期化:

/init

これにより、プロジェクトルートに AGENTS.md ファイルが生成されます。このファイルはバージョン管理にコミットする必要があります。

基本的な使い方

コードベースへの質問

@ を使用してプロジェクトファイルを検索:

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

機能開発

  1. プランモード(Tabキー)- AIが変更を加えずに実装アプローチを提案
  2. イテレーション - フィードバックと視覚的参照でプランを改善
  3. ビルドモード(Tabキー)- 承認された変更を実行

変更の取り消し

  • 元に戻す: /undo
  • やり直し: /redo
  • 複数回の取り消しに対応

コラボレーション

以下のコマンドで会話を共有:

/share

クリップボードにコピーされる共有リンクが生成されます。

カスタマイズ

体験をカスタマイズ:

  • テーマの選択
  • キーボードバインディング
  • コードフォーマッター
  • カスタムコマンド
  • 設定オプション