添加你的第一个项目
将你的代码文件夹导入 1DevTool,60 秒内开始工作。
在打开终端或运行 AI agent 之前,你需要先添加一个项目。项目会告诉 1DevTool 你正在处理哪个文件夹,这样它就能在正确的目录下打开你的 AI 终端、记住你的数据库连接,并把所有工具整齐地集中在一处。
什么是项目?
在 1DevTool 中,“项目”就是一个代码文件夹——可以是你的 Git 仓库,也可以是你本机(或远程服务器)上任何想要处理的文件夹。
每个项目在 1DevTool 中都有自己独立的空间,包括:
- 颜色标记:在侧边栏中一眼就能认出它,当你同时打开多个项目时尤其有用
- 保存状态的终端:终端会话在重启之间会被保留,因此不会丢失上下文
- 数据库连接:每个项目都有自己的数据库列表,不会误把某个数据库连到错误的应用
- 已打开的文件:关闭 1DevTool 时打开的文件,再次回来时依然在原处
- HTTP 请求:保存的 API 请求只属于它所在的项目
你可以添加任意数量的项目,切换也是即时的——只需点击左侧边栏即可。
添加本地文件夹
这是最常见的起点。如果你的电脑上已经有一个代码文件夹:
- 点击左侧边栏底部的 + 按钮。你也可以在 Mac 上按
Cmd+N,在 Windows 上按Ctrl+N。 - 弹出对话框后,点击 “Open Folder”。
- 在文件选择器中找到你的项目文件夹,然后点击 Open。
- 为项目命名。默认使用文件夹名称,通常就很合适。
- 选择一个颜色标记。该颜色会以小徽标的形式显示在侧边栏的项目旁边,方便你一眼区分不同项目。你可以随时更改。
- 点击 Add Project。
项目现在已出现在侧边栏中,点击它即可打开。

从 Git 克隆
如果你的项目托管在 GitHub、GitLab、Bitbucket 或其他任何 Git 平台上,可以直接在 1DevTool 中克隆——无需另外打开终端。
“克隆”指的是把远程仓库下载一份副本到你的电脑上。如果你以前没做过,1DevTool 会让它变得很简单:
- 点击侧边栏中的 + 按钮。
- 选择 “Clone from Git”。
- 粘贴你的仓库 URL。这就是 GitHub 上“Clone”按钮提供的 URL,形如
https://github.com/yourname/your-repo.git。 - 选择克隆后的文件夹在本机上的保存位置,例如
~/Code/或~/Projects/都不错。 - 点击 Clone。
1DevTool 会下载该仓库,并自动将其添加为项目。你可以实时看到进度。完成后,就可以打开终端了。
注意: 克隆需要你的机器上已安装 Git。大多数电脑都已自带。你可以打开任意终端并运行
git --version来检查,如果能看到版本号,就没问题。

通过 SSH 添加远程服务器
如果你在远程服务器上开发——比如 VPS、DigitalOcean 或 AWS 上的云主机,或者远程工作站——也可以把它添加为项目。
1DevTool 通过 SSH(访问远程机器的标准安全方式)进行连接。连接成功后,你的远程文件夹用起来就和本地项目一样。
- 点击 + → “Add via SSH”。
- 填写服务器信息:
- Host:服务器的 IP 地址或域名,例如
123.45.67.89或myserver.com - User:你在服务器上的用户名,例如
ubuntu或root - Port:通常是
22。只有在服务器使用非标准端口时才需要修改。 - SSH Key:私钥文件的路径,例如
~/.ssh/id_rsa。如果你使用密码登录,请留空,系统会提示你输入。
- Host:服务器的 IP 地址或域名,例如
- 点击 Connect。
1DevTool 会连接到服务器,并允许你浏览远程文件系统。选择一个文件夹作为你的项目,它就会出现在侧边栏中。终端、数据库客户端和文件编辑器都能正常使用——只不过它们运行在远程机器上,而不是本地。

下一步
项目已就绪,现在该在其中打开一个 AI agent 了。
继续阅读 添加你的第一个 AI Agent →