webgpu-renderer — правило для Claude Code: WebGPU и установка
Правило webgpu-renderer для Claude Code описывает подключение WebGPU-рендерера Three.js и запасной путь через WebGL 2. Показывает настройку 3D-сцен с вычислениями на GPU.
MIT ★ 4 719 обновлён 2026-10-24
.claude/rules/webgpu-renderer.mdЧто делает webgpu-renderer
Правило описывает настройку WebGPURenderer из three/webgpu: после создания нужно вызвать await renderer.init() до первого рендера. Для тяжёлых вычислительных сцен оно советует использовать renderAsync, а для проверки запасного режима — включать forceWebGL: true.
Внутри есть примеры проверки navigator.gpu, возможностей адаптера, GPU-буферов через instancedArray, storage textures, общей памяти workgroup и indirect draws. Также разобраны перенос физики и отбора объектов на compute shaders, группировка часто меняющихся uniform и отладка в Chrome WebGPU DevTools.
Поддержка зависит от браузера: Chrome и Edge требуют v113+, Firefox — v141+ на Windows или v145+ на macOS ARM, Safari — v26+. В старых версиях Firefox нужны флаги, поэтому без проверки окружения WebGPU может перейти на WebGL 2.
Какие задачи решает
- подключить
WebGPURendererв Three.js - переключить сцену на асинхронный рендеринг
- проверить доступность WebGPU и функции адаптера
- перенести части физики на compute shaders
- протестировать WebGL 2 fallback
Примеры запросов агенту
- Подключи
WebGPURendererизthree/webgpuи добавь инициализацию до первого рендера. - Проверь доступность WebGPU через
navigator.gpuи сделай fallback на WebGL 2. - Покажи, как перенести обновление частиц на
instancedArrayи compute shaders.
Как установить webgpu-renderer
Вручную: положить файлы
.claude/rules/webgpu-renderer.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/webgpu-renderer.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/webgpu-renderer.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/webgpu-renderer.mdВручную: положить файлы
.clinerules/webgpu-renderer.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о webgpu-renderer
Как установить webgpu-renderer в Claude Code?
Добавьте правило в файл .claude/rules/webgpu-renderer.md в проекте.
Что делает webgpu-renderer?
Правило даёт агенту инструкции по настройке WebGPU в Three.js, асинхронному рендерингу, compute shaders и переходу на WebGL 2 при отсутствии WebGPU.
Какие браузеры поддерживает настройка webgpu-renderer?
Для Chrome и Edge нужна версия v113+, для Firefox — v141+ на Windows или v145+ на macOS ARM, для Safari — v26+. В старых версиях Firefox требуются флаги.
Исходный текст
webgpu-renderer.md · MIT
# WebGPU Renderer
> Source: [100 Three.js Tips - Utsubo](https://www.utsubo.com/blog/threejs-best-practices-100-tips)
WebGPU is the next-generation graphics API. Three.js provides zero-config WebGPU with automatic WebGL 2 fallback.
## Setup
```javascript
import { WebGPURenderer } from 'three/webgpu';
const renderer = new WebGPURenderer();
await renderer.init(); // Required before first render
function animate() {
renderer.render(scene, camera);
requestAnimationFrame(animate);
}
animate();
```
## Browser Support Matrix
| Browser | Version | Notes |
|---------|---------|-------|
| Chrome/Edge | v113+ | Full support |
| Firefox | v141+ (Windows), v145+ (macOS ARM) | Requires flags in older versions |
| Safari | v26+ (September 2025) | WebKit support |
## Key Tips
### 1. Use `renderAsync` for Compute-Heavy Scenes
```javascript
async function animate() {
await renderer.renderAsync(scene, camera);
requestAnimationFrame(animate);
}
```
Ensures compute passes complete before dependent render passes.
### 2. Force WebGL for Testing
```javascript
const renderer = new WebGPURenderer({ forceWebGL: true });
```
Useful for testing fallback behavior and debugging shader differences.
### 3. Feature Detection
```javascript
const adapter = await navigator.gpu?.requestAdapter();
if (!adapter) return; // Fallback to WebGL
const hasFloat32Filtering = adapter.features.has('float32-filterable');
const hasTimestamps = adapter.features.has('timestamp-query');
```
### 4. GPU-Persistent Buffers with `instancedArray`
```javascript
import { instancedArray } from 'three/tsl';
const positions = instancedArray(particleCount, 'vec3');
const velocities = instancedArray(particleCount, 'vec3');
```
CPU-based particle updates plateau around 50,000 particles; compute shaders enable millions.
### 5. Storage Textures for Read-Write Compute
```javascript
import { storageTexture, textureStore, uvec2 } from 'three/tsl';
const outputTexture = new StorageTexture(width, height);
const store = textureStore(outputTexture, uvec2(x, y), computedColor);
```
### 6. Workgroup Shared Memory
```javascript
import { workgroupArray, workgroupBarrier } from 'three/tsl';
const sharedData = workgroupArray('float', 256);
sharedData.element(localIndex).assign(inputData);
workgroupBarrier();
```
Shared memory operates 10-100x faster than global memory.
### 7. Indirect Draws for GPU-Driven Rendering
Let GPU determine what renders based on compute shader output, enabling frustum culling on GPU.
## When to Migrate to WebGPU
Prioritize migration when hitting performance walls in:
- Draw-call-heavy scenes
- Complex particle systems (>50k particles)
- Compute-intensive effects
- Complex shader pipelines
Expect 2-10x performance gains in these specific scenarios.
## Best Practices
1. **Minimize buffer updates per frame** - Batch multiple small updates into single operations
2. **Group frequently-updated uniforms** - WebGPU batches resources into bind groups; separate static from dynamic data
3. **Use compute shaders for physics** - Move CPU-bound physics to GPU compute
4. **Debug with Chrome WebGPU DevTools** - Enable "WebGPU Developer Features" in chrome://flags
© zebbern · MIT · zebbern/claude-code-guide