文档 / MCP 与 ACP
Claude Code
在 Yuli 中使用你自己的账户运行你自己的 Claude Code，连接整个 IDE，并遵循相同的规则。
在订阅模式下，Yuli 运行的是你自己的 Claude Code，不做任何修改，并使用你自己的账户。Claude Code 负责推理；Yuli 将整个 IDE 作为工具提供给它，并执行与其自有智能体相同的规则。
Claude Code 是 Anthropic 的产品。Yuli 与 Anthropic 无关联，也未获得其背书。Yuli 从不接触你的凭据：由你自己通过官方流程登录。
逐步连接
- **选择智能体。**在聊天上方的选择器 你和谁一起工作？ 中，从“你的订阅 · 你的账户”分组里选择 Claude Code。也可以在 全局选项 → AI 和模型 → AI 模式 → 智能体 中选择。
- **安装。**如果 Yuli 找不到
claude，会显示 “安装 Claude Code 以在此使用”。点击 打开官方安装程序，完成安装后点击 重新检测。Yuli 不会下载或安装该 CLI。 - 提示。仅显示一次：“开始使用订阅模式之前” 会说明 Claude Code 使用的是你的账户，它读取的代码会以你的账户发送给 Anthropic，与在 Yuli 之外使用时完全相同。点击 知道了，继续。
- **文件夹信任。**对于 “是否为 Claude Code 信任此文件夹？”，选择 信任并打开 Claude Code。Yuli 还会同时批准
yuli服务器，这样 Claude Code 就不会再次询问。 - 像往常一样，在终端中于 Claude Code 内 登录。
- 如果 Claude Code 尚未批准
yuli服务器，会出现 立即批准：它会以同一对话重启会话。
Yuli 会在 PATH、官方安装程序和 npm 的安装路径中检测 claude，在 Windows 上还会在 WSL 中检测。
配置存放位置
默认情况下，Yuli 不会在你的项目中写入任何内容。其配置保存在 Yuli 的工作文件夹中，并在启动 Claude Code 时通过 CLI 的公开选项传递给它：
| 选项 | 文件 | 内容 |
|---|---|---|
--settings |
settings.json |
权限、hooks 和状态行。 |
--mcp-config |
mcp.json |
通过 stdio 连接的 yuli 服务器。 |
--append-system-prompt-file |
rules.md |
Yuli 的规则。 |
--plugin-dir |
plugin/ |
yuli-code 插件：Yuli 的技能和评审智能体。 |
在 Windows 上，这些文件位于 %LOCALAPPDATA%\.yulicode\workspaces\<id del proyecto>\claude\，每次登录会话时都会重新生成。
放在项目内（可选）
在 全局选项 → AI 和模型 → AI 模式 的“订阅模式规则”分组中，关闭 配置保存在项目之外。之后 Yuli 会将配置写入项目内部，并排除在 Git 之外：
| 文件 | 内容 |
|---|---|
.mcp.json |
注册 yuli 服务器。保留你的其他服务器。 |
.claude/CLAUDE.md |
Yuli 的规则，位于一个受管理的区块中。区块之外你写的内容永远不会被改动。 |
.claude/settings.local.json |
权限和 hooks。你的规则会被保留。 |
.claude/hooks/yuli-hook |
将每个事件转发给 Yuli。 |
.claude/rules/ |
技术栈标准和 Sonar 规则。 |
.claude/skills/yuli-* |
Yuli 的流程。 |
.claude/agents/yuli-reviewer.md |
评审智能体。 |
写入之前，Yuli 会逐个文件展示 diff：应用 N 个文件 或 暂不。这些更改会作为一个任务进入更改窗口，并且可以撤销。
权限
| 列表 | 内容 |
|---|---|
| allow | Bash、Edit、Write、MultiEdit、NotebookEdit、WebFetch、WebSearch 以及 yuli_* 工具（Git 和 CI 除外）。 |
| ask | git commit、git push、git merge、git rebase、git reset --hard、gh pr、glab mr、az pipelines、az repos，以及 yuli_git_commit、yuli_git_push、yuli_cloudbees。 |
| deny | 读取 .env（任何文件夹中）和 ~/.ssh/**。密钥和 *.pem 由 hook 拦截。 |
Yuli 还会关闭提交和 PR 中的自动署名。
Hooks
| 事件 | Yuli 的处理 |
|---|---|
SessionStart |
注入项目记忆、架构风格和任务。在压缩或恢复之后，会再次注入任务。 |
UserPromptSubmit |
根据你的需求，决定本次会话是否启用 Git 和 CI。 |
PreToolUse |
拦截未经要求的 Git/CI 操作和机密读取，检查结构和命名，并以卡片形式展示问题。 |
PostToolUse |
将工作同步到更改窗口、计划、验证和质量中。 |
PermissionRequest |
将请求显示为 Yuli 的卡片。 |
Stop |
在验证未通过或未完成度量时，不允许结束本轮，直到达到重试次数上限。 |
SubagentStart / SubagentStop |
统计后台运行的子智能体。 |
Notification |
提醒终端中出现的对话框。 |
如果 Yuli 已关闭，hooks 不会阻止任何操作。
工作
该标签页有两种视图，可在右上角切换：
- 聊天（默认）：你的需求、带格式的回复、已更改的文件、验证结果和实时计划。Claude Code 以紧凑形式显示在下方：你在那里输入。
- 终端：全屏显示 Claude Code。
两种视图的上方都有：
- 模型 和 推理强度。应用并重启 会重启 Claude Code，并继续同一对话。
- Claude 套餐用量：5 小时窗口、每周用量和消费上限。
Claude Code 终端中自带的菜单会以卡片形式显示，选项完全相同。只有在你点击时，Yuli 才会发送按键。
Yuli 强制执行的规则
| 规则 | 方式 |
|---|---|
| 仅在你要求时使用 Git、CI 和 DevOps | 如果本次会话中你没有提出要求，hook 会拦截它们。提出要求后，每个操作仍需批准。 |
| 仅在你要求时创建分支 | 即使 Git 已启用，创建分支或 worktree 也会被拦截。 |
| 机密受到保护 | 不读取 .env、密钥或凭据。 |
| 结构与命名 | 每次写入都会检查；如有问题，会被拦截并给出确切的修正方法。 |
| 完成标准 | 验证（构建、测试和启动）未通过时，Claude Code 无法结束本轮。 |
关闭 强制执行规则 即可切换为“仅提醒”。Git 和机密始终受到保护。验证重试次数 决定 Yuli 坚持的次数（默认 3 次）。
故障排除
| 症状 | 处理方法 |
|---|---|
| “等待 Claude Code 使用 Yuli 的工具” | 批准 yuli 服务器，或点击 立即批准。用 /mcp 检查。 |
/mcp 显示 yuli 出错 |
在 Yuli 中打开该项目。yuli_status 会说明原因。 |
| 规则没有变化 | 规则在启动时加载：从工具栏重启会话。 |