登录 Codewhale

哪些用法不需要账户

现在不登录任何账户也可以使用 Codewhale。下面这些入口都在你的机器上运行，使用你自己的提供商密钥或本地模型：

• 终端：在项目文件夹里运行 codewhale。
• 本地浏览器客户端：运行 codewhale web，在同一台机器的浏览器标签页中使用。详见打开浏览器客户端。
• 桌面应用中的本地工作。桌面应用目前是开发版本，还没有公开下载。

提供商密钥和 Codewhale 账户是两回事。要连接模型，请看连接模型提供商。

在网页登录

打开 app.codewhale.net/login，选择登录方式：使用 GitHub 继续、使用 Google 继续，或使用邮箱继续。选择邮箱时，Codewhale 会根据登录的设置向你的地址发送验证码或链接，按提示完成即可。该页面需要 JavaScript。

注意： app.codewhale.net 上的托管浏览器应用尚未开放。它的登录页是可用的，你在桌面应用或终端发起登录后，就是在这个页面批准。

从桌面应用登录

注意： 桌面应用是开发版本，目前没有公开下载。下面的步骤描述的是它今天的状态。

1. 在应用中点击登录。它出现在设置的账户页，也出现在需要账户的功能旁边。
2. 浏览器会打开 Codewhale 的批准页面。
3. 阅读标题为“登录 Codewhale 应用？”的页面。它会列出应用、设备和账户。
4. 只有在你刚刚从应用里发起了登录时才继续，然后点击“登录应用”。如果不是你发起的，请点击取消。
5. 页面提示已登录后，回到应用即可。

批准页面在 10 分钟后失效，而应用本身大约等待 2 分钟后就会提示登录超时。无论哪种情况，你都需要从应用重新开始。无论成功与否，你的文件夹、对话和模型密钥都保留在你的电脑上。

从终端登录

在任意终端运行登录命令：

codewhale login

1. 终端会打印形如 XXXX-XXXX-XXXX 的一次性验证码和一个链接，并在浏览器中打开该链接。加上 --no-open 则只打印、不打开。
2. 在批准页面上，确认页面显示的验证码与终端中的一致，然后批准。
3. 终端打印“Signed in to Codewhale.”

该命令默认等待 10 分钟，可用 --timeout-seconds 调整。另有两个命令用来管理你当前配置档的会话：

codewhale account status

显示这个配置档登录的是哪个账户，或说明尚未登录。

codewhale account logout

移除这个配置档的账户会话。

codewhale login 也可以写成 codewhale account login。它不接受提供商密钥；密钥请用 codewhale auth set。

在没有浏览器的机器上使用

在服务器或 CI 中无法用浏览器批准登录。请改用账户 API 密钥：把 CODEWHALE_API_KEY 设为以 cwc_key_ 开头的密钥。你可以在已登录的终端里用 codewhale account api-keys create --name <name> 创建它。

设置了 CODEWHALE_API_KEY 时，作用于整个账户的命令（例如云端项目和智能体）会要求你先取消设置，再运行 codewhale login。

在手机上登录

手机应用尚未公开，所以目前在手机上没有可登录的地方。

退出登录

每个入口只结束它自己的会话，所以在一处退出不会让你在其他地方退出。

桌面应用

在设置的账户页点击退出登录，或点击侧边栏底部你的名字并选择退出登录。

终端

运行 codewhale account logout。

网页

在已登录页面点击使用其他账户。

注意： codewhale logout 的作用不同：它会移除所有已保存的提供商密钥和登录，并会先请你确认。只想结束账户会话时，请用 codewhale account logout。

导出数据或删除账户

目前有两个途径。在桌面应用中打开设置、账户、数据与隐私：点击导出我的数据可保存一份副本，点击安排账户删除即可开始删除。30 天后 Codewhale 可以永久删除账户，在删除开始前你可以取消。你电脑上的文件会保留。

你也可以在任何入口发邮件到 help@codewhale.net，请求导出或删除。

完整的应用指南

桌面应用的分步指南，包括登录时界面显示的所有内容，见 docs.codewhale.net。

已在源码中，尚未发布

本节描述仅存在于项目源码、尚未包含在已发布版本中的行为。可用 codewhale --version 查看你使用的版本。

下一步