首页/配置/Provider 设置
Provider 设置

provider 设置是 CodeWhale 从“磁盘上的命令”变成“真正可工作的代理”的关键一步

安装完成以后,provider 设置才是真正的激活步骤。重点不只是填凭据,而是让选中的后端、认证值、模型预期和配置路径都属于同一条路线。

本页是站内详情页CodeWhale 的 Provider 设置(DeepSeek TUI 指南)配置

这页能直接回答的问题

  • 当前配置里,到底是哪条 provider 路线处于激活状态?
  • 认证、模型默认值和运行时预期怎样才算真正对齐?
  • 哪些失败应该把你送回 API Key、环境变量或配置文件位置页?

做完后该核对什么

  • 确认配置里写的 provider 和你提供的 key/token 属于同一路后端。
  • 检查是不是旧环境变量在静默覆盖你想用的 provider 配置块。
  • 如果认证是通的但行为仍然不对,下一步再查模型默认值和模式假设。

最常见的误区

  • 配置文件里是一个 provider,环境变量里又留着另一个 provider。
  • 最简单请求还没稳定,就先上复杂工作流。
  • 一次性改太多 provider 相关默认值,失去干净基线。

推荐阅读顺序

先按当前问题走,再决定要不要切去相邻详情页或 hub。

步骤 1

显式选定 provider

不要让 provider 保持隐式假设,第一步就明确当前后端是谁。

步骤 2

让认证和配置来源保持一条线

确保凭据来源和 provider 配置块描述的是同一个后端,而不是两条路线混杂。

步骤 3

用最小请求先验证

先把最简单的一次 provider 请求跑通,再去调模型、模式和 MCP。

直接可用的示例

先拿可执行例子,再回头做更细的调整。

先锁 provider,再测最小请求

不要一上来同时配认证、模型默认值和高级功能。先把 provider 路线锁定,再验证最小请求。

codewhale --version
# 在认证完成后再开最小会话验证

先只保留一套真相来源

让 provider 选择、凭据来源和模型预期先在一轮里对齐,再去加 MCP 或更多运行时行为。

export DEEPSEEK_API_KEY="your-key-here"
# 保证环境变量和配置文件指向同一 provider

先证明认证层是通的,再去调模型

真正值钱的是先让 provider 路线跑通,而不是一开始就改模型默认值。

echo "$DEEPSEEK_API_KEY"
# 确认当前 provider 配置块
# 先跑一次最小请求,再动模型默认值

常见失败分支

先判断你卡在哪一层,再去对应分支,不要把所有问题都混成一个。

Provider 选对了,但认证还是失败

通常是 provider 名字和凭据来源没对齐。先查 API Key 设置和环境变量覆盖。

认证已经通过,但返回行为不对

这更像模型默认值或模式预期的问题,不再是凭据问题。下一步去看 config 和 modes。

你同时在改 provider、环境变量和模型默认值

先停下来拆层。先把 provider 和认证层锁定,否则你根本不知道是哪一项让会话变好或变坏。

什么时候该离开这页

当你已经确认当前路线没问题,就不要继续停留在这页。安装线应转去配置,配置线应转去 provider 或排错,MCP 和模式线则应该转回真实工作流页。详情页的价值是把问题缩窄,而不是长期停留在解释层。