DeepSeek-TUI 接入

CodeWhale（原 DeepSeek-TUI）接入 QCode.cc：Claude 走 anthropic，GPT 与国产模型走 OpenAI 兼容 provider。

需要 API Key？ 前往注册 →·端点与 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 现 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（亚洲节点，韩国 / 台湾 / 香港就近），从大陆访问更近
• 完全开源：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 - 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 核对到一处变化：官方安装页现在写明，两步式（先 brew tap Hmbown/deepseek-tui 再 brew install codewhale）在 Homebrew 7.x 上会失败；请用上面的完整名，或先执行 brew trust hmbown/deepseek-tui。本页 2026-09-18 版本写的是两步式。

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

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（亚洲节点，韩国 / 台湾 / 香港就近）即可，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 这个旗标也仍然可用。

v0.10.1–v0.10.2 与上面配置有关的变化（2026-10-26）¶

二进制名（codewhale）与配置路径（~/.codewhale/config.toml）在 2026-10-26 核对的官方安装与配置文档里没有变。v0.10.0 之后有两处与配置相关：

• v0.10.1：顶层键的含义统一了。官方原句是「A top-level base_url or api_key in config.toml now means one thing everywhere.」旧文件继续可用：这些键会按 [providers.deepseek]（或按其官方主机名对应的厂商）读取，下一次保存时迁移过去，并留一次备份与一行提示；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 仍然可用。

三、配置 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 与路径
• 模型选择指南 — 什么任务该用哪个模型
• DeepSeek Harness（dsh） —— 带自定义模型 API 表单的 agent harness

企业团队版 →