DeepSeek-TUI 設定

DeepSeek-TUI は CodeWhale に改名。QCode.cc へ接続：Claude は anthropic、GPT と中国系モデルは OpenAI 互換。

API キーが必要ですか？ 登録する →·エンドポイントと Base URL →

最終確認：2026-10-26 · 📄 公式ドキュメント準拠（CodeWhale v0.10.2、2026-10-24 公開（旧 DeepSeek-TUI）。本ページは 2026-09-18 時点で v0.9.13（2026-09-14 公開）を確認していました）

概要¶

⚠️ プロジェクトは改名されました。 DeepSeek-TUI は現在 CodeWhale です。 バイナリは deepseek から codewhale に、設定ファイルは ~/.deepseek/config.toml から ~/.codewhale/config.toml に移行しました。ただし旧ディレクトリへのフォールバックには条件があります。 公式の移行契約は read-with-fallback, write-to-new —— 読み取りは ~/.codewhale/ を先に見て、 旧ディレクトリしかない場合のみ ~/.deepseek/ に退避します。保存先は常に新しいディレクトリです。 さらに v0.9.0 以降、旧コマンド deepseek と deepseek-tui は削除され、入口は codewhale、codew（簡易エイリアス）、codewhale-tui のみです。 旧サイト deepseek-tui.com は codewhale.net へ 301 リダイレクトします。 本ページの URL は変更ありません。

CodeWhale は数十個の一級 provider を内蔵したターミナル AI コーディングエージェントです（anthropic、openai、deepseek、ollama、vllm、openrouter など。 公式文書は真源としてソース内の ProviderKind::ALL を挙げており、内容はバージョンにより増減します。 お手元のビルドで実際に選べる一覧は /provider パネルで確認できます）。 Anthropic ネイティブ Messages プロトコルとOpenAI Chat Completions 互換プロトコルの 両方に対応し、どちらも QCode.cc を指定できます。

🔴 最初にこれ：Claude は anthropic provider が必須¶

QCode の OpenAI 互換エンドポイントは Claude モデルを受け付けません。claude-… を [providers.openai] に書くと model_not_available_on_endpoint が返ります。対応表は エンドポイントと API パス を参照。

CodeWhale を QCode で使う理由¶

• 使い慣れた TUI：Plan / Work / Operate の 3 モードに、Ask / Auto-Review / Full Access の権限段階（Shift+Tab で切替）を組み合わせ。MCP / Shell / Git / サブエージェントも内蔵
• API キーは 1 本：Claude Code、Codex CLI と QCode プランのクォータを共有
• provider 切り替え：同一ツール内で anthropic / openai / ollama / vllm を随時切替
• 中国本土から快適：asia.qcode.cc（アジアノード、韓国 / 台湾 / 香港付近）が最寄りの接続先です
• 完全オープンソース：MIT ライセンス、設定ファイルは監査可能

1. インストール¶

公式が最初に勧めるのは GitHub Releases のインストールスクリプトで、npm と Cargo は文書で secondary（補助）のパッケージング手段と明記されています：

# Officially recommended (macOS / Linux): installs the release binary
curl -fsSL https://codewhale.net/install.sh | sh

# npm - the official docs call this a secondary packaging route (Node 18+)
npm install -g codewhale

# Homebrew - full name taps and trusts in one step (the two-step form fails on Homebrew 7.x)
brew install Hmbown/deepseek-tui/codewhale

# Cargo - source build; the crate is codewhale-cli, the command it installs is codewhale
cargo install codewhale-cli --locked

プラットフォーム別の制約など詳細は 公式インストール文書 を優先してください。

2026-10-26 に確認した変更：公式インストールページには、2 段階の方法（brew tap Hmbown/deepseek-tui の後に brew install codewhale）が Homebrew 7.x で失敗すると書かれています。上記の完全名を使うか、先に brew trust hmbown/deepseek-tui を実行してください。本ページの 2026-09-18 版は 2 段階の方法を記載していました。

確認（文書中のバージョン数字ではなく、実際の出力を信頼してください）：

codewhale --version

2. Claude の設定（anthropic provider）¶

~/.codewhale/config.toml を編集します：

# ~/.codewhale/config.toml

provider = "anthropic"

[providers.anthropic]
api_key  = "cr_あなたのQCodeキー"
base_url = "https://api.qcode.cc/api"
model    = "claude-sonnet-5"

中国本土からはホストを https://asia.qcode.cc/api（アジアノード、韓国 / 台湾 / 香港付近）に変えるだけです。キーは共通。

設定ファイルの代わりに環境変数でも指定できます。公式は現在、汎用の CODEWHALE_* 群を優先的に勧めています：

export CODEWHALE_PROVIDER="anthropic"
export CODEWHALE_BASE_URL="https://api.qcode.cc/api"
export CODEWHALE_MODEL="claude-sonnet-5"
export ANTHROPIC_API_KEY="cr_あなたのQCodeキー"

codewhale

provider 専用の変数（ANTHROPIC_BASE_URL / ANTHROPIC_MODEL）も引き続き認識され、 codewhale --provider anthropic のフラグも有効です。

v0.10.1–v0.10.2 で上記の設定に関係する変更（2026-10-26）¶

バイナリ名（codewhale）と設定パス（~/.codewhale/config.toml）は、2026-10-26 に確認した公式のインストール・設定ドキュメントで変わっていません。v0.10.0 以降で設定に関係する変更は 2 つあります。

• v0.10.1：トップレベルキーの意味が統一されました。公式の原句は「A top-level base_url or api_key in config.toml now means one thing everywhere.」です。旧ファイルも引き続き使え、これらのキーは [providers.deepseek]（または公式ホスト名に対応するベンダー）として読まれ、次回保存時に一度だけバックアップと 1 行の案内とともに移行されます。codewhale config doctor で実際に使われている内容を確認できます（公式リリースノート）。上記の設定では api_key と base_url を [providers.anthropic] / [providers.openai] の中に書くため影響ありません。
• v0.10.2（2026-10-24）：公式インストールコマンドでバージョンを固定できます：curl -fsSL https://codewhale.net/install.sh | CODEWHALE_VERSION="v0.10.2" sh（公式リリースノート）。インストールページのバージョン指定なしの curl -fsSL https://codewhale.net/install.sh | sh も引き続き使えます。

3. GPT と中国系モデルの設定（openai provider）¶

1 つの設定ファイルに複数の provider を併存でき、codewhale --provider <id> で切り替えます：

[providers.openai]
api_key  = "cr_あなたのQCodeキー"
base_url = "https://api.qcode.cc/openai/v1"
model    = "gpt-6-sol"

base_url は /openai/v1 までとしてください。CodeWhale が /chat/completions を連結します。 サフィックスを変える必要がある場合、公式が用意するキーは [providers.openai] 内の path_suffix です。 base_url に混ぜて書かないでください。

中国系 4 ファミリー（glm-5.2 / kimi-k3 / deepseek-v4-pro / qwen3.8-max など）は 両方の経路で動くため、どちらの provider に書いても構いません。id は 中国系モデル連携 を参照。

4. 利用可能なモデル¶

claude-sonnet-4-6、claude-opus-4-8 などの 4.x も引き続き販売中です。完全な一覧と リアルタイム単価は qcode.cc/models を参照。

現在呼べるモデルの確認（2 つの経路で一覧が異なります）：

# Claude と中国系モデル（Anthropic 経路）
curl https://api.qcode.cc/v1/models -H "Authorization: Bearer cr_あなたのQCodeキー"

# GPT 系（OpenAI 経路）
curl https://api.qcode.cc/openai/v1/models -H "Authorization: Bearer cr_あなたのQCodeキー"

5. 疎通確認¶

KEY="cr_あなたのQCodeキー"

# Claude（Anthropic プロトコル）—— content を含む JSON が返れば OK
curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

# GPT（OpenAI プロトコル）—— choices を含む JSON が返れば OK
curl -X POST https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6-sol","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

確認できたら起動します：

codewhale

6. トラブルシューティング¶

関連ドキュメント¶

• エンドポイントと API パス — プロトコル × モデルファミリー対応表
• 中国系モデル連携 — GLM / Kimi / DeepSeek / Qwen の id とパス
• モデル選択ガイド — どのタスクにどのモデルか
• DeepSeek Harness（dsh） — カスタムモデル API のフォームを持つ agent harness

企業版 →