快速开始

DevAgent 装完之后 3 分钟内跑起来 —— 本页带你走完首次登录 → 新建项目 → 用智能体对话的完整链路。

第 1 步：登录账号

打开 DevAgent，左下角点击「登录」按钮 —— 用你的邮箱注册 / 登录。登录后左下角会显示你的账号首字母头像。

为什么必须登录？

登录后 DevAgent 服务端会给你分发一份 Core / Core Pro 智能体的调用额度（登录邮箱里带的积分），未登录状态无法使用这两个内置智能体。

如果你已经有自己的 Anthropic / OpenAI API 密钥，也可以走自定义密钥 (BYOK)，跳过登录直接用。

第 2 步：新建项目

顶部 tab 栏点击「+」→「新建项目」，会弹出对话框：

• 本地项目：选一个本机的代码目录
• Git 仓库克隆：粘贴一个 git URL，DevAgent 会 clone 到本地
• SSH 远程：选一台已经配置好的 SSH 主机，在远程主机上创建 / 打开项目

项目 vs 工作区

一个「项目」是一个代码仓库（或本地文件夹）；每个项目可以开多个「工作区」（基于 Git worktree），并行处理不同分支的任务不会互相污染。

第 3 步：选择智能体

新建工作区时，「运行于」下拉里选一个智能体：

智能体	说明
Core Pro	最强模型（Claude 或同级），适合复杂重构 / 架构设计 / 疑难 bug
Core	轻量模型，适合日常小改动 / 快速问答
Claude Code	需要本地装 claude CLI；使用你自己的 Claude 账号 / 密钥
Codex / Gemini / Cursor / ...	其他主流智能体，需要各自的登录 / 密钥

选完点「创建」，DevAgent 会打开一个新 tab，里面是终端 + 智能体对话界面。

第 4 步：开始对话

在底部输入框里描述你要做的事，比如：

帮我在这个 React 项目里加一个夜间模式切换按钮，参考现有的 theme provider

智能体会自己读代码、写补丁、跑测试；每一步的文件改动、命令输出你都能实时看到。

使用自定义密钥 (BYOK)

如果你有自己的 API 密钥（比如公司的 Anthropic 企业账号、或者国内代理厂商的密钥），可以在「设置 → 自定义密钥」里添加：

1. 点「添加」→ 填写名称、Base URL、API Key
2. 从 ccswitch 导入现有密钥也支持
3. 勾选要生效的智能体（Core / Core Pro / Claude Code）
4. 密钥使用系统级加密保存在本地，不会上传任何服务器

Claude Code 特别说明

Claude Code 的 BYOK 是 fallback-only —— 如果你本地已经跑过 claude login 或有 settings.json，DevAgent 会尊重本地配置，不覆盖。只有本地完全没配置时才用 BYOK 兜底注入。

下一步

• 装不上 / 用不了？ → FAQ
• 想深入了解某个功能？完整文档正在补充中，敬请期待