Gajae-Code新手第一小时：从/login登录到跑通第一个编程任务，只需3步

【免费下载链接】gajae-codeGajae Code MVP项目地址: https://gitcode.com/gh_mirrors/ga/gajae-code

Gajae-Code（命令名gjc）是一款终端 AI 编程 Agent 工具：用你已经在付费的编程订阅/login登录即可运行，改代码前先出计划、带审批门禁，还能在手机上回复 Agent 的提问。本教程面向零基础新手，按 3 个步骤走，一小时内即可跑通你的第一个编程任务，全程只需少量命令、无复杂配置。

📌这一小时你将完成：安装 Gajae-Code →/login登录订阅 → 让 Agent 理解并规划任务 → 执行并验证第一个任务。

步骤1：两条命令安装，用/login完成订阅登录

这是新手最容易卡住的一步，其实最快路径就是"装好 → 登录"两件事。

1. 安装

Gajae-Code 提供 Linux / macOS / Windows 的预编译二进制，不需要额外安装运行时。完整安装步骤、校验与更新渠道请看官方安装文档：docs/install.md。

gjc --version # 确认安装成功 gjc --smoke-test # 自检，秒级完成

2. 进入会话并登录

在你的项目目录里运行gjc进入终端界面，然后输入/login，选择你已经付费的编程订阅（coding plan）：

登录一次即可，无需再按 token 单独计费。更多 OAuth 订阅与密钥型预设的接入方式，参考 docs/models.md。

💡 新手建议：第一次就选你最熟悉的订阅，别在"选哪个模型"上纠结——这是第一小时里最容易浪费时间的地方。

步骤2：先访谈后计划，让Agent看懂你的任务

Gajae-Code 的核心设计是"计划门控"工作流：在任何文件被修改之前，先访谈、再规划、过审批门。这正是它和普通"上来就改代码"的编程 Agent 最大的区别。

1./skill:deep-interview—— 把模糊需求问成明确需求

/skill:deep-interview

Agent 会以只读方式向你提问（不改任何文件），把"帮我优化一下这个函数"这类模糊请求，访谈成一份具体的需求说明。

2./skill:ralplan—— 生成实现计划并自我批判

/skill:ralplan

Agent 基于需求产出实现计划，并做一轮对抗式评审，最终生成一份"计划回执"。计划没通过Approval Gate（审批门）之前，仓库保持零改动。

整个流程如下：

🔒 前两阶段都是 Read-only（只读）。你可以放心大胆地描述任务，Agent 不会在批准前动你的代码。

步骤3：用ultragoal执行第一个编程任务，带证据验收

计划获批后，进入执行阶段。ultragoal会跟踪目标从执行、修订到验证的全过程，每一步都留下证据：

gjc ultragoal create-goals --brief-file <approved-plan>

执行时你会看到 4 个内置角色 Agent 分工协作（无需额外配置）：

任务完成后，让 Agent 展示验证证据（测试输出、diff 摘要）再收尾——养成"先看证据、再合入"的习惯，比什么都重要。

加分项：跑偏了怎么办？手机回复与排障速查

离开电脑也能推进任务。Agent 需要你做决定时，可以把提问路由到 Telegram / Discord / Slack，你在手机上回复即可继续执行。配置入口：/settings→ Notifications，或无头方式gjc notify setup。上手指南见 docs/telegram-onboarding.md。

命令记不住？用速查表。项目自带中英韩三语速查表（PDF + 长图），建议收藏：

• 英文速查表：docs/cheatsheet/gajae-code-cheatsheet-en.pdf
• 中文速查表：docs/cheatsheet/gajae-code-cheatsheet-ko.pdf（韩语版）

东西没生效？一条命令体检：gjc customize doctor，它会报告每个自定义项的来源、优先级与修复建议（只读、不改你的配置）。

新手资源清单：第一小时之后继续深入

• 产品总览与快速开始：README.md（中文：README.zh-CN.md）
• 安装与更新渠道：docs/install.md
• 模型、订阅与认证解析：docs/models.md
• 工作流技能与角色 Agent 源码：packages/coding-agent/src/defaults/
• 仓库包结构与架构地图：docs/codebase-overview.md
• 新手入门上下文包：docs/onboarding-packet.md

⚠️ 提示：Gajae-Code 目前是 beta 阶段项目，重要改动请先在独立分支或 worktree（gjc --tmux --worktree my-task）中验证输出，再依赖其结果。

恭喜！到这里你已经走完了 Gajae-Code 新手第一小时的全部 3 步：/login登录订阅 → 访谈与计划 → 执行并验证第一个编程任务。下一步，试着给它一个真实的小需求吧。

【免费下载链接】gajae-codeGajae Code MVP项目地址: https://gitcode.com/gh_mirrors/ga/gajae-code