快速开始

本页带你完成一条完整路径：安装 Cocode、登录、打开项目、提出任务、确认修改并运行验证。

开始前

• 一台支持的 macOS、Linux 或 Windows 设备。
• 一个 Cocode 账号。
• 一个可以修改的代码仓库。
• 如果使用 TUI：Node.js 22.19.x 或更高版本（Node 24+ 也支持）以及真实 TTY。

1. 安装 Cocode

GUI 是 Electron 桌面应用，请从Cocode 下载页进入对应的 GitHub Releases 下载包；TUI 通过 npm 安装：

npm install --global @cocode-agency/tui
cocode doctor

然后按需要启动：

cocode              # 默认进入 TUI
cocode gui          # 打开 GUI
cocode tui          # 明确进入 TUI

2. 登录并打开项目

首次运行时完成浏览器登录。GUI 使用原生授权流程，TUI 使用设备码流程；设备码过期或被拒绝时重新执行登录即可。然后在项目目录中启动 Cocode：

cd your-project
cocode

首次进入模型设置时，选择 Cocode Nut 或配置自己的 BYOK（DeepSeek API Key / OpenAI-compatible endpoint）。BYOK 请求不消耗 Nut 额度。

3. 提出第一个任务

用一句话描述你希望得到的结果，例如：

请先检查这个项目的测试命令，然后找出登录页面的一个小问题，给出修复计划，不要立即修改文件。

Cocode 会先理解任务并展示计划。涉及写文件、执行命令或联网的动作，会在需要时停下来等待确认。

4. 查看并确认修改

确认前检查将要修改的文件、计划执行的命令、预计结果，以及是否需要调整任务范围。确认后继续；拒绝动作时补充限制，Cocode 会重新规划。

5. 运行验证

让 Cocode 运行项目已有的测试、检查或构建命令。完成后查看修改摘要、测试命令和结果、未解决的问题与后续建议。

接下来

• 使用GUI 桌面工作台深入了解可视化工作流。
• 使用TUI 终端界面了解快捷键和 SSH 场景。
• 阅读权限与确认了解安全边界。
• 需要切换入口时，只有相同 DSH_HOME、profile 和 Host scope 的 GUI/TUI 才会共享会话。