OpenCodeの使い方ガイド: 始め方、実践Tips、Oh My OpenCodeとの使い分け

Name

Soren Atelier

更新日 2026/3/17

OpenCode は、ターミナルを中心に使うオープンソースの AI coding agent です。Desktop app や IDE extension もありますが、このページで本当に見たいのは「どう始めるか」よりも、「どこまでを OpenCode 単体でやり、どこから Oh My OpenCode を足すべきか」です。

まずは OpenCode 単体で使い始める のが正解です。plan と build の流れを掴み、実際の AGENTS.md を作り、権限やカスタムコマンドの感覚を先に身につける。そのうえで、複数モデルの振り分けや並列実行を強めたいときに Oh My OpenCode を足すと、無駄が少ないです。

先に全体像を押さえたいなら、AI Coding トピックページ と Codex の使い方、Parallel Code Agents の解説 が役立ちます。OpenCode 系の立ち位置をざっくり比較したいなら、OpenClaw vs ZeroClaw vs Pi Agent vs Nanobot も読みやすいです。

まず結論: OpenCode 単体と Oh My OpenCode のどちらから始めるべきか

OpenCode だけでも、コードベースを理解して、変更を計画して、安全に編集するという基本ループは十分回せます。Oh My OpenCode は有用ですが、最初の一歩ではありません。

OpenCode とは何か

OpenCode は、ターミナル中心のワークフローに寄せたオープンソースの AI coding agent です。公式 README と docs では、次のような特徴が明示されています。

• TUI を中心にした coding agent
• beta の desktop app
• IDE extension
• OpenAI / Anthropic / Google など複数 provider を扱える provider-agnostic な構成
• built-in agent、権限、custom commands、rules、formatting、LSP support を含むツール群

大事なのは、OpenCode を単なる「コードを書いてくれるチャット」と見なさないことです。実態は agent workflow の操作面 です。次のような用途に向いています。

• 見慣れない repo の調査
• 編集前の plan 作成
• ファイル編集と shell command 実行
• AGENTS.md によるプロジェクトルール化
• 繰り返し使う slash command の定義
• repo のリスクに応じた権限調整

一点だけ補足すると、古い記事や古いリンクはすでに stale です。2026 年 3 月 17 日時点 では、OpenCode の現在の配布元は anomalyco/opencode で、最新 release は v1.2.27（2026 年 3 月 16 日公開）です。古い archived repo に当たった場合は、今の install 対象ではありません。

OpenCode の始め方

1. OpenCode をインストールする

公式の最短手順は次の通りです。

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

Homebrew、npm、Scoop、Chocolatey、mise、nix でも入れられますが、まずは install script で動かすのが最短です。

2. provider をつないで、実際の project を開く

起動後は、公式 docs では次のフローが案内されています。

/connect

TUI で opencode を選び、opencode.ai/auth で認証するか、普段使っている provider を設定します。

最初の project は、いきなり巨大 repo にしないほうがいいです。自分でレビューできる程度に把握している repo から始めると、OpenCode の良し悪しが見えやすくなります。

3. 本格的な作業の前に /init を実行する

OpenCode では repo 用の AGENTS.md を生成できます。

/init

ここで作られるのは、今後の agent に効く持続的なルールです。Git に入れておく価値があります。毎回同じ説明を繰り返さなくて済むので、体感の安定性がかなり上がります。

4. 最初は plan から入る

OpenCode には Tab で切り替える 2 つの built-in agent があります。

• build は実装向け
• plan は調査向け

最初のタスクは plan で、範囲を狭くします。

この repository の build / test / release の流れを要約してください。
主要な entrypoint も教えてください。
まだ編集はしないでください。

理解が合っていると分かってから、build に切り替えれば十分です。

実践で効く 7 つの Tips

Tip 1: 見慣れない codebase では plan を標準にする

plan と build を分ける設計は、単なる安全装置ではありません。品質にも効きます。

いきなり build に入ると、理解が固まる前にファイルを書き換え始めることがあります。先に plan を通すと、architecture、命名、test flow、影響範囲を一度で確認できます。

例えばこうです。

