连接模型提供商

保存提供商密钥

先在提供商那里申请 API 密钥，然后保存。Codewhale 会提示你输入密钥，输入内容不会回显。DeepSeek 是默认提供商，下面以它为例。

codewhale auth set --provider deepseek
codewhale auth status --provider deepseek

auth status 会说明当前密钥来自哪里——配置文件、密钥存储还是环境变量——并且只显示最后四位。在脚本里可以用 --api-key-stdin 通过管道传入密钥，不必手动输入。

也可以在 Codewhale 里连接：按 F3（或输入 /provider），选择提供商，粘贴密钥，再选一个模型。

注意： 在 v0.10.0 中，auth set --provider deepseek 还会把默认模型切换为 DeepSeek Pro。想换回更快、更便宜的模型，运行 /model 即可。通过 F3 连接则会保留你当前的模型。

弄清用的是哪把密钥

同一个提供商的密钥如果设在多处，按下面的顺序取第一个找到的：

1. 命令行上的 --api-key，只对这一次运行生效。
2. ~/.codewhale/config.toml 中的 api_key。
3. codewhale auth set 写入的密钥存储。
4. 提供商自己的环境变量，例如 DEEPSEEK_API_KEY。

因此，导出一个新的环境变量并不会替换你之前保存的密钥。如果换过的密钥一直报错，先用 auth status 看看生效的是哪个来源，再保存新密钥，或清除已存的旧密钥：

codewhale auth clear --provider deepseek

在 Linux 上，密钥存储是 ~/.codewhale/secrets/ 下的一个私有文件（权限 0600），而不是系统钥匙串。codewhale doctor --probe-api 会发起一次测试调用，确认密钥和网络都正常。

使用其他提供商或本地模型

codewhale auth list 会列出 Codewhale 支持的所有提供商，以及每个提供商是否已有密钥。所有提供商的用法都一样：codewhale auth set --provider <name>，或者设置该提供商的环境变量。

本地运行器——Ollama、vLLM 和 SGLang——默认不需要密钥，你的提示词也不会离开本机。先启动运行器，再选择它：

codewhale auth list
codewhale --provider ollama --model <model-tag>

模型页面 列出了各家提供商、本地部署方式，以及如何在会话中切换模型。

登录 Codewhale 账户（可选）

提供商密钥和 Codewhale 账户是两回事。账户只用于账户相关的功能，比如云端智能体、在网页应用里接着使用某个会话。安装 Codewhale 和在本地工作都不需要账户。

codewhale login

在浏览器中用一次性验证码登录。

codewhale account status

查看当前配置档登录的是哪个账户。

codewhale account logout

移除当前配置档的登录会话。

codewhale account keys list

列出保存在账户里的提供商密钥，永远不会显示密钥内容。

codewhale login 不接收提供商密钥，提供商密钥一律通过 codewhale auth set 保存。登录会话优先保存在操作系统的凭据管理器中；没有凭据管理器时（例如通过 SSH 或在容器里），则保存在 Codewhale 的私有密钥文件中。

下一步