主题
常见问题 (FAQ)
安装 / 下载
Windows 打开安装包提示「Windows 已保护你的电脑」怎么办？
DevAgent 目前尚未采购 Windows Authenticode 代码签名证书，会触发 SmartScreen 警告。点击「更多信息」→「仍要运行」即可正常安装，不影响后续使用与自动更新。
macOS 提示「无法验证开发者」/「已损坏，无法打开」怎么办？
未采购 Apple Developer ID 证书导致的 Gatekeeper 隔离。两种解决方式任选：
- 右键 → 打开：找到 DevAgent.app，按住 Control 点击 → 打开 → 在弹窗里再点「打开」
- 终端命令：
xattr -cr /Applications/DevAgent.app
下载速度慢怎么办？
我们已经把国内下载切换到**阿里云 OSS 华北 2（北京）**镜像，正常在国内应该很快。如果依然慢：
- 确认你走的是下载页上的链接（
cloudrouter-release.oss-cn-beijing.aliyuncs.com域名） - 尝试关掉代理 / VPN 再试（阿里云 OSS 国内直连最快）
装完后启动崩溃 / 打不开
- Linux：检查 glibc 版本是否 ≥ 2.31（
ldd --version），Ubuntu 20.04 及以上。 - Windows：确认是 Win10 x64 以上。
- macOS：确认是 macOS 11 Big Sur 及以上。
- 收集控制台日志（帮助菜单 → 开发者工具）反馈给我们。
自动更新
我怎么知道有没有新版本？
DevAgent 每次启动会自动检查一次，检测到新版会弹窗提示。Windows / Linux 会自动下载并原地升级；macOS 会跳转到下载页手动下载新 DMG。
装的是老版本（v1.1.4 及之前），能收到新版更新吗？
能。老版本还是从 Cloudflare R2（国际线）拉更新，可能稍慢但一定能成。装到 v1.1.5 之后所有版本都会自动切换到阿里云国内镜像，速度会明显变快。
我不想自动更新，可以关掉吗？
设置 → 通用 → 自动更新，取消勾选即可。
账号 / 密钥
必须登录才能用吗？
Core / Core Pro 内置智能体需要登录（消耗的是你邮箱账号里的积分）。
如果你有自己的 API 密钥，可以走 BYOK 自定义密钥，完全跳过登录。
密钥是明文保存的吗？
不是。所有密钥通过操作系统级加密（macOS Keychain / Windows Credential Manager / Linux Secret Service）保存，DevAgent 进程重启也需要解密才能读取，其他程序拿不到。
支持 Claude Code 吗？
支持。优先级：
- 本地已配置 Claude（
~/.claude/.credentials.json或settings.json或 keychain）→ 走你本地配置 - 本地无配置 + BYOK 已勾选 → DevAgent 兜底注入自定义密钥
- 本地无配置 + BYOK 未勾选 → Claude Code 无法启动，报错提示配置
SSH / 远程
SSH 主机上没装 Node.js，能用吗？
DevAgent 会在首次连接时自动检测并提示安装缺失的依赖（Node.js / Git / 编译工具链）。如果主机自动装不了（离线环境），需要你手动装一次。
SSH 会话里的智能体走的是我本地的密钥还是远程主机的密钥？
远程主机的。DevAgent 会在远程主机上跑一个 agent 进程，该进程读取远程主机自身的环境变量 / 配置文件。BYOK 密钥在 SSH 场景下不会注入到远程环境（避免密钥泄露给远程主机）。
项目 / 工作区
项目和工作区什么关系？
一个「项目」 = 一个代码仓库。一个项目下可以开多个「工作区」 —— 每个工作区是一个独立的 Git worktree，本质是同一个仓库的不同分支/目录快照，互不干扰。
好处：你可以同时让智能体 A 在 feat/xxx 分支实现新功能，智能体 B 在 fix/yyy 分支修 bug，两边的文件改动 / 依赖安装完全隔离。
删除项目会删掉我的代码吗？
不会。删除项目只是把 DevAgent 里的引用清掉，磁盘上的 git 仓库和工作区文件都还在。
没找到你的问题？
- 访问 https://ccm.clouditera.com 联系我们
- 提 issue：GitHub Issues