DeepSeek-TUIが選ばれる理由｜Claude Code・Codex CLIとの選定軸

ターミナルから AI コーディングエージェントを動かす選択肢が急速に増え、初見のエンジニアにとって「どれを採用すべきか」という意思決定は年々難しくなっています。Claude Code、OpenAI の Codex CLI、Aider など、有力な選択肢はいずれも個性が強く、横並びの機能比較だけでは選定軸が定まりません。

そこに 2026 年 1 月に登場したのが、Hmbown/DeepSeek-TUI です。DeepSeek V4 モデルを前提とした Rust 製のターミナル型コーディングエージェントで、リリースから数ヶ月で 30,000 スター超を獲得しています（GitHub リポジトリ、2026 年 5 月時点）。

本記事では、DeepSeek-TUI のコアコンセプト・機能・アーキテクチャ・導入方法を整理した上で、Claude Code・Codex CLI・Aider との違いを 7 観点で比較します。情報の羅列ではなく、初見のエンジニアが採用判断を下すための「選定軸」として読めるように構成しました。なお、本記事は README と公式ドキュメントに基づくドキュメントベースの解説であり、動作検証や個人的な使用感は扱いません。

DeepSeek-TUI とは

公式説明とリポジトリの位置付け

DeepSeek-TUI（Hmbown/DeepSeek-TUI）は、GitHub の公式 description で次のように説明されています。

Coding agent for DeepSeek models that runs in your terminal

（出典: Hmbown/DeepSeek-TUI）

ターミナル上で動作するコーディングエージェントであり、DeepSeek 社が提供する LLM「DeepSeek V4」ファミリーを操作対象とします。リポジトリは主に Rust で実装されており、ライセンスは MIT です。リポジトリ統計（2026 年 5 月時点）は次の通りです。

リリースは 2026 年 1 月 19 日で、その後わずか数ヶ月で 30,000 スターを超えた急成長プロジェクトです。公式サイトは deepseek-tui.com で公開されています。

DeepSeek Inc. との関係

公式に強調されている点として、本プロジェクトは DeepSeek Inc. の公式プロダクトではないことが README に明記されています。"This project is not affiliated with DeepSeek Inc." と記載されており、コミュニティが DeepSeek V4 モデルを快適に扱うために構築したサードパーティ製の OSS という位置付けです。採用検討の前提として、まずこの帰属関係を押さえておくことが重要です。

DeepSeek-TUI が解決する課題

DeepSeek V4 のコスト・コンテキスト特性を活かしたい開発者像

DeepSeek-TUI が前提とする DeepSeek V4 ファミリーには deepseek-v4-pro と deepseek-v4-flash の 2 種類があり、いずれも 1M トークンのコンテキストウィンドウに対応します。README の料金表は次の通りです（原文ママ）。

（出典: Hmbown/DeepSeek-TUI README。*Pro 料金は 2026 年 5 月 31 日 15:59 UTC まで 75% 割引が適用される旨が README に明記されています。）

1M コンテキストと比較的低コストな従量課金を組み合わせることで、長大なリポジトリ全体を文脈として渡しながら反復編集するワークフローが現実的になります。DeepSeek-TUI は、この特性をターミナル UI から最大限引き出すためのフロントエンドとして設計されています。

ターミナル完結で動かしたいユースケース

DeepSeek-TUI が想定する典型的なユースケースは、次のようなターミナル完結型の運用です。

• ローカル開発機での対話的なコード編集・レビュー
• リモートサーバー（SSH 接続先）での運用
• CI / ヘッドレス実行での自動化（deepseek exec --auto --output-format stream-json などのスクリプト連携）
• macOS / Linux / Windows のいずれでも同じバイナリで動作させたい運用

エディタ統合型のエージェントとは異なり、TUI（テキストユーザーインタフェース）を採用することで、ssh セッション越し・コンテナ内・最小構成のサーバーでも同じ操作体系を保てるのが特徴です。

主要機能と操作モード

3 つの操作モード（Plan / Agent / YOLO）

DeepSeek-TUI には、エージェントの自律度をコントロールするための 3 つの操作モードが用意されています。

