Kimi Code Desktop 装好之后最容易卡住的地方，不是模型能力，而是顺序：先把本地项目挂进客户端，再确认问答用的是哪个模型，然后用一段已有代码验证它能不能读到项目文件，最后才考虑让它直接改文件。跳过第三步直接让它改，往往会出现改错文件、路径对不上、或者改动落在你根本没打开过的目录里。判断链路是否走通的标准很直接：AI 的回答里出现了项目里真实存在的文件名，并且给出的路径层级和你的项目根目录一致。

建议按“开项目 → 配模型 → 问代码”三步走通再放开写权限。适用场景是刚装好客户端、对项目结构有把握的本地仓库。操作动作：选中含 .git 的代码根目录、在设置里选定用于代码问答的模型、用现有函数提问验证上下文。验证方式：回答是否引用真实文件、路径是否正确、改文件前是否有预览。边界：版本不同界面入口会有差异，找不到修改预览时先让它只输出代码片段，由你手动粘贴。

在客户端里新建或打开一个本地项目目录

第一步只做一件事：把项目目录和客户端绑定。打开方式通常有两种，一是启动页上的“打开文件夹 / 打开项目”，二是客户端里的菜单项，两者效果一样，选哪个取决于你当前停在哪个界面。“新建项目”适合空目录，如果你已经有仓库，直接用“打开文件夹”更省事。

目录选择上有个取舍：建议直接选中代码仓库的根目录，也就是包含 .git、package.json、pyproject.toml 这类标识文件的那一层。如果图省事选了上一级目录，文件树里会多出一层无关的文件夹，后面 AI 引用路径时也可能带上多余前缀，排查起来很费时间。

确认项目根目录已加载，看三个地方就够了：侧边栏文件树展开后首层内容是否是你的项目文件；标题栏或项目切换处是否显示了项目名；随便点开一个源文件，编辑器里能不能正常显示内容。如果文件树是空的，多半是目录选错或者权限没给到，先解决这个再往下走。

在设置里选择用于代码问答的模型

模型配置的入口一般在设置、偏好设置或模型管理这类菜单里，位置会随版本变化，需要结合你本地的客户端确认。这里不指定具体该选哪个模型名，因为可选项取决于你的账号能访问到什么；你需要确认的是这一项被显式选定了，而不是停在“默认”上让客户端自己决定。

配置时注意区分用途：用于对话问答的模型和用于代码补全的模型在有些客户端里是分开配置的。如果你只想先跑通问答链路，把对话/代码问答那一项选好并保存即可，补全相关的可以先不动。

保存后的验证问题要足够简单，比如打开一个文件选中几行，问“这段代码大概在做什么”。如果等待很久没有回应、或者报错提示模型不可用，先回到设置检查是否已经登录账号、模型列表是否为空。这一步不通过，后面所有验证都没有意义。

用一段现有代码向 AI 提问验证上下文

第三步是整套流程里最容易被忽略的一步。找一个项目里真实存在的函数，选中它，然后提一个必须依赖上下文才能答的问题，例如：“这个函数在项目里还有哪些地方调用，入参校验放在哪里更合适？”

观察点有两个。第一，回答里是否引用了项目内其他真实存在的文件；如果它只围绕你贴出的这段代码空谈，说明上下文没有挂上。第二，回答中出现的代码路径是否正确，是相对项目根目录的相对路径，还是莫名其妙多了一层前缀。路径层级不对，通常是第一步目录选深了或选浅了。

这一轮验证不必要求答案多准确，重点是确认“读得到项目文件”这件事成立。确认之后再让它改文件，出问题的概率会低很多。

确认 AI 改文件前是否有预览或确认步骤

让 AI 直接改文件之前，先找清楚修改预览在哪里。通常在对话区域里，AI 提出的改动会以补丁或对照形式展示，也可能在编辑器里新开一个对比标签页。不同版本的展示位置不完全一样，以你本地实际界面为准。

预览旁边一般会有一个确认动作，文案可能是“应用”“接受”“Apply”之类；对应的拒绝动作通常是放弃、取消或直接忽略这次改动。可以先故意拒绝一次，看文件内容有没有被改动——如果没有变化，说明确认环节生效，你可以放心让它动手；如果拒绝之后文件仍然被写过，那就要谨慎，改成让它只输出代码片段、由你自己粘贴。

用 git diff 检查 AI 实际改了什么

让 AI 改完文件后，不要凭感觉判断。项目已经用 git 管理的话，先看状态再看差异：

git status
git diff `--stat`
git diff
git diff -- src/your_file.py

阅读 diff 的重点是三个：改动是否只落在你预期的文件里，有没有顺手改了配置或依赖文件；被改动的行是不是你要求改的那一处，有没有连带删除别的逻辑；新增的代码有没有引入项目里并不存在的函数或模块。

如果 diff 不合预期，回退也很直接。还没加入暂存区的文件：

git checkout -- src/your_file.py
# 或者
git restore src/your_file.py

已经执行过 git add 的，先把改动撤出暂存区再回退：

git restore `--staged` src/your_file.py
git restore src/your_file.py

建议把“提问 → 看 diff → 决定留下还是回退”固定成习惯动作。这样即使某次改动方向不对，损失也仅限于本地工作区，不会把问题带到更远的地方。