CodeWhale（原 DeepSeek-TUI）集成

把 CodeWhale 接到 QCode.cc：Claude 走 anthropic provider，GPT 与国产模型走 OpenAI 兼容 provider

最后核实：2026-09-18 · 📄 依据官方文档（CodeWhale v0.9.13，2026-09-14 发布（原 DeepSeek-TUI））

接入速览¶

⚠️ 项目已改名：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 现 301 跳转到 codewhale.net。本页 URL 保持不变。

CodeWhale 是一款命令行 AI 编程 Agent，内置数十个一等公民 provider （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 三种模式，配合 Ask / Auto-Review / Full Access 三档权限（Shift+Tab 切换）；内置 MCP / Shell / Git / 子代理
• 同一份 API Key：与 Claude Code、Codex CLI 共享 QCode 套餐配额
• 多 provider 切换：同一个工具里在 anthropic / openai / ollama / vllm 之间随时切
• 中国大陆友好：asia.qcode.cc（亚洲节点，HK/JP 就近），从大陆访问延迟最低
• 完全开源：MIT 协议，配置文件可审计

一、安装¶

官方首推的是 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 - add the tap first, otherwise a fresh machine cannot find the formula
brew tap Hmbown/deepseek-tui
brew install codewhale

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

细节与平台限制以 官方安装文档 为准。

验证安装（不要对照文档里的版本数字，以实际输出为准）：

codewhale --version

二、配置 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 就近）即可，Key 不变。

也可以用环境变量替代配置文件。官方现在优先推荐一组通用的 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 这个旗标也仍然可用。

三、配置 GPT 与国产模型（openai provider）¶

同一个配置文件里可以并存多个 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。若你的版本要改这个后缀， 官方给的键是 path_suffix（写在 [providers.openai] 里），不要靠拼进 base_url 绕。

国产四家族（glm-5.2 / kimi-k3 / deepseek-v4-pro / qwen3.8-max 等） 两条腿都能走，填在哪个 provider 里都可以，id 见 国产模型接入。

四、可用模型¶

claude-sonnet-4-6、claude-opus-4-8 等 4.x 仍在售。完整清单与实时单价以 qcode.cc/models 为准。

查询当前可调模型（注意两条腿的列表不一样）：

# 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密钥"

五、验证连通¶

KEY="cr_你的QCode密钥"

# Claude（Anthropic 协议）—— 应返回含 content 的 JSON
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
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

六、排错¶

相关文档¶

• 接入点与 API 格式 — 协议 × 模型家族真源表
• 国产模型接入 — GLM / Kimi / DeepSeek / Qwen 的 id 与路径
• 模型选择指南 — 什么任务该用哪个模型