`@src/auth/index.ts` の認証フローを説明してください。
その後で、最小の修正案を 2 つ出してください。
まだ編集はしないでください。

@ で file を参照できるのは、OpenCode の実用性が高いポイントです。

Tip 2: /init と AGENTS.md を軽視しない

これはただの setup ではありません。実際にはかなりの force multiplier です。

AGENTS.md には次のような内容を入れると効果的です。

• build / test / lint コマンド
• repo の構造と package の境界
• style rule と review の期待値
• 触ってほしくない範囲
• done の定義

これを省略すると、毎回 chat で同じ説明を繰り返すことになり、ノイズが増えます。

この考え方は、Claude Agent SDK で Claude-Code-Like な AI Agent を作る でも共通です。agent を使う側でも、ルールの置き場所は重要です。

Tip 3: デフォルトの権限は、最初は慎重に扱う

OpenCode は設定可能で、公式 docs でも allow / ask / deny の考え方が明確です。

新しい repo では、まず次のような控えめな設定から入るのが実務的です。

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "ask",
    "bash": "ask"
  }
}

少し遅くなっても、初期の想定外を避けられます。慣れてきたら、低リスクな command だけ徐々に緩めれば十分です。

Tip 4: 追加ツールを増やす前に custom command を作る

OpenCode は /init、/undo、/redo、/share、/help などの built-in command に加えて、.opencode/commands/ から custom command も追加できます。

つまり、よくある作業のかなりの部分は、新しい framework を入れなくても回せます。例えば次のような command です。

• /test
• /review
• /ship-check
• /seo-page

たとえばこう書けます。

---
description: Run tests related to the current change
agent: build
---
 
この session で触った file に関連する test を実行してください。
まず失敗を要約し、その後で最小の修正案を提案してください。

よく使う指示を短くでき、再利用性も上がります。

Tip 5: provider を増やしすぎる前に、1 つをきちんと使う

provider-agnostic なのは強みですが、同時に設定を増やしすぎる原因にもなります。

最初から 5 provider、3 つの fallback chain、独自の model matrix を組む必要はありません。まずは、すでに課金していて挙動を知っている provider から始めれば十分です。

このカテゴリに初めて入るなら、Codex の使い方 もあわせて読むと、別方向の製品でも同じ教訓があると分かります。つまり、道具を増やす前に、タスクを絞るほうが強いです。

Tip 6: terminal / desktop / IDE の勝ち筋を分けて考える

OpenCode は、もう単なる terminal binary ではありません。

最速の往復が欲しいなら terminal。

review の見通しや session 管理、画面上の分かりやすさを重視するなら desktop app。

普段の editor をそのまま使いたいなら IDE extension。

間違いは、どれかを永久に固定することではなく、今の task に合っていない面を使ってしまうことです。

Tip 7: 変更の整形は任せても、差分の責任は人間が持つ

OpenCode はファイル編集後に language-specific formatter を自動で使えると docs にあります。これは便利ですが、formatter が通ることと、変更が正しいことは別です。

次は必ず確認したいです。

• 実装が要件に合っているか
• 実行しようとしている bash command が妥当か
• AGENTS.md の指示に従っているか
• 変更範囲が大きすぎないか

AI coding agent は typing を減らしますが、engineering judgment までは代替しません。

Oh My OpenCode を足すタイミング

Oh My OpenCode は OpenCode 本体ではありません。OpenCode の上に乗る、より opinionated な orchestration layer です。

現在の docs と README では、次のような要素が前面に出ています。

• specialist agent を束ねる orchestration
• category-based model routing
• background agent と parallel work
• MCP 系のワークフロー
• ultrawork / ulw のような強い完了志向
• 「最後までやり切る」ための harness 設計

OpenCode 単体が軽く感じ始めたら、この組み合わせを検討する価値があります。

Oh My OpenCode の価値は、OpenCode が弱いことではありません。delegation、orchestration、model specialization をもっと強くしたい人にとって、より尖った harness になることです。

OpenCode と Oh My OpenCode をどう組み合わせるか

1. まずは OpenCode 単体を安定して動かす

いきなり harness を重ねるのは得策ではありません。

先に次を自分で再現できるようにします。

