快速开始

本指南将引导你设置 ServerCC 并在远程服务器上运行第一个 Claude Code 或 Codex 会话。

前置条件

  • 一台可通过 SSH 访问的远程服务器（Linux/macOS）
  • 服务器的 IP 地址或主机名、SSH 端口以及登录凭据（密码或 SSH 密钥）。如果你的服务器在 Tailscale 网络中，可以使用 Tailscale IP — 参见内置 Tailscale
  • 服务器上已安装 Node.js 18+（Claude Code 所需）

第一步：添加服务器

1

打开服务器标签页

启动 ServerCC。服务器标签页是默认首页。点击右上角的 + 按钮。

2

填写服务器信息

输入服务器的名称、主机地址（IP 或主机名）、端口（默认 22）和你的用户名。

3

选择认证方式

选择密码或私钥认证。使用密钥认证时，你可以导入已有的 SSH 密钥或现场创建一个。支持 Ed25519 和 RSA 密钥。

4

保存服务器

点击添加服务器。ServerCC 会创建服务器并自动建立一个默认工作区。

第二步：安装 Claude Code

5

打开服务器详情

点击新添加的服务器打开详情页面。你会看到 Claude Code 部分显示"未安装"。

6

安装 Claude Code

点击安装 Claude Code 按钮。ServerCC 会在服务器上运行安装并实时显示进度。通常不到一分钟即可完成。

第三步：启动 Claude Code 会话

7

进入工作区

在服务器详情页面，点击默认工作区（或你创建的任何工作区）。你会看到会话选择器。

8

创建新会话

点击新建会话。终端将打开并启动 Claude Code。如果是首次使用，你需要登录 — 会弹出登录卡片并显示说明。

第四步：与 Claude 交互

9

输入你的提示

使用终端底部的输入框输入消息给 Claude。按发送按钮提交。

10

使用快捷操作

当 Claude 请求确认（是/否提示、编辑审批）时，快捷操作按钮会自动出现在输入框上方，轻触即可响应。

第五步：后台运行与恢复

11

将会话放入后台

点击返回按钮并选择后台运行，让会话在后台继续运行。会话将出现在运行中标签页。

12

恢复会话

前往运行中标签页，点击任意会话即可重新连接。你也可以在工作区会话选择器中恢复之前的会话。

提示

你还可以从服务器详情页面访问纯终端（不带 Claude Code 的纯 SSH Shell）— 适合直接运行系统命令。

接下来

现在你已经完成了基本设置，可以探索其他功能：