连接 AI 应用

在 Mac 和 Windows 上，Claude Code 或 Claude Desktop 等 AI 应用可以在你于 Pyxen 中打开的项目里工作：阅读你的代码、检查代码、运行游戏进行测试，并修改它。每处修改都会在发生时显示在 Pyxen 中，你也可以撤销。

连接 AI 应用是 Mac 和 Windows 上 Pyxen 完整许可的一部分。在你打开它之前，它一直处于关闭状态。

打开它

打开 Pyxen › 设置…（在 Windows 上为 编辑 › 设置…），选择 AI，然后打开 允许这台电脑上的 AI 应用使用 Pyxen。状态一行会显示当前情况：正在等待 AI 应用，有应用与 Pyxen 通信后显示 已连接到 …。

只有在此设置打开且 Pyxen 处于打开状态时，Pyxen 才会等待连接。关闭它，所有连接都会断开。

将 Pyxen 添加到你的 AI 应用

设置 › AI 会为你拷贝已填好所有内容的设置。

Claude Code

选择 拷贝 Claude Code 命令。
将命令粘贴到终端（在 Windows 上为 PowerShell 或 Windows 终端）并按下 Return 键。它会在你工作的每个文件夹中将 Pyxen 添加到 Claude Code。
在 Claude Code 中，/mcp 会列出 pyxen 及其工具。
问它一个关于游戏的问题：“给 Pyxen 中打开的游戏加上二段跳，并测试一下。”

Claude Desktop

选择 拷贝 Claude Desktop 设置。
在 Claude Desktop 中打开 Settings › Developer › Edit Config，将这些行粘贴到文件中。如果文件中已有服务器，请把 pyxen 部分添加在旁边。
退出 Claude Desktop 并重新打开。

Claude Desktop 会自行启动 Pyxen 来连接你打开的应用，因此文件中不包含令牌。请保持 Pyxen 打开并打开此设置。

其他 AI 应用

通过地址连接的应用：选择 拷贝地址和令牌，把地址和令牌提供给应用，令牌以 Authorization: Bearer … 发送。只能以命令方式启动服务器的应用：像 Claude Desktop 的设置那样，提供 Pyxen 本身并在后面加上 --mcp。

应用第一次连接时

在 Mac 上，AI 应用第一次要在你的项目中工作时，Pyxen 会在自己的窗口中问你：Claude 想在 Pyxen 中工作，并列出它将能做的事。选择允许，Pyxen 会记住，之后不再询问这个应用。选择 不允许，应用会得知你拒绝了；它下次连接时会再次询问。询问会等你两分钟，之后会让应用稍后再试。如果 Pyxen 在其他应用后面，它在程序坞中的图标会跳动。

在 Windows 上，Pyxen 还不会询问：你设置好的应用在设置打开后立即连接。

AI 应用可以做什么

列出你的项目：按 Pyxen 主页显示的样子列出，并在任意已打开的项目中工作。未指定时，它在最前面的窗口中工作。要打开一个已关闭的项目，它会先询问你：Claude 想打开 Bat Cave，并提供打开和 不打开。项目会在你的窗口后面的窗口中打开，你可以继续在原处输入。选择 在此会话中允许 后，它在断开连接前可以打开其他项目而无需再次询问。
阅读：你的文件、项目设置以及脚本使用的组件。
检查：用 Pyxen Script 检查器检查代码。未通过检查的代码绝不会写入：应用会收到行号和原因，然后重试。
运行游戏：在没有窗口的情况下运行，按帧输入按键和鼠标移动，并读取任意帧的控制台、实体，以及按预览的方式绘制的该帧画面。你在预览中运行的游戏不会被暂停或改动。
查看游戏：按预览此刻显示的样子查看，或查看 Pyxen 保留的任意一帧。
回溯时间：像时间旅行调试器一样，逐帧浏览你的游戏和它自己运行的最近 300 帧，并比较修改前后的运行。你的预览停留在你选择的那一帧。
搜索：搜索参考、手册和代码片段，按照 Pyxen 的方式编写 Pyxen Script。
修改：修改脚本、项目设置和素材包，并添加文件。
添加机制，并修改它们的设置。

在 Windows 上，它只在 Pyxen 窗口中打开的项目里工作：还不能打开已关闭的项目。

关注它在做什么

在 Mac 上，当某个应用在项目中工作时，该窗口的工具栏会显示 Claude · 工作中 和停止。点按名称可打开助手面板：它做的每一步（读取了 main.py、已检查：没有问题、单独运行：90 帧），以及它做的每处更改，连同它更改的文件和行。

它的修改会在进行时进入你的项目。显示被修改文件的代码面板会立即显示修改，在该面板中使用 编辑 › 撤销（Ctrl+Z）即可撤回。正在运行的游戏会显示 代码已更改 · 重新加载。

撤销。 在它更改之后，编辑 › 撤销 Claude 的更改（⌘Z）会一步撤回整处更改，涉及它改动的每个文件；改动多个文件时，Pyxen 会先询问。你编辑之后，⌘Z 又会撤销你自己的编辑。
助手面板中的还原可以撤回它的任意一处更改，只要你之后没有编辑过这些文件。应用会知道你还原了它。
工具栏或助手面板中的停止会拒绝它在这个项目中的后续请求，并告诉它先问你再继续。当你再向它提出新的请求时，它会在下一轮重新工作。

在 Windows 上，工具栏中的名称、助手面板和“撤销 Claude 的更改”还没有提供。

更改项目前先询问。 在 Mac 上，想在任何东西改变之前先做决定，就打开 设置 › AI › 更改项目前先询问（默认关闭）。应用的更改会作为一个提议在助手面板中等待：一项更改在等你确认，并列出它要改的文件和行。在你决定之前，项目保持原样，应用则读取和运行它的提议。接受会把它作为一项更改放进项目，你可以像其他更改一样撤销或还原；拒绝会丢弃它，应用也会知道。如果你在此期间编辑了它的某个文件，就只剩拒绝：请让应用再做一次。

AI 应用不能做什么

它只在 Pyxen 窗口中打开的项目里工作。它绝不会接触项目以外的文件、网络、Pyxen 自己的设置或你的许可。在 Mac 上，已关闭的项目只列出名称：在你允许打开之前，它不会被读取。在 Windows 上，只列出已打开的项目。

你的隐私

连接只在你的电脑上进行：Pyxen 只在这台电脑上等待连接，每个请求都需要令牌，来自网页的请求会被拒绝。在 Windows 上，令牌的保存方式让只有你的 Windows 帐户可以读取它。Pyxen 不会向我们发送任何内容。你向 AI 应用提出的请求遵循其自身条款。

设置 › AI 中的 新令牌 会生成新令牌，并断开使用旧令牌的应用。之后 Claude Code 需要新的命令；Claude Desktop 的设置仍可继续使用。

提示

修改之后，请让 AI 应用 运行游戏并查看结果。它可以在若干帧内按住按键、读取物体的位置并查看该帧的画面，能发现大多数错误。
Pyxen 适用于任何 AI 模型，能力越强的模型效果越好。
连接 AI 应用在 Mac 上提供，需要完整许可。