> For the complete documentation index, see [llms.txt](https://docs.allout.game/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.allout.game/all-out-docs/docs-zh/jiao-ben-bian-xie/cursor-claude-antigravity-setup.md).

# Cursor/Claude/Antigravity 设置

你可以用任何文本编辑器编写 CSL，但使用带有 CSL 工具支持的编辑器会有很大不同：语法高亮、行内错误、自动补全和快速导航。

借助集成了 AI 智能体的工具，上手也比以往更加容易，这些工具可以帮助你学习和编写 CSL。

你将编写 `.csl` 文件，放在你项目的 `scripts/` 目录中。

## 1. 使用智能体面板

如果你想要最简单的设置，请使用 All Out 编辑器内置的 AI 智能体面板。

使用智能体面板只需要拥有一种行业标准的 AI 订阅。我们目前支持：

* OpenAI/ChatGPT Codex
* Claude Code
* OpenCode

无论你使用内置的智能体面板还是直接使用第三方智能体，编辑器都会向你的游戏文件夹中添加一些项目文件，为智能体提供更好的上下文：

* `AGENTS.md` 和 `CLAUDE.md` ，其中包含有关 All Out 和 CSL 的信息
* `.agents/skills/` 和 `.claude/skills/` 包含引擎特定的工作流
* `api_references/` 包含当前 CSL API，格式为 `.csl_engine` 文件
* `.mcp.json`, `.cursor/mcp.json`, `.codex/config.toml`，以及 `opencode.json` 以便受支持的工具可以连接到编辑器进行编译和获取资源

## 2. 第三方智能体

{% tabs %}
{% tab title="安装 Cursor（程序员）" %}
我们建议使用 Cursor（或 VS Code）来开发 All Out 游戏。我们的编辑器扩展提供：

* 语法高亮支持
* 行内编译错误诊断
* 自动补全

1. [下载并安装 Cursor](https://cursor.com/)
2. [安装 All Out CSL 扩展](https://marketplace.cursorapi.com/items/?itemName=AllOutGames.csl-language-tools)
3. 在 Cursor 中打开你的游戏项目文件夹（包含 `scripts/` 和 `res/`)

{% hint style="info" %}
All Out 会自动向你的项目中添加一些文件，以帮助为 AI 提供上下文：

* `AGENTS.md` 和 `CLAUDE.md` ，其中包含有关 All Out 和 CSL 的信息
* `.agents/skills/` 和 `.claude/skills/` 包含引擎特定的工作流
* `api_references/` 包含当前 CSL API，格式为 `.csl_engine` 文件
* `.mcp.json`, `.cursor/mcp.json`, `.codex/config.toml`，以及 `opencode.json` 用于编辑器访问
  {% endhint %}
  {% endtab %}

{% tab title="安装 Claude Code（非程序员）" %}
如果你没有太多编程经验，或者更喜欢使用 Claude Code，我们也为它提供了原生支持。

Claude Code 是一款 AI 工具，可以为你编写和调试 CSL 脚本。

1. [下载并安装 Claude Code](https://code.claude.com/docs/en/overview)
2. 在你的游戏项目文件夹中打开一个终端并输入 `claude` 以使用你的 Claude 账号登录。

{% hint style="warning" %}
即使你使用 AI 模型，花一点 **时间** 先对 CSL 脚本有一个基础了解也很有帮助。这样你就能更高效地指导 AI，并快速做出调整。而且，这很有趣！
{% endhint %}

{% hint style="info" %}
All Out 会自动向你的项目中添加一些文件，以帮助为 AI 提供上下文：

* `AGENTS.md` 和 `CLAUDE.md` ，其中包含有关 All Out 和 CSL 的信息
* `.agents/skills/` 和 `.claude/skills/` 包含引擎特定的工作流
* `api_references/` 包含当前 CSL API，格式为 `.csl_engine` 文件
* `.mcp.json`, `.cursor/mcp.json`, `.codex/config.toml`，以及 `opencode.json` 用于编辑器访问
  {% endhint %}
  {% endtab %}

{% tab title="Antigravity" %}
Antigravity 是 Google 版的 Cursor，如果你更偏好 Google 生态系统，它会是一个不错的替代选择。它确实需要额外的一些设置才能让 MCP 服务器正常工作。

1. [下载并安装 Antigravity](https://antigravity.google/download)
2. 在 Antigravity 中安装 All Out 扩展
3. 手动配置 All Out MCP 服务器

**MCP 服务器设置**

<figure><img src="/files/f51d1c2a9ddc61576f6b123bcfc4c5bb0bd36842" alt="Antigravity MCP settings"><figcaption></figcaption></figure>

<figure><img src="/files/a74d25990c3fac49ea6d4f20f880ba12a3588400" alt="Antigravity raw MCP configuration"><figcaption></figcaption></figure>

然后把这段内容粘贴到原始配置中。使用写入项目的端口 `.mcp.json`:

```json
{
    "mcpServers": {
        "allout": {
            "serverUrl": "http://localhost:3333/mcp"
        }
    }
}
```

如果编辑器选择了其他端口，请将 `3333` 替换为该值。

{% hint style="info" %}
All Out 会自动向你的项目中添加一些文件，以帮助为 AI 提供上下文：

* `AGENTS.md` 和 `CLAUDE.md` ，其中包含有关 All Out 和 CSL 的信息
* `.agents/skills/` 和 `.claude/skills/` 包含引擎特定的工作流
* `api_references/` 包含当前 CSL API，格式为 `.csl_engine` 文件
* `.mcp.json`, `.cursor/mcp.json`, `.codex/config.toml`，以及 `opencode.json` 用于编辑器访问
  {% endhint %}
  {% endtab %}
  {% endtabs %}

{% hint style="warning" %}
如果 Windows 构建速度很慢，请在更改杀毒软件设置之前先进行测量。只排除能解决问题的、最小范围内受信任的项目路径或生成路径。参见 [Windows Defender 排除项](/all-out-docs/docs-zh/can-kao/windows-defender-exclusion.md).
{% endhint %}