OpenCode 2実践編：無料のDeepSeek V4.1 Flashでタスク管理アプリを作る

前回の記事では、OpenCode 2の導入からモデル選択、PlanとBuildの使い分け、MCPによる外部サービスとの接続までを紹介しました。今回はその続きとして、1つのアプリを作るところまで進めます。

使うモデルは、DeepSeek V4.1 Flashです。OpenCodeの公式モデル一覧には、無料で利用できる「DeepSeek V4.1 Flash Free」が追加されています。コードを書かせて終わるのではなく、仕様を考え、実装し、動作を確認して修正する流れを、このモデルでたどります。

なお、公式ドキュメントでは無料提供を期間限定としています。本記事のモデル名と提供条件は2026年10月15日時点のものです。OpenCode公式モデル一覧

今回作るのは、ブラウザで動くタスク管理アプリ

題材には、個人用のタスク管理アプリを選びます。最初に作る機能は次の5つです。

• タスクを追加する
• タスクを完了・未完了に切り替える
• タスクを削除する
• すべて・未完了・完了で表示を切り替える
• ブラウザを再読み込みしてもタスクを保持する

HTML、CSS、JavaScriptで作り、データはブラウザのlocalStorageに保存する構成にします。ログイン、データベース、外部APIは使いません。

最初の題材を小さくしておくと、生成されたコードと画面の動きを対応させやすくなります。たとえば、タスクの追加は動くのに、再読み込みすると消える。その場合は、保存や読み込みの処理を調べる、というように問題を絞れます。

この記事では、OpenCode 2のインストールが済んでいることを前提にします。後半のプレビューには、Node.jsとnpmに含まれるnpxを使います。

Windowsで実際に生成し、25項目を確認した

今回の検証では、Windows上のOpenCode 2.0.18から opencode/deepseek-v4.1-flash-free を指定して、PlanとBuildを実行しました。生成されたアプリ本体を手作業で修正せず、ブラウザで動作を確認しています。

通常の画面操作など20項目と、意図的に障害を発生させた5項目の計25項目が通りました。画面幅の確認はブラウザの表示幅を変えたもので、スマートフォン端末での検証は含みません。

以下は、タスクを2件追加し、片方を完了にしてから再読み込みした画面です。本文と完了状態が保持されています。

無料版のDeepSeek V4.1 Flashを選ぶ

まず、作業用のディレクトリを作ってOpenCodeを起動します。以下はPowerShellでも使えるコマンドです。

mkdir opencode-task-demo
cd opencode-task-demo
opencode

起動したら、モデル一覧を開きます。

/models

一覧で選ぶのは、DeepSeek V4.1 Flash Freeです。公式カタログでは、通常版と無料版は別のモデルIDとして登録されています。

OpenCode提供の無料版を指定する場合の形式は、次のとおりです。

opencode/deepseek-v4.1-flash-free

通常版には別の料金設定があるため、無料枠で進める場合は「Free」まで確認してください。モデルIDと料金の公式一覧

OpenCode側のプロバイダーにまだ接続していない場合は、/connect から接続を進めます。認証やAPIキーの入力を求められたら、接続画面と公式Consoleの案内に従ってください。その後、もう一度 /models を開きます。プロバイダー接続の公式手順

今回の検証環境では、OpenCode用のAPIキーを追加登録せずに無料モデルを実行できました。

毎回同じモデルを使いたい場合は、プロジェクト直下の opencode.jsonc に既定値を書けます。設定ファイルがすでにある場合は、既存の内容に model を追加します。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "opencode/deepseek-v4.1-flash-free"
}

/models での選択は現在のセッションに適用され、設定ファイルの書き換えは行いません。また、既存セッションで選んだモデルは設定ファイルの既定値より優先されます。設定を変えた後も、セッションの使用モデルを確認しておくと確実です。モデル選択と既定値の仕様

Planで仕様とファイル構成を決める

モデルを選んだら、エージェントをPlanに切り替えます。Planは、通常のプロジェクトファイルを編集せず、調査や実装計画を進めるためのエージェントです。シェル操作には引き続きPermissionの設定が適用されます。PlanとBuildの公式説明

なお、今回の検証ではCLIの --model と --agent でモデルと役割を指定しました。本文で案内している /models での選択や画面上のエージェント切り替えは、公式資料に基づく操作案内です。

