跳转到内容

第一次配置

假设你已完成 安装与启动。本页目标是:让 AI 正常读取一个安全的测试文件夹并回复。

入口:设置 → 必要配置

只选一条与自己情况相符的路径。

配置方式适合谁需要填写
慧AI(推荐新用户)已有慧AI账号慧AI 登录令牌
自定义已有自建、中转或第三方兼容服务界面要求的 Base URL 和 API Key
  1. AI 助手配置 中把配置来源设为 慧AI
  2. 在令牌区域填写 慧AI 登录令牌
  3. 点击 保存,再点击 检查连接
  4. 看到连接可用后继续下一步
  1. AI 助手配置 中把配置来源设为 自定义
  2. 按当前界面提示填写 Base URLAPI Key
  3. 点击 保存,再点击 检查连接
  4. 看到连接可用后继续下一步

不同服务对 Base URL 的格式可能不同,请以输入框说明和连接检查结果为准。凭证与扩展能力的完整关系见 API Key 与数据去向

  1. 选择一个不含密码、客户数据或其他敏感内容的文件夹
  2. 选择 Claude Code;如果它未运行,选择任一显示“运行中”的助手
  3. 新建会话

建议第一次使用新建的测试文件夹,不要直接选择整个磁盘、用户主目录或重要生产项目。

只读查看这个文件夹。
列出其中的文件,并用三句话总结主要内容。
不要修改、移动或删除任何文件。
只读分析这个项目。
说明它的用途、主要目录和可能的启动方式。
先不要修改代码,也不要安装依赖。

如果出现权限请求:

  1. 确认路径是刚才选择的测试文件夹
  2. 确认操作是读取而不是删除、上传或执行未知命令
  3. 再允许本次操作
  • 检查连接显示可用
  • 助手状态为“运行中”
  • 会话收到正常回复,而不是立即出现401或连接错误
  • 回复提到了测试文件夹里的真实文件或内容
现象先检查
连接检查失败重新复制凭证,确认配置来源和网络
助手一直未就绪等待片刻后刷新;确认连接检查已通过
能回复但读不到文件项目路径是否正确;是否拒绝了读取权限
401或未授权API Key 或令牌是否完整、有效

仍无法解决,请按现象查看 故障排查

基础对话成功后,再按需配置:

下一步:项目与会话