> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiji.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Desktop 常见问题

> 在 Claude Desktop 中使用吉吉API 时的常见问题。

配置步骤参考 [Claude Desktop 安装与配置](/claude-desktop/introduction)。

## 配置问题

<AccordionGroup>
  <Accordion title="菜单里找不到 Developer">
    需要先开启开发者模式：「Help → Troubleshooting → Enable Developer Mode」。开启后应用会重启，重启后才会出现「Developer」菜单。
  </Accordion>

  <Accordion title="配置窗口是只读的">
    说明电脑上已存在企业管理员下发的配置，个人无法修改，请联系你的 IT 管理员。
  </Accordion>

  <Accordion title="模型列表为空或缺少模型">
    在配置窗口左上角「Search settings」中搜索 `models`，手动添加需要的模型 ID，然后点击「Apply Changes」。可用的模型 ID 以 [模型广场](https://www.jiji.cc/extension/models) 为准。
  </Accordion>

  <Accordion title="和 Claude Code 的配置有什么关系">
    两者互不影响。Claude Desktop 不读取 `~/.claude/settings.json`，Claude Code 命令行需要按 [Claude Code 安装与配置](/claude-code/introduction) 单独配置。
  </Accordion>
</AccordionGroup>

## 错误排查

<AccordionGroup>
  <Accordion title="提示 401 或认证失败">
    * 确认 API Key 已完整复制，没有多余空格
    * 确认 Key 所在分组包含 Claude 模型，账户余额充足
    * 确认「Gateway auth scheme」为 `bearer`
    * 确认请求地址为 `https://www.jiji.cc`，没有加 `/v1`
  </Accordion>

  <Accordion title="Test connection 失败或返回 403">
    在同一页向下滚动到「Custom inference headers」，点击「+ Add」添加一个请求头，然后重新测试：

    | 名称 | 值 |
    | - | - |
    | `User-Agent` | `claude-cli/2.1.280 (external, claude-desktop-3p, agent-sdk/0.3.280)` |
  </Accordion>

  <Accordion title="连接超时或无法访问">
    检查本机网络，关闭代理工具后点击「Test connection」重试。
  </Accordion>
</AccordionGroup>

## 仍未解决？

<Card title="提交工单" icon="headset" href="https://www.jiji.cc/extension/tickets">
  以上方法都无法解决时，请提交工单联系我们
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.