• Plan: 読み取り専用の探索モード。コードベースを読みながら計画を立てることに専念し、ファイル書き換えやシェル実行は行いません
• Agent: 対話型・承認ゲート付きの編集モード。エージェントが提案する各操作に対し、承認ダイアログで明示的に許可を与えてから実行します
• YOLO: 全ツール自動承認モード。deepseek --yolo などで起動でき、自動化前提のワークフローに使われます

これらのモードは、OS 別のサンドボックス機構と組み合わせて動作します。公式サイト（deepseek-tui.com）では、macOS では seatbelt、Linux では landlock、Windows では制限トークン（restricted tokens）によってサンドボックス化される旨が明示されています。エージェントが触れる範囲を OS レイヤーで制限することで、Agent モードや YOLO モードでもファイル・プロセスへのアクセスを安全側に倒せる設計です。

コンテキスト管理とコストモニタリング

長大なコンテキストと従量課金を組み合わせて運用するうえで、コスト可視化は欠かせません。DeepSeek-TUI は次の機能を備えています。

• 1M-token context windows: DeepSeek V4 の最大コンテキストをフル活用
• prefix-cache-aware cost reporting: プレフィックスキャッシュのヒット状況を踏まえたコスト計測
• Live cost tracking: ターン単位・セッション単位のライブコスト追跡
• Session save / resume / fork: deepseek resume --last、deepseek resume <SESSION_ID>、deepseek fork <SESSION_ID> などのコマンドで、セッションを保存・再開・分岐できます
• Workspace rollback: side-git snapshots によるワークスペース単位のロールバック

セッションの fork が標準でサポートされている点は、長時間の対話を試行錯誤するワークフローと相性が良い設計です。

ツール群と外部連携

DeepSeek-TUI は、エージェントから呼び出せるツール群と外部連携の幅広さも特徴です。README には次のツール・連携が記載されています。

• ファイル操作・シェル実行・git 管理・Web 検索 / browse・apply-patch
• サブエージェントの並列バックグラウンド実行（ドキュメント上は最大 10〜20 並列）
• MCP（Model Context Protocol）サーバー接続
• LSP 診断（rust-analyzer、pyright など）
• Agent Client Protocol（ACP）による Zed エディタ連携
• Skills system（composable instruction packs）
• ターミナルネイティブな通知
• ビルトインテーマピッカー（Catppuccin、Tokyo Night など）
• /model、/provider、/theme などのスラッシュコマンド

特に「サブエージェントの並列実行」と「OS レイヤーのサンドボックス」を併せ持つ点は、後述の比較セクションで重要な差別化要素になります。

起動コマンドと思考レベル制御

DeepSeek-TUI の典型的な起動コマンドは次の通りです（README からの抜粋・原文ママ）。

deepseek
deepseek "explain this function"
deepseek --model auto
deepseek --yolo
deepseek exec --auto --output-format stream-json

（出典: Hmbown/DeepSeek-TUI ）

引数なしで起動すると対話型 TUI に入り、文字列を渡すとワンショットのプロンプトとして処理されます。--model auto はモデルと思考レベルを自動選択するオプション、exec サブコマンドはヘッドレス実行と JSON ストリーミング出力を担います。

思考プロセスについては、Reasoning-effort のティアを off → high → max で切り替えられ、TUI 内では Shift+Tab で循環できます。reasoning ブロックがストリーミング表示される "Thinking-mode streaming" にも対応しています。

アーキテクチャと採用技術

Rust + ratatui による TUI スタック

DeepSeek-TUI は Rust で実装されており、ビルドには Rust 1.88 以上が必要です（出典: deepseek-tui.com ）。TUI レンダリングには Rust エコシステムで広く使われる ratatui を採用しており、ターミナル制御は crossterm 系のクロスプラットフォーム抽象を経由する構成です。

Rust 製であることは、起動の速さ・メモリ効率・単一バイナリ配布のしやすさといった面で、TUI 体験に直接効いてきます。Node.js や Python のランタイムを前提としないため、ssh 越しの軽量環境でも同じ挙動を保ちやすい設計です。

2 バイナリ構成と OpenAI 互換クライアント

DeepSeek-TUI は次の 2 バイナリで構成されています。

