新手指南
从下载到第一次对话
三步开始使用 alpha-code。不需要 API key,不需要终端,不需要任何技术背景。
1. 下载并安装
在 下载页 获取 Mac 安装包(.dmg 文件)。下载完成后双击打开,把 「alpha-code」图标拖进旁边的「应用程序(Applications)」文件夹,安装就完成了。
第一次打开:在「启动台」或「应用程序」文件夹里点 alpha-code。应用已经过 Apple 公证,正常情况下直接就能打开; 如果系统提示「无法验证开发者」,在 系统设置 → 隐私与安全性 页面底部点「仍要打开」即可(只需一次)。
2. 登录账号
打开应用后点「登录」,会自动跳到浏览器完成登录(支持手机号验证码),登录成功后浏览器会提示「返回 alpha-code」—— 点击允许,应用里就显示已登录了。
登录后即可直接使用平台代付的 AI 模型,不需要自己申请任何 API key、不需要任何配置。 新账号的用量额度与充值方式见 定价页。
3. 打开一个项目,开始第一次对话
首页会引导你「打开第一个项目」——选择你电脑上的一个文件夹(比如一个工作目录或代码项目)。然后在中间的输入框里, 用平常说话的方式描述你想做的事,回车发送。比如:
- 「帮我看看这个文件夹里都有什么,整理一份清单」
- 「把这份 README 翻译成英文」
- 「这个项目的代码里有没有明显的问题?」
输入框里还有两个快捷键:输入 / 可以调出命令菜单,输入 @ 可以引用项目里的文件。 不用刻意去学,想起来再用就行。
常见问题
遇到问题先看这里
登录时浏览器打开了,但点击后应用没反应?
先确认 alpha-code 还在运行(Dock 里有图标)。然后回到浏览器重新点一次「返回 alpha-code」;如果浏览器询问 「是否允许打开 alpha-code」,要点「允许」。还不行就退出应用重新打开、再登录一次——重装或更新应用后,第一次登录 需要重新授权是正常现象。
提示「登录已过期」或界面显示未登录?
点「登录」重新走一遍浏览器授权即可,你的账号数据不会丢。应用更新后偶尔需要重新登录一次,属正常现象。
发消息后一直转圈 / 提示网络错误?
先检查电脑能否正常上网(打开任意网页试试)。如果网络正常但仍失败,多数是模型服务瞬时波动——等几秒重发一次; 应用会在消息下方如实显示失败原因,不会静默吞掉。持续失败请到 下载页 确认是否有新版本。
提示「额度不足」或「余额不足」?
两句提示的处置不一样。「余额不足」= 钱包余额不够:到 定价页 了解会员, 或在网站右上角进入「钱包」充值;充值后无需重启应用,直接继续对话即可。 「额度不足」= 会员额度窗口已用尽 —— 这种情况充值不会自动恢复服务, 因为额度用尽后我们默认不动你的钱包余额。请等额度窗口重置,或到账户页开启「额度用尽后继续扣钱包余额」再充值。
模型列表里只有 DeepSeek,没有别的模型?
国内版默认提供国内可直连的当代模型(DeepSeek V4 系列),保证速度与稳定性。如果你有其它模型的官方 API key, 可以在应用的「设置 → 模型」里自行添加(即 BYOK,自带钥匙),这属于进阶用法,不配置也完全够用。
AI 会不会乱改我电脑上的文件?
默认权限档是「请求审批」:AI 每次要修改文件或执行命令,都会先弹出确认,你点允许才会执行。输入框左下角可以切换权限档; 「完全访问」适合你信任的重复性任务。另外「自动化」定时任务固定使用只读档,不能改文件、不能执行命令。
我的代码 / 文件会被上传吗?
对话中 AI 读取的内容会发送给模型服务用于生成回答(这是所有 AI 助手的工作方式)。密钥类文件(如 .env)默认被排除; 使用「云任务」派发时只传代码变更(diff),绝不上传整个项目;每次云任务在项目的 .alpha 文件夹里留有可查的记录。
应用打不开 / 打开就闪退?
先重启一次电脑再试。若仍失败,到 下载页 重新下载最新安装包覆盖安装 (你的账号与历史记录保存在本机用户目录,重装不会丢失)。
会话数据库损坏或提示「版本过新」?
应用自带数据安全带:升级前会自动备份会话数据库,损坏时启动会弹窗指引你从最近的备份一键恢复;用旧版本打开新版本的数据时 会如实拦截并给出选项。菜单栏「数据」里也可以随时手动备份或导出。
想让 AI 定时自动做事(比如每天早上整理待办)?
侧栏「自动化」——用一句话描述任务和时间(如「每天早上 9 点,检查项目里未处理的 TODO 并生成清单」),确认后到点自动执行, 结果保存在项目的 .alpha/runs 文件夹并弹系统通知。注意:任务只在应用运行时执行,应用没开就会按策略跳过并留记录。
进阶功能(自带 API key、连接器/技能市场、云任务、自动化)在应用内的「定制中心」都有说明;本页只覆盖起步路径。