まずは、次のように依頼します。

ブラウザで動く個人用のタスク管理アプリを作りたいです。
まず実装計画を考えてください。まだファイルは変更しないでください。

要件：
- HTML、CSS、JavaScriptを使う
- フレームワークと外部APIは使わない
- タスクの追加、完了切り替え、削除ができる
- すべて・未完了・完了で表示を絞り込める
- localStorageでデータを保存する
- 空欄や空白だけのタスクは追加できない
- 日本語の画面にする
- スマートフォンでも操作できる

提案してほしいもの：
1. ファイル構成
2. タスクのデータ構造
3. 実装する順番
4. 動作確認する項目

ここで確認したいのは、要件と提案が合っているかです。ログイン機能やクラウドDBが追加されていたら、今回の範囲から外します。ファイル構成も、アプリ本体は index.html、style.css、app.js 程度で十分です。

計画に手を入れたいときは、その場で条件を足します。

アプリ本体はindex.html、style.css、app.jsの3ファイルにしてください。
起動方法と手動確認の手順はREADME.mdにまとめてください。
タスクの並び替えや期限の設定は、今回は追加しないでください。
この条件で計画を更新してください。

最初の計画で、何を作るかと、どこまでできたら完成とするかをそろえておきます。

Buildに切り替えて実装する

計画が固まったら、Buildに切り替えます。Buildは、ファイルの作成・編集やコマンド実行を含む開発作業を担当します。エージェントの役割

実装の依頼では、合意した計画を参照しながら、確認してほしい処理も伝えます。

合意した計画に沿って実装してください。

追加の条件：
- タスク本文はHTMLとして解釈せず、文字列として表示する
- 保存データの読み込みに失敗しても、画面全体が操作不能にならないようにする
- 保存に失敗した場合は、利用者が分かるメッセージを出す
- 入力欄とボタンに分かりやすいラベルを付ける
- キーボードでも追加・完了切り替え・削除を操作できるようにする
- 新しい依存パッケージは追加しない
- タスクの削除は確認ダイアログを出さず、その場で行う

実装後に、作成したファイルと役割、確認した内容、
まだ確認できていない内容を説明してください。

タスク本文の表示方法まで指定しているのは、入力した内容がそのまま画面に出るアプリだからです。見た目だけを頼むと抜けやすい条件を、入力・保存・操作の単位で補っています。

OpenCodeが完了を報告したら、作成されたファイルと説明を確認します。ブラウザ操作を行っていない場合は、画面上の動作確認はこれからです。

今回のBuildは、ファイル生成とモデル側の確認処理を含めて約5分51秒でした。実行ログに記録された cost は0です。これは今回の実行ログの値であり、請求管理画面の明細確認は行っていません。

モデル自身もNode.js上で確認を行いましたが、OpenCode側からのブラウザ接続は失敗していました。そのため、ここからの画面確認は別途こちらでブラウザを操作して行っています。また、モデルの最後の説明が中国語になる場面がありました。アプリの画面は日本語で生成されています。

ブラウザで動作を確認する

OpenCodeとは別のターミナルを開き、作業ディレクトリで次のコマンドを実行します。Node.jsとnpxが必要です。

npx http-server . -a 127.0.0.1 -p 8080 -c-1

初回にパッケージの取得を確認されたら、内容を確認して進めます。起動後は、ブラウザで http://127.0.0.1:8080 を開きます。

ここで使っている http-server は、静的ファイルを配信するためのプレビューツールです。-c-1 はキャッシュを無効にする指定で、修正後の表示を確認しやすくします。終了するときは、サーバーを起動したターミナルで Ctrl+C を押します。http-server公式README

画面が表示されたら、次の項目を確認します。

追加・完了・削除がそれぞれ動いていても、絞り込み中だけ別のタスクを操作してしまうことがあります。基本操作を確かめた後は、「完了だけを表示した状態で削除する」のように、機能を組み合わせて確認してください。

実際に「資料を読む」と「メールを返す」を追加し、後者だけを完了にしました。「完了」では「メールを返す」だけが表示されます。

その状態で削除してから「すべて」に戻すと、「資料を読む」だけが残りました。今回の生成コードでは、絞り込み中も正しい対象を削除できています。

375px幅では入力欄と追加ボタンが縦に並び、長い本文は折り返されました。320px幅でも横へのはみ出しはありませんでした。