• Dispatcher CLI: deepseek
• Companion TUI binary: deepseek-tui

deepseek がエントリポイントとなり、対話型起動の場合に deepseek-tui ランタイムを呼び出す形です。内部的には OpenAI 互換のストリーミングクライアントを備え、DeepSeek 公式 API のほか、OpenRouter・NVIDIA NIM・SGLang など複数のプロバイダ経由でモデルを切り替えられる設計になっています。

ツール呼び出しは型付きのレジストリ経由で管理され、async エンジン上で動作します。

ヘッドレス・自動化向けインターフェース

TUI だけでなく、自動化用途向けのインターフェースも用意されています。

• HTTP/SSE ランタイム API: 外部プロセスからのオーケストレーションに利用可能
• deepseek exec のヘッドレス実行: --output-format stream-json 指定で、ストリーミング JSON として結果を取得できます
• Agent Client Protocol (ACP): Zed エディタなど外部クライアントから DeepSeek-TUI のエンジン部分を呼び出すためのプロトコル

CI パイプラインや、別のエージェントオーケストレーターから DeepSeek V4 を呼び出すサブエージェントとして組み込むこともドキュメント上は想定されています。

インストール・設定方法

配布形式の選択肢

DeepSeek-TUI は複数の配布チャネルで提供されています。公式が推奨するのは npm 経由のインストールです（README からの抜粋・原文ママ）。

npm install -g deepseek-tui

cargo install deepseek-tui-cli --locked
cargo install deepseek-tui --locked

brew tap Hmbown/deepseek-tui
brew install deepseek-tui

（出典: Hmbown/DeepSeek-TUI ）

npm は両バイナリ（deepseek と deepseek-tui）をまとめて配布する想定で、Node.js 環境がある場合に最も導入が容易です。Node を入れたくない場合は Cargo 経由で 2 つのバイナリをインストールできます。macOS では Homebrew tap も提供されています。

このほか、Docker（GHCR）からのコンテナ実行や、ソースからのビルドも README に記載されています。プレビルドバイナリの対応プラットフォームは次の通りです。

• Linux x64 / ARM64
• macOS x64 / ARM64
• Windows x64

それ以外のターゲット（musl、riscv64、FreeBSD など）はソースビルドが必要です。

APIキー設定と環境変数

DeepSeek-TUI を利用するには、DeepSeek プラットフォームで API キーを発行し、ローカルに設定する必要があります。APIキーの発行は DeepSeek プラットフォーム API キー管理画面 から行います。

キーの設定方法は 2 通りです（README 原文ママ）。

deepseek auth set --provider deepseek

export DEEPSEEK_API_KEY="YOUR_KEY"

（出典: Hmbown/DeepSeek-TUI ）

deepseek auth set を使うと、対話的にキーを入力して ~/.deepseek/config.toml に保存できます。CI など対話入力ができない環境では環境変数を使います。

主要な環境変数は次の通りです。

設定の階層とプロバイダ切替

設定ファイルは 2 階層に分かれています。

• ユーザー設定: ~/.deepseek/config.toml
• プロジェクト設定: <workspace>/.deepseek/config.toml

プロジェクト設定は同名キーをユーザー設定にオーバーレイできますが、セキュリティ上の理由から api_key / base_url / provider / mcp_config_path の 4 項目はプロジェクト側で上書きできない仕様です。共有リポジトリの .deepseek/config.toml に誤って API キーをコミットする事故を防ぐための制約と考えられます。

プロバイダの切替例は次の通りです。

# NVIDIA NIM
deepseek auth set --provider nvidia-nim --api-key "YOUR_NVIDIA_API_KEY"
deepseek --provider nvidia-nim

# OpenRouter
deepseek auth set --provider openrouter --api-key "YOUR_OPENROUTER_API_KEY"
deepseek --provider openrouter --model deepseek/deepseek-v4-pro

# Self-hosted SGLang
SGLANG_BASE_URL="http://localhost:30000/v1" deepseek --provider sglang --model deepseek-v4-flash

（出典: Hmbown/DeepSeek-TUI ）

DeepSeek 公式 API のほか、NVIDIA NIM や OpenRouter、自前でホストした SGLang を含め、9 種類のプロバイダ切替がドキュメント上は可能です。