• OpenCode の install
• provider の認証
• /init の実行
• 1 回の plan
• 1 回の build

ここが曖昧なまま Oh My OpenCode を足すと、原因切り分けが難しくなります。

2. 名前の違いは先に整理しておく

少し紛らわしいですが、今はこう理解しておけば十分です。

• GitHub repo は code-yeongyu/oh-my-openagent
• branding と package name は Oh My OpenCode
• install command は oh-my-opencode

2026 年 3 月 17 日時点 では、同じ系譜のプロジェクトとして扱って問題ありません。

3. 公式 installer で導入する

手動で入れるなら、まずは次です。

bunx oh-my-opencode install

プロジェクト自身も、AI agent に installation guide を読ませて進めるフローを推奨しています。

4. 最初は 1 つの高価値コマンドだけ試す

代表的なのはこれです。

ultrawork

短縮形の

ulw

も使えます。ただし、魔法の言葉として扱わないほうがいいです。最初は、完了条件が明確な中くらいの task にだけ使うのが安全です。

向いている例:

• 限定的な bug 修正と関連 test
• 1 つの scope に閉じた feature 実装
• ノイズの多い file 群の整理
• すでに理解している repo での parallel research + implementation

最初に避けたい例:

• 仕様が曖昧な greenfield architecture
• rollback plan のない production migration
• 権限設計が甘い sensitive repo

5. multi-model orchestration の恩恵がある作業で使う

Oh My OpenCode は、次のような仕事で特に意味が出ます。

• planning / reasoning / frontend で別の model を使いたい
• background specialist を回したい
• MCP を積極的に使いたい
• subagent の規律を強めたい

日常の仕事が「1 ファイルを少し直して test を回す」程度なら、OpenCode 単体で十分なことも多いです。

OpenCode 単体と OpenCode + Oh My OpenCode の比較

実務的には、次の順番がいちばん堅いです。

1. まず OpenCode を覚える
2. 実際の AGENTS.md を用意する
3. 2〜3 個の custom command を作る
4. 権限を絞る
5. それでも足りないなら Oh My OpenCode を足す

よくある落とし穴

OpenCode と OpenClaw を混同する

これは別物です。

OpenCode を探しているのに OpenClaw を見ているなら、おそらく欲しいのは OpenCode のほうです。plan、build、/init、Oh My OpenCode との組み合わせまで含めて考えるなら、こちらが本命です。

古いリンクをそのまま信じる

OpenCode 周辺は repo の移動や古い記事が混ざりやすいので、install 前に公式 docs を確認したほうが安全です。

基本を覚える前に harness を重ねる

OpenCode 単体の挙動を理解していないと、問題が base agent、harness、provider、repo ルールのどれにあるのか分からなくなります。

初日から subscription を増やしすぎる

provider flexibility は強みですが、最初はすでに使っている provider を 1 つ使いこなすほうが先です。

FAQ

OpenCode は OpenClaw と同じですか？

いいえ、別プロジェクトです。このページは、opencode.ai で案内されているオープンソースの AI coding agent である OpenCode を説明しています。

OpenCode を使うのに Oh My OpenCode は必須ですか？

必須ではありません。OpenCode 単体でも十分使えます。Oh My OpenCode は、より強い orchestration や multi-model workflow が欲しくなったときに価値が出ます。

最初にやるべきことは何ですか？

/connect を実行し、実際の project を開いて、/init を実行し、plan で repo の要約を出させてから編集に進むのがよいです。

terminal、desktop、IDE のどれから始めるべきですか？

まずは terminal がおすすめです。すでに review-heavy な desktop workflow や editor-native な workflow を好むと分かっているなら、その限りではありません。

Oh My OpenCode に進む目安は？

OpenCode 単体を自然に使えて、AGENTS.md が整っていて、複数の専門 agent を束ねたい欲が何度も出るなら、その段階です。

Related Guides

• AI Coding トピックページ
• Codex の使い方
• Parallel Code Agents の解説
• Claude Agent SDK で Claude-Code-Like な AI Agent を作る
• OpenClaw vs ZeroClaw vs Pi Agent vs Nanobot