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

# 在 Kilo Code 中使用 LithosAI

> 通过 OpenAI 兼容的自定义 provider，把 Kilo Code 直接接入 LithosAI。

## 开始之前

在 VS Code 中安装 Kilo Code，或者使用它的 CLI。然后在 [API Key](https://console.lithosai.cloud/keys?lang=zh) 页面创建 key，并在 [模型](https://console.lithosai.cloud/models?lang=zh) 页面选择模型。

选择你使用的界面：

<Tabs>
  <Tab title="VS Code">
    <Steps>
      <Step title="配置 LithosAI">
        打开 **Settings → Providers → Custom provider**，填写：

        | 设置项 | 值 |
        | - | - |
        | Provider ID | `lithosai` |
        | Display name | `LithosAI` |
        | Provider API | **OpenAI Compatible** |
        | Base URL | `https://api.lithosai.cloud/v1` |
        | API key | 你的 LithosAI API key |
        | Models | 从 [LithosAI 模型列表](https://console.lithosai.cloud/models?lang=zh)中添加或选择 ID，例如 `moonshotai/Kimi-K3-fast` |
      </Step>

      <Step title="保存 provider">
        点击 **Submit** 保存 provider。之后就能在聊天的模型选择器里选到它配置的模型。

        在 **Global Config** 中，按你的模型设置 `limit.context` 和 `limit.output`。
      </Step>
    </Steps>

    **推理强度**

    <Accordion title="VS Code 推理强度配置">
      打开 **Global Config**，把下面这些字段合并到 `provider.lithosai.models` 下你的模型条目里，即可启用 **low**、**high** 和 **max**，默认为 **high**：

      ```json theme={null}
      {
        "reasoning": true,
        "options": { "reasoningEffort": "high" },
        "variants": {
          "low": { "reasoningEffort": "low" },
          "high": { "reasoningEffort": "high" },
          "max": { "reasoningEffort": "max" },
          "medium": { "disabled": true },
          "minimal": { "disabled": true },
          "xhigh": { "disabled": true }
        }
      }
      ```
    </Accordion>
  </Tab>

  <Tab title="CLI">
    <Steps>
      <Step title="设置 API key">
        把你的 key 设为环境变量：

        ```bash theme={null}
        export LITHOSAI_API_KEY="your-key"
        ```
      </Step>

      <Step title="配置 LithosAI">
        下面的配置以 `moonshotai/Kimi-K3-fast` 为例。

        把它合并到 `~/.config/kilo/kilo.jsonc`，并按你的模型设置 token 上限。一定要写在这个全局配置文件里：在不受信任的项目文件中，`{env:...}` 形式的凭据不会被解析。

        <Accordion title="Kilo CLI 配置">
          ```json ~/.config/kilo/kilo.jsonc theme={null}
          {
            "$schema": "https://app.kilo.ai/config.json",
            "model": "lithosai/moonshotai/Kimi-K3-fast",
            "provider": {
              "lithosai": {
                "npm": "@ai-sdk/openai-compatible",
                "name": "LithosAI",
                "options": {
                  "baseURL": "https://api.lithosai.cloud/v1",
                  "apiKey": "{env:LITHOSAI_API_KEY}"
                },
                "models": {
                  "moonshotai/Kimi-K3-fast": {
                    "name": "moonshotai/Kimi-K3-fast",
                    "reasoning": true,
                    "limit": {
                      "context": 32768,
                      "output": 4096
                    },
                    "options": { "reasoningEffort": "high" },
                    "variants": {
                      "low": { "reasoningEffort": "low" },
                      "high": { "reasoningEffort": "high" },
                      "max": { "reasoningEffort": "max" },
                      "medium": { "disabled": true },
                      "minimal": { "disabled": true },
                      "xhigh": { "disabled": true }
                    }
                  }
                }
              }
            }
          }
          ```
        </Accordion>

        要添加其他模型或速度档位，复制 `provider.lithosai.models` 下的条目，再对照[模型列表](https://console.lithosai.cloud/models?lang=zh)修改它的 key 和 `name`。调整 token 上限和支持的推理强度，然后重新打开 Kilo。
      </Step>

      <Step title="开始对话">
        运行 `kilo`。在当前对话里，用 `/models` 在已配置的模型之间切换。
      </Step>
    </Steps>

    **推理强度**

    用 `/variants` 选择 **low**、**high** 或 **max**，默认为 **high**。
  </Tab>
</Tabs>

所有 Agent 都会遇到的问题见[常见问题](/zh/agent-integrations#常见问题)。

## 参考资料

* [Kilo Code 文档](https://kilo.ai/docs/ai-providers/openai-compatible)
* [LithosAI 模型列表](https://console.lithosai.cloud/models?lang=zh)


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