保存に失敗したときも、画面を操作できるか

保存処理については、通常の操作だけでは確認しにくいエラーも試しました。アプリ本体を変更せずに読み込む検証用ページを別のポートで用意し、破損JSONや保存時の例外を意図的に発生させています。

破損JSONを読み込ませると、「保存データを読み込めませんでした。空の状態で開始します。」と表示されました。その後に新しいタスクを追加すると、画面を継続して操作できました。

保存時に QuotaExceededError を発生させた場合も、画面上のタスクは表示され、保存できなかったことがメッセージで伝えられました。この状態では保存成功を確認できていないため、再読み込み後も残るとは扱いません。

不具合は、再現手順と期待結果をセットで伝える

問題が見つかった場合は、OpenCodeに修正を依頼します。今回の検証では、以下の削除不具合は再現しませんでした。次の文章は、同様の問題が起きた場合の報告例です。

完了済みタスクの削除で、違うタスクが消える問題があります。

再現手順：
1. 「資料を読む」を追加する
2. 「メールを返す」を追加する
3. 「メールを返す」だけを完了にする
4. 表示を「完了」に切り替える
5. 表示されている「メールを返す」を削除する

期待する結果：
「メールを返す」だけが削除される。

実際の結果：
「資料を読む」が削除される。

原因を調査し、この問題に関係する範囲を修正してください。
修正後は、全件表示と絞り込み表示の両方で、
削除対象を正しく特定できるか確認してください。

この情報があれば、モデルは画面の状態を再現しながらコードを調べられます。エラーメッセージが出ている場合は、それも添えます。

一度に複数の不具合が見つかったときも、再現手順を分けて伝えます。修正後は、問題が出た操作に加えて、関連する基本操作ももう一度確認します。

機能追加は、最初の要件が動いてから

タスク管理アプリには、期限、優先度、検索、並び替えなど、足したくなる機能がいくつもあります。最初の5機能が動いたら、そのうち1つを選んで追加してみます。

ここからは発展課題です。検索機能の追加は、今回の25項目の検証には含めていません。

たとえば、検索機能なら次のように依頼できます。

タスク本文を検索する機能を追加したいです。
まず、現在のコードを確認して変更計画を説明してください。

要件：
- 入力した文字列を含むタスクを表示する
- 完了・未完了の絞り込みと併用できる
- 検索欄を空にすると、検索条件を解除する
- 保存済みのタスクデータの形式は変えない

変更が必要なファイルと、追加後の確認項目を示してください。

ここでもPlanで影響を確認し、Buildで実装する流れを使えます。新しい機能を加えるたびに、既存の追加・完了・削除・保存が引き続き動くかを確認します。

同じプロジェクトのままモデルを切り替える

今回の作業を通じて、OpenCodeが扱うプロジェクトと、その中で作業するモデルの関係も見えてきます。ファイルは作業ディレクトリに残り、使用モデルは /models から選び直せます。モデル選択の公式仕様

後から別のモデルを使う場合に備えて、READMEには仕様と起動方法、確認済みの項目、残っている課題を残しておくと便利です。モデルが変わっても、プロジェクトの前提をファイルから読み取れるようになります。

無料枠で基本の流れをつかみ、その後、同じ課題を別のモデルに依頼してみるのも1つの使い方です。その際は、最初の出力だけでなく、要件を満たすまでに必要だった修正や確認も含めて比べると、作業との相性を判断しやすくなります。

次は、自分の作業に必要な小さなツールへ

タスク管理アプリで流れをつかめたら、CSVの列を整えるツールや、文字数を数えるツールなど、自分が繰り返し行っている作業に置き換えてみてください。

最初に決めるのは、入力するもの、処理すること、出力してほしいものです。そこからPlanで構成を考え、Buildで実装し、実際のデータで確かめます。

前回の記事で紹介したPlanとBuildは、この往復のために使えます。DeepSeek V4.1 Flash Freeを選んだら、まずは動作を自分で確かめられる規模のツールから始めてみてください。

参考リンク

• 前編：OpenCode 2とは？モデルを選べるAIコーディングエージェントを解説
• OpenCode公式Xアカウント
• OpenCode Console：モデル一覧・料金・無料提供条件
• OpenCode 2：プロバイダー接続
• OpenCode 2：モデル選択・設定
• OpenCode 2：エージェント
• http-server公式README