最新リリースとプラットフォーム対応

リリース動向は活発で、最新版は v0.8.38（2026 年 5 月 15 日）です。直近のリリース（v0.8.34〜v0.8.38）では、サイドバー表示制御・サブエージェント完了ハンドオフのキャッシュ最適化・設定カバレッジ拡張など、TUI の UX と設定系の安定化が中心となっています。リリース履歴と配布バイナリは GitHub Releases ページ から確認できます。

類似 OSS との比較で見る選定軸

DeepSeek-TUI の採用判断で最も問われるのが、Claude Code・Codex CLI・Aider との棲み分けです。まず差分マトリクスを示し、その後に観点別の整理を行います。

差分マトリクス

出典: Hmbown/DeepSeek-TUI README ／ Codex CLI Features (OpenAI Developers) ／ Aider 公式 ／ Aider GitHub ／ DeepSeek-TUI vs Claude Code (Verdent) ／ AI Coding Agents Compared 2026 (ofox.ai)

Claude Code との違い

Claude Code は Anthropic の公式ファーストパーティ製品で、Claude モデルとの統合の深さとモデル品質の高さが強みです。一方で、ソースコードは公開されておらず、利用は Anthropic API への課金を前提とします。

DeepSeek-TUI と Claude Code を比較した場合の選定軸は次のように整理できます。

• モデル品質と成熟度を最優先するなら Claude Code: 大規模な意思決定やドメイン知識が重要なコーディング、長期運用での安定性で優位
• コスト効率とコンテキスト長を重視するなら DeepSeek-TUI: 1M コンテキストと DeepSeek V4 の従量課金を組み合わせ、長大リポジトリの反復編集を低コストで回す用途で優位
• OSS であることが要件なら DeepSeek-TUI 一択: MIT ライセンスでソースコードが公開されており、自社改修・監査・フォークが可能

Codex CLI との違い

OpenAI の Codex CLI（openai/codex）は、DeepSeek-TUI と同様に Rust 製のターミナルエージェントです。GitHub スターは 2026 年 4 月時点で 75,600 超に達しており、エンタープライズ向けの機能拡張（カスタム CA、CI sandbox、Python SDK、プラグインマーケットプレイス）が活発に進んでいます（出典: OpenAI Codex CLI Features ）。

両者は実装言語と UI の方向性が近いため、選定軸は「どのモデルを使いたいか」と「どこに機能の重心があるか」に集約されます。

• OpenAI GPT-5 系モデルを中心に運用するなら Codex CLI: 画像添付・to-do リスト・プラグインマーケットなど、OpenAI モデルを前提とした機能体系
• DeepSeek V4 を中心に運用するなら DeepSeek-TUI: 1M コンテキストとコスト効率を活かすためのチューニングと、サブエージェント・MCP・LSP・ACP を一通り内包

Aider との違い

Aider（Aider-AI/aider）は、ターミナルベース AI ペアプログラマーの先駆けとして知られる Python 製の OSS（Apache-2.0）です。リポジトリマップ生成、自動 git コミット、watch mode（コード内のマーカーを検出して自動編集・コミットする機能）といった、コードベース全体に対するスマートな振る舞いに強みがあります（出典: Aider 公式 ）。

DeepSeek-TUI と Aider の選定軸は次の通りです。

• マルチプロバイダ・成熟度・watch mode を重視するなら Aider: OpenAI、Anthropic、Google、DeepSeek、xAI、Ollama など幅広いプロバイダに対応し、運用ノウハウも豊富
• サブエージェント並列実行と OS レイヤーのサンドボックスを重視するなら DeepSeek-TUI: Aider が標準では持たないサブエージェント機構と、Plan / Agent / YOLO の 3 段階サンドボックスを備える

DeepSeek-TUI が刺さるシナリオ

ここまでの比較を踏まえると、DeepSeek-TUI を採用判断の第一候補に据えるべきシナリオは、おおむね次のいずれかに当てはまる場合と考えられます。

