快速上手

本页按照零基础用户第一次打开 LoongCode 的时间线，一步一步带你完成第一次 AI 对话。如果你还没有安装 CLI 或配置账号，请先阅读前置依赖。

首次启动：跟着新手引导走

第一次打开 LoongCode 时，界面中央会自动弹出新手引导。引导共分 5 章，每章聚焦一个主题：

章节	内容
起步	欢迎 → 打开工作区 → 新建任务 → 设置 claude（即配置 Claude CLI，界面原文如此）→ 发送首条消息
看代码	目录树 → 查看文件 → 编辑文件
进阶选项	模型 → 思考深度 → 执行授权 → 浏览器标签页
Git	分支 → 审查
设置	常规 → 模型供应商 → 插件 → 技能 → MCP 服务器 → 使用统计

引导中带实操闸门的步骤需要你完成对应动作才会自动跳到下一步；其他步骤点下一步即可前进。你也可以随时点跳过此步或退出引导。

引导结束后，可在设置 → 常规 → 使用引导处按章重看，或点从头重看重新体验完整流程。

没有引导怎么办？

如果引导弹窗被意外关闭，打开设置 → 常规，找到使用引导区域，点击从头重看即可重新开启。

第 1 步：打开工作区

工作区就是你要让 AI 帮你处理的项目文件夹。打开工作区之后，AI 才能读取其中的代码和文件。

下面两条路径二选一即可。初次尝试推荐路径 A，后续步骤也以它为例；想直接用自己的项目就走路径 B，之后的操作完全相同。

路径 A：使用示例工作区（推荐初次尝试）

1. 在新手引导「打开工作区」步骤中，点击打开示例工作区按钮。
2. LoongCode 会自动创建并打开一个内含 README、脚本和笔记的示例项目文件夹。
3. 左侧任务栏中出现示例工作区的名称，说明已成功打开。

路径 B：打开自己的项目

1. 点击左侧任务栏中搜索框下方的**＋ 打开工作区**按钮。
2. 在文件选择对话框中找到你的项目文件夹并确认。

第 2 步：新建任务

任务是一次独立的 AI 会话——每个任务拥有自己的对话记录、配置和上下文，互不干扰。

1. 点击左侧任务栏中搜索框下方的**＋ 新建任务**按钮。
2. 中央区域切换为草稿态——草稿是任务还未正式开始时的预备状态，首条消息发送后任务才正式创建。

另一个入口

把鼠标移到左侧任务栏中的工作区名称上，名称右侧会出现新建任务图标，点击它同样可以在该工作区下新建任务。

草稿会记住上次配置

新建任务时，CLI、模型、思考深度、执行授权等选项默认继承上一次任务的设置，无需每次重新调整。

第 3 步：配置任务（可全部保持默认）

草稿态界面底部的选择器条显示当前任务的所有配置项。对于初次使用，默认值即可满足大多数需求。

配置项	说明	新手建议
CLI	选择驱动引擎：Claude CLI（Anthropic 出品）或 Codex CLI（OpenAI 出品）	保持 Claude CLI
模型	选择具体的 AI 模型	保持默认
思考深度	控制 AI 的推理深度，越深越细致但更慢；Claude 选项：low / medium / high / xhigh / max / ultracode	保持默认（出厂默认为 max），嫌慢可调低至 high
执行授权	控制 AI 执行文件操作和命令的方式；选项：default / plan / acceptEdits / bypassPermissions	建议改为 default（每步操作先征求确认；出厂默认为 bypassPermissions，即完全自主执行）
工作区	当前任务关联的项目文件夹	无需修改
分支	当前 Git 分支（仅对 Git 仓库显示）	无需修改

首次使用需要先配置 API 密钥

如果你还没有配置过账号或 API 密钥，AI 将无法正常应答。请先前往设置 → 模型供应商完成配置，再回来发消息。

第 4 步：发送第一条消息

输入框的占位提示为：「向 Claude 提问，输入 @ 添加文件，/ 使用命令，$ 使用技能」

1. 点击中央输入框，光标出现在框内。
2. 输入你的问题。对于示例工作区，可以试试：「介绍一下这个工作区里有什么」
3. 按 Enter 键（或点击发送按钮）发送消息。

消息发出后，草稿态结束，任务正式创建，AI 开始处理你的请求。

输入框触发器

• 输入 @ — 从工作区文件列表选择文件，添加到对话上下文
• 输入 / — 打开命令面板，使用内置命令（如 /compact 压缩对话上下文）、插件命令和技能

第 5 步：看懂 AI 的回复

回复的几种形态

• 流式文字：AI 的文字回答实时逐字显示，Markdown 格式自动渲染。
• 思考过程（折叠块）：当思考深度高于 low 时，AI 会先输出内部推理过程，默认折叠显示为「思考过程」，点击可展开查看。
• 工具卡片：AI 执行文件操作时会出现带状态图标的卡片，例如「读取文件」「写入文件」「执行命令」；修改代码时会显示 Diff（代码差异）。
• 提问卡片：当执行授权设为 default 或 plan 时，AI 需要你确认才能继续操作——卡片上会出现允许 / 拒绝等按钮。

任务状态

左侧任务栏中，每个任务行左侧有一个小圆点，用颜色指示任务状态，用明暗指示有没有未读消息。

指示灯	状态	含义
	空闲	AI 已停止，等待你输入下一条消息
	运行中	AI 正在处理请求（圆点发光）
	成功	最近一轮对话正常结束
	出错	最近一轮对话发生错误
	提问中	AI 正在等你回答提问卡片中的问题（圆点发光）

圆点的明暗则表示这个任务有没有你还没看过的新消息：

指示灯	明暗	表示
	明亮（满色）	有未读的新消息
	暗淡（半透明）	已读——你已查看过最新消息

几点说明

• 圆点不会闪烁，「运行中」和「提问中」靠发光提醒你。
• 「运行中」是个例外：只要任务还在跑，圆点就始终明亮，不会因已读而变暗。
• 各状态指示灯的完整说明见任务与工作区。
• 「提问中」时，输入框占位提示会变为「请在上方卡片作答;或在此草拟下一条消息…」（界面原文如此）。

下一步

完成第一次对话后，建议了解主界面的完整布局——前往界面导览了解每个区域的功能，或直接进入任务与工作区学习更多使用技巧。