Quick Start

从零安装 coco

按本手册顺序完成四步:先装 VS Code 编辑器、注册 coco 账号、一键安装 coco、配置模型 API。 完成后即可在终端中以自然语言指挥 coco 完成代码、文档、研究等任务。

macOS · Apple Silicon Windows 10 / 11 · x64
PART 01 用 VS Code 内置终端运行 coco

安装 VS Code 编辑器

VS Code 是微软开源的代码编辑器,全平台免费、扩展生态最庞大 —— 内置的集成终端可以直接运行 coco,改代码与跑 coco 命令在一个窗口里完成,无需切换工具。

下载地址:https://code.visualstudio.com/ (macOS / Linux / Windows 全平台支持,免费)

下载安装后,按以下两步打开终端面板:

  1. 1

    下载并安装 VS Code

    打开 code.visualstudio.com, 按操作系统下载安装包,按系统惯例完成安装:

    • · macOS:解压下载的 zip,把 Visual Studio Code.app 拖入「应用程序」文件夹
    • · Windows:双击运行下载的 .exe,按默认选项一路下一步
    • · Linux:下载 .deb / .rpm 包安装,或在系统软件中心搜索「Visual Studio Code」
  2. 2

    启动 VS Code,打开内置终端

    打开 VS Code 后,看 窗口右上角的工具栏 —— 那里排着 4 个小图标,点击 第 3 个 (图标下半部分高亮、悬停提示 Toggle Panel), 窗口底部就会弹出终端面板。

    也可以走菜单 Terminal → New Terminal, 或快捷键 Ctrl + `(Windows / Linux)/ ⌘ + `(macOS)。

VS Code 与终端已就绪 —— 等会儿在 Part 3 把 coco 安装命令粘贴到这个终端面板里就行。先去注册 coco 账号。
PART 02 在 coco.sinoaus.net 创建账号

注册 coco 账号

  1. 1

    访问 coco 官网

    浏览器打开 coco.sinoaus.net,点击右上角 注册

  2. 2

    输入邀请码 + 邮箱

    填写销售或团队管理员发给您的邀请码、邮箱,按页面提示设置密码。提交后即创建账号。

  3. 3

    登录控制台

    注册成功后会自动登录到控制台 /dashboard。 如果之后需要重新登录,点击右上角 登录

PART 03 在 VS Code 终端中一键安装

安装 coco

  1. 1

    确认订阅有效

    登录 控制台,顶部「我的订阅」需要显示 ● 订阅有效订阅未生效时,下方安装区块不会显示「获取安装命令」按钮

    • · 团队所有者首次购买:若显示「暂未订阅」,点击 立即订阅, 选择席位数(1 起)与周期(6 / 12 个月),提交后通过支付宝完成付款,订阅即刻生效。
    • · 续费 / 扩容:同一入口 /subscription,可调整席位数后再次提交。
    • · 受邀加入团队的成员:订阅由所有者购买,您只需等所有者付款激活,无需重复订阅。
  2. 2

    在控制台获取安装命令

    订阅生效后,控制台主页 /dashboard 会出现 安装 coco CLI 区块, 点击 获取安装命令

    页面会展示两个独立的命令区块:macOS / Windows。 选择匹配您当前操作系统的那一块,点击 复制

  3. 3

    在 VS Code 终端面板粘贴并回车

    回到 VS Code,把刚才复制的命令粘贴到 Part 1 打开的底部终端面板里,按回车。

    命令大致长这样(仅示意,请用 dashboard 复制的):

    curl -fsSL https://coco.sinoaus.net/install/<token> | bash && export PATH="$HOME/.local/bin:$PATH" && hash -r && coco
  4. 4

    安装脚本自动完成全部工作

    安装脚本会按顺序执行:

    1. 检测 Node.js / Git / 包管理器等运行依赖(缺失会自动安装)
    2. 清理旧版本(保留您的 skills / memory / agents)
    3. 下载本平台对应的 coco 客户端,校验完整性
    4. 解压、写入身份文件、配置 PATH
    5. 自动启动 coco

    整个过程通常 1–3 分钟(取决于网速)。无需手动操作,等待即可。

PART 04 绑定设备到您的 coco 账号

浏览器授权

coco 安装完成后会自动启动,几秒钟后会自动弹出浏览器窗口 —— 这是首次设备授权流程,把当前这台机器登记到您的 coco 账号下。

在弹出的浏览器页面:

  1. 确认显示的是 您本人的 coco 账号
  2. 核对设备指纹(操作系统、机器名)一致
  3. 点击 确认授权

授权成功后浏览器会显示 ✓ 设备已绑定,回到 VS Code 终端 —— coco 就进入主界面了。

授权令牌缓存在本机 ~/.coco/cloud/auth.json(Windows 在 %USERPROFILE%\.coco\cloud\auth.json), 这台机器以后启动 coco 不再需要重新授权。
CONTINUE 登录后查看进阶内容

完成基础安装后,登录解锁进阶手册

恭喜!您已完成 coco 的安装、注册与设备授权。接下来的进阶内容(仅对登录用户开放)涵盖:

  • · Part 5 · 配置模型 API(含 Tavily 搜索)
  • · Part 6 · 用自然语言驾驭 coco(多 agent / skill / cron / MCP / 多模态 / SRE / 数据分析 等 9 个真实场景)
  • · Part 7 · 全部 49 个斜杠命令速查
  • · 常见问题 FAQ