常见问题

我的机器显示离线

绿点的含义是"这台机器的 Agent 此刻连着服务器"。灰了就按顺序查：

1. 电脑醒着吗？ 睡着的笔记本就是离线——见开机自启。
2. Agent 在跑吗？ macOS：菜单栏图标还在吗？Linux：systemctl status code-agent（或 systemctl --user status code-agent）。Windows：看任务管理器。
3. 连得上服务器吗？ 在那台机器上：curl -sI https://你的服务器地址/。Agent 会自动退避重连——网络抖一下，一分钟内自己恢复。
4. 服务器刚重启过？所有设备会离线几秒，等 Agent 重连，正常现象。

签不出 HTTPS 证书

几乎都是 DNS 或 80 端口的问题。按 HTTPS 与域名的清单和错误表逐条排查。

登录后马上被弹出

服务器配置里 cookieSecure: true，而你在用明文 http:// 访问。改用 https:// 地址——真要无 TLS 测试，就临时把 cookieSecure 设为 false。

macOS 提示应用"无法打开"

应用没有经过公证。右键 → 打开 → 打开（一次即可），或系统设置 → 隐私与安全性 → 仍要打开。用安装脚本通常不会遇到——见安装 Agent。

额度电池看着不动或是空的

电池随会话运行更新；几个小时没活动会滞后。点一下 5h 或 week 电池强制刷新。见用量与额度。

设备列表里同一台电脑出现两条

机器的身份文件（~/.code）被重置过——重装系统、清目录、换系统用户都会导致——于是它以新设备身份重新绑定了。去设置 → 设备删掉旧条目。

我装的是系统级还是用户态？

取决于当时谁跑的安装脚本：带 sudo/root 就是系统包 + 系统服务；不带就全在 $HOME 下 + systemctl --user 服务。卸载/升级脚本会自动识别。

日志在哪

• Agent：机器上的 ~/.code/logs/，以及 journalctl --user -u code-agent（Linux 用户态）或 journalctl -u code-agent（root 安装）。
• 服务端：sudo journalctl -u code-server（容器：podman logs code-server）。

我的代码会被传到服务器吗

会话记录（你和 Claude 的对话，包括对话中出现的代码片段）会经服务器中转并作为历史保存。仓库本身、磁盘上的文件、Claude 凭证都留在你的电脑上。自建服务器的话，所有数据都在你自己控制的硬件上。