OpenCodeは、オープンソースのAIコーディングエージェントです。
Claude CodeやCodexと同じように、ターミナルからコードを読ませて、ファイルの作成やコマンドの実行まで任せられます。
使い方の流れは、次の5つです。
- インストールする(Windowsでは公式がWSLを勧めている)
- 作業するフォルダで
opencodeを起動する /connectで接続先を選ぶ(無料モデルだけなら不要だった)/modelsで使うモデルを選ぶ- 頼みたいことを入力する。ファイルは
@で指定し、計画だけ欲しいときは Tab で Plan に切り替える
各手順は基本の操作と、下の節で順に説明します。
特徴は、多くの提供元を選び、モデルを切り替えて使えることです。
Claude CodeやCodexにも、Ollamaなどを通じて別のモデルへ接続する方法があります。
- OpenCode自体は無料(MITライセンス)で、料金はつなぐモデルによって決まる
- 2026年10月20日時点では、ログインしなくても期間限定の無料モデルを選べた
- Claude Pro・Maxの契約でのログインは、Anthropicが禁止しているため使えない
- 初期設定では、ファイルの変更やコマンドの実行を確認なしで行うので、最初に権限を絞る
この記事は、2026年10月20日にWindows 11でOpenCode 1.19.3を動かし、公式ドキュメントと照らして書いています。
2026年11月11日時点の最新は、OpenCode 1が1.19.5、次の版のOpenCode 2(@opencode/cli)が2.2.7です(npmの公開情報)。
英語の公式ドキュメントの入門ページはOpenCode 2の手順に変わっていて、日本語の公式ドキュメントはOpenCode 1の内容です。
OpenCodeとは
OpenCodeは、anomalycoが開発しているAIコーディングエージェントで、ソースコードはGitHubでMITライセンスで公開されています。
ターミナルの画面(TUI)のほか、デスクトップアプリやエディターの拡張からも使えます。
OpenCodeは75以上の接続先とローカルモデルに対応しています。
各サービスの認証方法・利用条件に合わせて設定します。
| 項目 | 内容 |
|---|---|
| 開発元 | anomalyco(GitHub:anomalyco/opencode) |
| ライセンス | MIT |
| 記事の実行検証版 | 1.19.3(2026年10月20日の実行記録) |
| 使い方 | ターミナル(TUI)・デスクトップアプリ・IDE拡張 |
| 使えるモデル | OpenCodeの公式サービス、各社のAPIキー、ChatGPT Plusなどの契約、手元のローカルLLM |
OpenCode 2という次の版も別のパッケージで公開されていますが、OpenCode 1と同じopencodeコマンドを使うため、同じグローバル環境への導入ではコマンド名が衝突します。
版を分けて試す場合は実行環境を分離してください。
OpenCode 2の入門ページでは、npmのパッケージ名が @opencode/cli に変わり、Windowsのパッケージマネージャーには対応しないと書かれています(11月11日確認)。
この記事のインストール表と手順は、OpenCode 1の入れ方です。
この記事の実行例はOpenCode 1.19.3を対象にしています。
2026年11月11日に、日本語の公式ドキュメント(OpenCode 1)と本文の手順を再照合しました。
版を省略したインストールコマンドでは新しい版が入る場合があり、権限名やPlanの挙動を同じとは扱えません。
OpenCodeのメリットとデメリット
| メリット | 内容 |
|---|---|
| ソフトが無料 | MITライセンスのオープンソースで、OpenCode自体に料金はかからない |
| モデルを選べる | 75以上の接続先から、作業に合ったモデルをつなぎ替えられる |
| 無料で試せる | 期間限定の無料モデルなら、ログインなしで使えた(2026年10月20日時点) |
| 手持ちの契約やPCを使える | ChatGPT Plus・GitHub Copilotの契約や、ローカルLLMでも動く |
| 計画だけ立てさせられる | Planは通常の編集を制限するが、コマンド実行は権限設定に従う。読み取り専用を保証する機能ではない |
| デメリット | 内容 |
|---|---|
| 初期設定の権限がゆるい | 何も設定しなければ、ファイルの変更もコマンドの実行も確認なしで行う |
| Claudeの契約で使えない | Claude Pro・Maxでのログインは、Anthropicが禁止している |
| 無料モデルは入れ替わる | 期間限定で、入力した内容が改善に使われるモデルもある |
| モデル・接続先によって結果が変わる | 同じモデルでも、エージェントの指示やツール実装・接続先により結果が異なる |
| Windowsは手間が増える | 公式はWSLでの利用を勧めている |
料金:OpenCodeは無料、モデル代は接続先しだい
OpenCode本体は無料です。
Go・Console・Enterpriseなどの有料サービスは別に提供されています。
かかるのは、つないだモデルの利用料です。
| つなぎ方 | 料金 | 向いている人 |
|---|---|---|
| 無料モデル(期間限定) | 0円 | まず試したい人 |
| OpenCodeの従量課金(Console) | 使った分だけ。クレジットを前払い | いろいろなモデルを1つの窓口で使いたい人 |
| OpenCode Go | 月10ドル、Go Plusは月40ドル | 対象モデルを月額の利用枠内で使いたい人 |
| 各社のAPIキー | 各社の従量課金 | DeepSeekやOpenAIのAPIをすでに使っている人 |
| ChatGPT Plus・GitHub Copilot・GitLab Duo | その契約の範囲 | これらの契約を持っている人 |
| ローカルLLM(Ollama・LM Studioなど) | API利用料なし(機材・電気代、モデル等の条件は別途) | モデルと追加ツールをローカルだけで構成したい人 |
OpenCode Goの利用枠は月額のドル建てで決まり、5時間で月の20%、1週間で50%までという区切りがあります。
GoでDeepSeek V4.1 Flash・V4 Proを使うには、ワークスペースの所有者または管理者がSettings › Privacy › RegionsでGlobalを選ぶ必要があります。
通常の初期設定はEurope & United Statesなので、モデルを選べない場合は、データの処理地域を変更してよいか確認してから設定してください。
これはGo公式文書を2026年10月27日に確認した手順です。
無料モデルは期間限定で、入れ替わります。
Goは1人用ワークスペース向けです。
Extra usageを有効にすると利用枠超過後にConsole残高へ課金が切り替わるため、定額内に収めたい場合はこの設定も確認します。
OpenCode Goの使い方
Goの公式ドキュメント(11月11日確認)では、次の順で使い始めます。
- Go(またはGo Plus)に申し込み、支払い情報を入れて、APIキーをコピーする
- OpenCodeの画面で
/connectを実行し、OpenCode Go を選んでキーを貼る /modelsで、Goで使えるモデルを選ぶ
設定ファイルでモデルを決めておくときは、opencode-go/モデルID の形で書きます。
利用枠は月のドル額で決まり、5時間で月の20%、1週間で50%までという区切りがあります。
Claude Pro・Maxの契約では使えない
OpenCodeの接続先にAnthropicはありますが、使えるのはAPIキーで払う形です。
公式ドキュメントには、Claude Pro・Maxの契約でOpenCodeを使うプラグインがあるものの、Anthropicがこれを明確に禁止していると書かれています。
以前の版には、そのプラグインが同梱されていましたが、1.3.0からは外されています。
ChatGPT Plus・GitHub Copilot・GitLab Duoにも接続できますが、それぞれの認証と利用条件を満たす必要があります。
GitLab Duo連携は実験的な機能で、公式案内ではGitLab PremiumまたはUltimateと、管理者によるDuo・Agent Platformの有効化などが必要です(GitLab Duoの接続条件)。
関連記事:Claude Codeのログイン方法の違い|サブスクとAPIキー
インストール
公式は、Windowsでは、WSL(Windows上のLinux)で使うことを勧めています。
ファイルの読み書きが速く、OpenCodeが使う道具との相性がよいためです。
| 環境 | 入れ方 |
|---|---|
| Mac・Linux・WSL | curl -fsSL https://opencode.ai/install | bash |
| Node.jsがある環境 | npm install -g opencode-ai |
| Windows(Chocolatey) | choco install opencode |
| Windows(Scoop) | scoop install opencode |
| Mac(Homebrew) | brew install anomalyco/tap/opencode |
11月11日に、日本語の公式ドキュメントでも、Windowsの選択肢にChocolatey・Scoop・npmがあることを確かめました。
グローバルにインストールせず試すなら、npxで指定版を取得・実行できます。
パッケージはキャッシュされます。
npx -y opencode-ai@1.19.3 --version1.19.3と表示されれば、その版のCLIが起動できています。
モデル接続やコード生成まで確認できたわけではありません。
無料モデルで実際に動かしてみた
ログインせずに、どのモデルを選べるかを確かめました。
npx -y opencode-ai@1.19.3 models opencode表示されたのは、名前の最後がfreeのモデルを中心とした12個でした。
opencode/big-pickle
opencode/deepseek-v4.1-flash-free
opencode/glm-5.3-flash-free
opencode/nemotron-3-ultra-free
(ほか8個)この中から、DeepSeek V4.1 Flash Freeを使って、練習用のフォルダで小さな作業を頼みました。
フォルダには、品名・数量・単価の3列のCSVだけを置いています。
npx -y opencode-ai@1.19.3 run -m opencode/deepseek-v4.1-flash-free "このフォルダの sales.csv を読んで、品名ごとの金額(数量×単価)と合計を計算する Python スクリプト total.py を作り、実行して結果を見せてください。"OpenCodeは、ファイルを探して読み、total.pyを作って実行しました。
最初の実行では、Windowsのコンソールで日本語が文字化けしました。
OpenCodeはそれに気づき、出力をUTF-8にする1行を足して、もう一度実行しました。
りんご: 360円
みかん: 400円
バナナ: 300円
合計: 1,060円頼んでから終わるまでは、約35秒でした。
使った量は、opencode statsで確かめられます。
| 項目 | 値 |
|---|---|
| メッセージ数 | 8 |
| 入力トークン | 21.0K |
| 出力トークン | 587 |
| キャッシュから読んだトークン | 61.4K |
| 使った道具 | コマンド実行4回、ファイル検索・読み込み・作成・編集が各1回 |
| 費用 | 0.00ドル |
この作業では、ファイルの作成もコマンドの実行も、確認を求められずに進みました。
理由は、次の権限の初期設定にあります。
最初に必ず見る:権限の初期設定
公式ドキュメントでは、OpenCodeの権限は、何も設定しなければ「許可」から始まると書かれています。
| 操作 | 初期設定 |
|---|---|
| ファイルの読み込み | 1.19.3のソースでは通常許可、*.env・*.env.*は確認、*.env.exampleは許可 |
| ファイルの編集・コマンドの実行など | 許可 |
| 作業フォルダの外への操作 | 確認 |
| 同じツール・同じ入力を3回繰り返すとき | 確認 |
初期設定だけで、すべての変更を事前確認できるとは限りません。
2026年10月27日に再確認したOpenCode 1の公式文書では、*.env・*.env.*は確認、*.env.exampleは許可となっており、1.19.3の実装と一致しています。
編集やコマンド実行も事前に確認したい場合は、次のように制限を明示してください。
次は1.19.3向けのopencode.jsonで、編集とコマンド実行を確認制にする例です。
現在のOpenCode 1の権限ドキュメントも、コマンド実行にbashを使っています。
OpenCode 2など別の版を使う場合は、その版の権限名と設定方法を確認してください。
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"edit": "ask",
"bash": "ask"
}
}確認なしで任せたいときだけ、起動時に--autoを付けます。
この場合も、設定で「拒否」にした操作は止まります。
BuildとPlan:2つの作業モード
OpenCodeには、最初から2つの作業モードがあり、Tabキーで切り替えます。
| モード | 動き | 使いどころ |
|---|---|---|
| Build(初期設定) | すべての道具を使い、ファイルの変更やコマンドの実行まで行う | 実際に作業を進めるとき |
| Plan | 1.19.3では計画ファイル等を除く編集を既定で拒否。コマンドは権限設定に従い、毎回確認とは限らない | コードを読ませて、計画や提案だけ出させたいとき |
Planの制限もユーザーの権限設定で上書きされます。
Planを選んだだけで変更を防げるとは考えず、コマンド権限と適用設定を確認してから使ってください。
1.19.3の挙動は該当版のエージェント実装で確認できます。
最初の設定の流れ
- 作業するフォルダで
opencodeを起動する /connectで接続先を選び、APIキーなどを入れる(無料モデルだけなら不要)/modelsで使うモデルを選ぶ/initでプロジェクトを読ませ、AGENTS.mdを作らせる- Tabキーでモードを確かめてから、頼みたいことを入力する
AGENTS.mdは、プロジェクトの構成や決まりをOpenCodeに伝えるファイルです。
公式は、このファイルをGitに入れて共有することを勧めています。
関連記事:CodexのAGENTS.mdの書き方と読み込まれる場所
基本の操作
起動したあとの画面(TUI)では、入力欄に文章を書いて頼みます。
よく使う操作は次のとおりです。
| やりたいこと | やり方 |
|---|---|
| ファイルを指定して聞く | @ に続けてファイル名を入れる(あいまい検索) |
| コマンドの結果を渡す | ! に続けてコマンドを入れる(例:!ls -la) |
| 計画だけ立てさせる | Tabキーで Plan に切り替える |
| 変更を取り消す・やり直す | /undo・/redo(Gitで管理しているフォルダが必要) |
| 新しい会話を始める | /new |
| 前の会話に戻る | /sessions |
| 長い会話を軽くする | /compact |
| 終了する | /exit |
ctrl+x に続けてキーを押す操作もあり、ctrl+x n で新しい会話、ctrl+x u で取り消しです。
画面を開かずに1回だけ頼むときは、opencode run "依頼文" の形で実行できます。
この記事の無料モデルの検証も、この形で行いました。
無料モデルは提供元ごとにデータの扱いを確認する
無料モデルでも、改善利用の有無と保存期間は別々に確認します。
次は条件が異なる例です。
| 種類 | 例 | データの扱い(公式の記載) |
|---|---|---|
| 各社の試験場として出しているモデル | Big Pickle、MiMo系・Nemotron系のFreeなど(対象はモデルごとに確認) | 無料の期間中に、開発元が意見を集めてモデルを改善している。入力が改善に使われることがある |
| 公開済みのモデルの期間限定の無料版 | DeepSeek V4.1 Flash Free・GLM-5.3-Flash Free | 保存せず、学習にも使わない |
NVIDIAのNemotron系は試用のみで、個人情報や機密を入れないよう案内されています。
有料なら機密を入力できるとは限りません。
Goにも学習利用を認めるContributorモデルや30日保存のモデルがあります。
Beam Freeは学習に使わず30日保存という条件です。
案件ごとに、接続先の保存・学習・外部送信条件を確認してください。
GoのDeepSeekの保存なし契約は月次更新で、確認時点の有効期限は2026年10月31日とされています。
名前を伏せたモデルは、個人の練習で試すくらいに分けておくと安心です。
無料で選べるモデルの一覧は変わるので、使う前にもう一度確かめてください。
Claude Code・Codexとの違い
| 項目 | OpenCode | Claude Code | Codex |
|---|---|---|---|
| ソフトの料金 | 無料(オープンソース) | 契約またはAPIキー | ChatGPTの契約またはAPIキー |
| 使えるモデル | 多くの会社のモデルとローカルLLMから選ぶ | 通常はClaude。互換APIで別モデルへの接続も可能 | 通常はOpenAI。ローカル提供元なども設定可能 |
| 権限の初期設定 | ほとんど許可 | 確認を求める | サンドボックスで制限 |
| 無料で試す | 期間限定の無料モデルあり | — | 条件付きでFree・Goにも案内あり |
性能はモデルだけでなく、エージェントの指示・ツール・コンテキスト・接続先にも左右されます。
別のツールと同じ成果が得られるかは、同じ作業で検証してください。
一方で、Claude CodeやCodexは、自社のモデルに合わせて道具の使い方を調整しています。
同じモデルでも、使い勝手や結果が同じになるとは限りません。
関連記事:Codex・Antigravity・Claude Codeの機能を比較
Claude Code・Codexよりお得になるのはどんなとき?
費用はモデルの単価・使用量・キャッシュ率・利用時間帯と、定額プランの上限を合わせて比較します。
OpenCode Goは、月額料金より多くのモデル代を使える作りになっています。
| プラン | 月額 | DeepSeek V4.1 Flashで使える額(月) | GPT 6 Luna・Claude Haiku 5.5で使える額(月) |
|---|---|---|---|
| Go | 10ドル | 80ドル分 | 15ドル分 |
| Go Plus | 40ドル | 160ドル分 | 60ドル分 |
ただし、5時間で月の20%まで、1週間で50%までという区切りもあります。
次はDeepSeek Flashのピーク単価(100万トークン当たりキャッシュ入力0.006ドル、非キャッシュ入力0.30ドル、出力1.20ドル)で、同じ量を30日使う仮定です。
1つ目の例は(9×0.006+1×0.30+0.3×1.20)×30=21.42ドル、2つ目は(47.5×0.006+2.5×0.30+1.5×1.20)×30=85.05ドルです。
| 使い方(1日に使う量の仮定) | DeepSeekのAPIに直接払う | OpenCode Go |
|---|---|---|
| プログラミング支援で毎日使う(入力1,000万トークン・うち9割はキャッシュ、出力30万) | 月約21ドル | 月額枠内の計算。ただし5時間・週の上限と他モデル使用量も確認 |
| エージェントを長時間回す(入力5,000万・うち95%はキャッシュ、出力150万) | 月約85ドル | Go Plusの月額枠内の計算。ただし時間帯別上限も確認 |
一方で、Goに入っているのは比較的安いモデルで、OpusやGPT-6 Solのような最上位のモデルは含まれていません。
Go対象外のモデルは、各社APIや対応する契約など別の接続方法を検討します。
従量課金が定額より高くなるかは、使用量と定額側の利用制限によって変わります。
ChatGPT Plusの契約はOpenCodeでも使えますが、料金はCodexで使うのと同じです。
| 作業 | 比較する候補 |
|---|---|
| ファイルの一括処理・定型の修正など、量が多く単純な作業 | OpenCodeと安いモデル(Goなど) |
| 設計・文章の仕上げなど、品質が大事な作業 | Claude Code・Codexの定額で最上位のモデル |
小さな同一作業で費用・成功率・修正時間を測り、利用枠内で必要な品質を得られる組み合わせを選びます。
単純な作業でも低価格モデルで足りるとは限りません。
OpenCodeは何で収益を得ているのか
ソフトが無料なのに続けられるのは、公式ドキュメントを見る限り、次の有料サービスがあるためです。
| サービス | 中身 | 収益の形 |
|---|---|---|
| OpenCode Go | 月10ドル・40ドルの定額プラン | 月額利用料。原価・利益率は非公表 |
| OpenCode Enterprise | 法人向け。社内のSSOや社内のAIの窓口だけを使わせる設定をまとめて提供 | 利用者1人あたりの料金(金額は問い合わせ) |
| Console(従量課金) | いろいろなモデルを1つの窓口で使える | カード手数料はそのまま転嫁し、それ以上は取らないと明記 |
Enterpriseのページは、OpenCode側でコードや作業内容を保存しないと説明しています。
接続するAI提供元の保存条件や共有機能の扱いまで同じとは限りません。
無料のソフトと有料サービスを併設していますが、実際の収益内訳や採算は公開資料だけでは分かりません。
無料モデルの開発元がOpenCodeに費用を払っているかどうかは、公式には書かれていません。
ローカルLLMとつなぐ
OllamaやLM Studioで動かしているモデルも、OpenCodeの接続先にできます。
公式ドキュメントは、道具の呼び出しがうまく動かないときは、道具の扱いが得意なモデル(Qwen-CoderやDeepSeek-Coder系など)を選ぶよう勧めています。
関連記事:ローカルLLMでコーディングする方法
関連記事:DeepSeek-V4.1-Flash-1017を動かすのに必要なPCは?
よくある質問
Q. 本当に無料で使えますか。
OpenCode自体は無料です。
2026年10月20日時点では、ログインしなくても期間限定の無料モデルを選べ、今回の作業も0.00ドルでした。
無料モデルは入れ替わるので、ずっと同じモデルを無料で使える保証はありません。
Q. Windowsでもそのまま使えますか。
今回はWindowsのPowerShellから、そのまま動かせました。
公式はWSLを勧めているので、長く使うならWSLに入れるほうが安定します。
Q. 無料モデルは誰が提供しているのですか。
各モデルの開発元です。
名前を伏せたステルスモデルは、正式に出す前に意見を集める目的で、期間限定で無料にしていると公式に説明されています。
Q. Claudeのモデルを使いたいときは。
AnthropicのAPIキーをつなぎます。
料金は、Claude Pro・Maxの契約とは別に、APIの従量課金でかかります。
まとめ
- OpenCodeは、モデルを選んでつなげるオープンソースのAIコーディングエージェント
- ソフトは無料で、料金はつなぐモデルによって決まる
- 期間限定の無料モデルなら、ログインなしで試せた
- 初期設定ではほとんどの操作を確認なしで行うので、最初に編集とコマンドを「確認」にする
- Claude Pro・Maxの契約では使えない
- 料金だけでなく、利用上限と実際の成功率・修正時間を比べて接続先を選ぶ
出典:
