К основному содержанию
правило CX Codex

webgpu-renderer — правило для Claude Code: WebGPU и установка

Правило webgpu-renderer для Claude Code описывает подключение WebGPU-рендерера Three.js и запасной путь через WebGL 2. Показывает настройку 3D-сцен с вычислениями на GPU.

MIT ★ 4 719 обновлён 2026-10-24

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/webgpu-renderer.md
Открыть на GitHub

Что делает 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 и 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

Похожие правила IDE

Все правила IDE по теме «Фронтенд и UI» →
webgpu cazala Помогает проектировать, отлаживать и оптимизировать WebGPU-приложения и WGSL-шейдеры. Решает задачи рендера, вычислений и GPU-симуляций. CX Codex +1 886установок web-shader-extractor lixiaolin94 Скилл web-shader-extractor для Claude Code и Codex извлекает и локально воспроизводит WebGL-, WebGPU-, Canvas- и шейдерные эффекты со страниц. Разбирает анимированные фоны и интерактивную 3D-графику. CX Codex +1 850установок webgpu-threejs-tsl dgreenheck Скилл webgpu-threejs-tsl помогает писать Three.js-приложения с WebGPU, TSL-материалами, вычислительными шейдерами и постобработкой. CX Codex +1 1 800установок webgpu-claude-skill podo Учит агента рендерить Three.js через WebGPU: материалы на TSL, compute-шейдеры, постобработка и WGSL. Решает задачи GPU compute и авторских материалов. CX Codex +1 202установок threejs-animation CloudAI-X Скилл threejs-animation для работы с keyframe-анимацией, костями и морф-целями в Three.js. Помогает воспроизводить glTF-анимации, управлять костями скелета, миксировать и кроссфейдить клипы на WebGL и WebGPU. CX Codex +1 27 200установок threejs-shaders CloudAI-X Скилл threejs-shaders помогает писать кастомные GLSL-шейдеры и материалы для Three.js r186, настраивать униформы и переводить код на TSL для WebGPU. CX Codex +1 22 000установок

Из того же набора86

Весь набор →
shader-mobile Правило shader-mobile для Claude Code содержит приёмы оптимизации GLSL и Three.js шейдеров под мобильные GPU, помогающие избежать просадок FPS на смартфонах. CX Codex +1 ★ 4 719звёзд репо drei-use-gltf Правило drei-use-gltf для Claude Code задаёт загрузку GLTF-моделей через useGLTF с кэшированием и предварительной загрузкой. Используется в сценах на React Three Fiber. CX Codex +1 ★ 4 719звёзд репо perf-zustand-selectors Правило perf-zustand-selectors для ИИ-агента: подписка в компоненте идёт на отдельный срез Zustand-стора, поэтому перерисовка случается только при изменении нужных данных. CX Codex +1 ★ 4 719звёзд репо geometry-instanced-mesh Правило geometry-instanced-mesh задаёт использование THREE.InstancedMesh вместо отдельных мешей для рендеринга множества одинаковых 3D-объектов. CX Codex +1 ★ 4 719звёзд репо tsl-material-slots tsl-material-slots — правило для Claude Code со справочником слотов TSL в Three.js. Помогает настраивать шейдерную логику через узлы без ошибок в типах и именах свойств. CX Codex +1 ★ 4 719звёзд репо core-web-vitals Правило core-web-vitals для Claude Code: грузит модели и текстуры в 3D-сценах на Three.js так, чтобы LCP, FID и CLS не проседали. Не даёт тяжёлому 3D тормозить первую отрисовку. CX Codex +1 ★ 4 719звёзд репо postprocessing-optimization Правило postprocessing-optimization для Three.js и React Three Fiber. Помогает оптимизировать постобработку и объединять шейдерные проходы без просадок FPS. CX Codex +1 ★ 4 719звёзд репо timeline-builder Скилл timeline-builder для Claude Code превращает JSON-данные в интерактивную HTML-хронологию с вертикальной, горизонтальной или двусторонней раскладкой. Отображает этапы проекта, историю выпусков и резюме. CX Codex +1 ★ 4 719звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой