CodeWhale（旧 DeepSeek-TUI）連携

CodeWhale を QCode.cc に接続する：Claude は anthropic provider、GPT と中国系モデルは OpenAI 互換 provider

⚠️ プロジェクトは改名されました。 DeepSeek-TUI は現在 CodeWhale です。 バイナリは deepseek から codewhale に、設定ファイルは ~/.deepseek/config.toml から ~/.codewhale/config.toml に移行しました（旧パスも互換のため引き続き読まれます）。 旧サイト deepseek-tui.com は codewhale.net へ 301 リダイレクトします。 本ページの URL は変更ありません。

CodeWhale は 42 の一級 provider を内蔵したターミナル AI コーディング エージェントです。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 / Agent / YOLO の 3 モード + MCP / Shell / Git / サブエージェント内蔵
• API キーは 1 本：Claude Code、Codex CLI と QCode プランのクォータを共有
• provider 切り替え：同一ツール内で anthropic / openai / ollama / vllm を随時切替
• 中国本土から快適：asia.qcode.cc（アジアノード、HK/JP の近い方）が最も低遅延
• 完全オープンソース：MIT ライセンス、設定ファイルは監査可能

1. インストール¶

いずれかを選択（公式インストール文書 を優先）：

# npm（推奨。プラットフォーム用バイナリを自動取得）
npm install -g codewhale

# Homebrew（macOS）
brew install codewhale

# Cargo（ソースからビルド）
cargo install codewhale --locked

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

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（アジアノード、HK/JP の近い方）に変えるだけです。キーは共通。

環境変数でも設定できます：

export ANTHROPIC_API_KEY="cr_あなたのQCodeキー"
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_MODEL="claude-sonnet-5"

codewhale --provider anthropic

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-5.5"

base_url は /openai/v1 まで。CodeWhale が /chat/completions を連結します。 末尾スラッシュがあると //chat/completions になり 404 です。

中国系 4 ファミリー（glm-5.2 / kimi-k3 / deepseek-v4-pro / qwen3.7-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-5.5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

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

codewhale

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

関連ドキュメント¶

• エンドポイントと API パス — プロトコル × モデルファミリー対応表
• 中国系モデル連携 — GLM / Kimi / DeepSeek / Qwen の id とパス
• モデル選択ガイド — どのタスクにどのモデルか