• DeepSeek V4 ファミリーを継続利用する前提があり、その特性（1M コンテキスト・低コスト）をターミナル UI から最大限活かしたい
• OSS（MIT）であることが採用要件に含まれており、ソースコード監査やフォークの可能性を残しておきたい
• 並列サブエージェント・MCP・LSP・ACP をひとつのバイナリにまとめたい
• macOS / Linux / Windows でサンドボックス機構（seatbelt / landlock / 制限トークン）を OS ネイティブに使い分けたい

逆に、モデル品質を最優先する場合は Claude Code、OpenAI モデル中心なら Codex CLI、マルチプロバイダで watch mode を活用したい場合は Aider が選択肢として残ります。

ライセンス・採用時の判断ポイント

MIT ライセンスの実務的な意味

DeepSeek-TUI のライセンスは MIT です。MIT は、著作権表示と免責条項を残す限り、商用利用・改変・再配布・社内フォーク・有償サービスへの組み込みなどを広く許諾するライセンスとして知られています。社内で改修を加える、独自のラッパーを被せて配布する、といった運用の自由度は高い部類に入ります。

一方で、すでに触れた通り、本プロジェクト自体は DeepSeek Inc. の公式プロダクトではなく、コミュニティ製のクライアントツールです。社内採用の意思決定では「LLM プロバイダ（DeepSeek 社）との契約・ガバナンス」と「クライアントツール（DeepSeek-TUI コミュニティ）の保守性」を分けて評価する必要があります。

既知の制限事項

README で言及されている主な制限事項は次の通りです。

• ACP 経由のツールバック編集・checkpoint replay は未実装: Zed などからの ACP 連携でも、編集系のツール呼び出しやチェックポイント再生はまだサポート外
• プロジェクトオーバーレイの制約: api_key / base_url / provider / mcp_config_path はプロジェクト設定で上書き不可
• プレビルド対象外プラットフォーム: musl、riscv64、FreeBSD などはソースビルドが必要
• 企業プロキシ環境: 独自 CA を使う場合は SSL_CERT_FILE でカスタム CA バンドルを指定
• アクセシビリティ: NO_ANIMATIONS=1 でアニメーションを無効化したアクセシビリティモードに切り替え可能

導入検討時は、社内 PC のプロキシ構成・CA 配布状況と、対象プラットフォームがプレビルドバイナリでカバーされるかを先に確認しておくと、後戻りが減ります。

コミュニティ規模と更新頻度

公式サイトでは、ガバナンスについて次の方針が示されています。

• CLA（Contributor License Agreement）を課さない
• スポンサーによるロックアウトを設けない
• "small team / your patch matters"

（出典: deepseek-tui.com ）

CLA を課さない方針は、コントリビューションのハードルを下げるメリットがある一方、コードの再ライセンスや権利移管が将来的に難しくなる側面もあるため、企業として大規模に貢献する場合は法務確認の対象に含めると安全です。

リリース頻度については、最終 push が 2026-05-15 と非常にアクティブで、直近の v0.8.34〜v0.8.38 でも UX と設定系の細かな改善が続いています。新興プロジェクトに伴う「破壊的変更や設定形式の変動が一定期間続く可能性」は念頭に置きつつ、活発な開発が続いていることは採用上のポジティブ要素と捉えられます。

まとめ

DeepSeek-TUI は、DeepSeek V4 モデルをターミナル上で扱うことに特化した Rust 製のコーディングエージェント OSS（MIT）です。1M コンテキスト・prefix-cache 対応のコスト計測・3 モード（Plan / Agent / YOLO）のサンドボックス・サブエージェント並列実行・MCP / LSP / ACP 連携を、ひとつのバイナリで揃えている点が大きな特徴になります。

採用判断の選定軸として整理すると、次の通りです。

• モデル品質と成熟度を最優先したい場合は Claude Code
• OpenAI モデルを中心に運用したい場合は Codex CLI
• マルチプロバイダと watch mode を活用したい場合は Aider
• DeepSeek V4 を前提に、ターミナル完結で OSS のコーディングエージェントを揃えたい場合は DeepSeek-TUI

DeepSeek-TUI の最新の機能・対応プロバイダ・料金体系は変更が続いている領域です。実際の採用検討に進む前に、GitHub リポジトリ と 公式サイト で README とリリースノートを確認することをおすすめします。