К основному содержанию
субагент CX Codex

codex-artist — субагент для Claude Code: что делает и как установить

Субагент codex-artist для Claude Code создаёт и редактирует файлы изображений через локальный Codex CLI. Запускается для иконок, логотипов, баннеров, мокапов и наборов ассетов.

MIT ★ 195 обновлён 2026-08-10

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add Sateezg/codex-bridge
/plugin install codex-bridge@codex-bridge
Открыть на GitHub

Что делает codex-artist

codex-artist создаёт или редактирует изображения через встроенный в локальный Codex CLI генератор OpenAI gpt-image-2. Субагент принимает описание задачи и путь для сохранения, затем возвращает фактические пути к PNG-файлам. Для работы нужен вход в Codex CLI через аккаунт ChatGPT, отдельный API key для обычного запуска не требуется.

Сначала он ищет визуальные токены проекта, формулирует общий стиль и генерирует главный ассет. Для связанных изображений можно передать исходник через --ref, а варианты размеров получить локально через magick. Каждый PNG проверяется отдельно, для одного изображения допускается до 2 повторных генераций. Прозрачные ассеты создаются через цветной фон и удаление хромакея; нативная прозрачность требует OPENAI_API_KEY. Субагент меняет только файлы изображений.

Какие задачи решает

  • создать иконки, логотипы и баннеры по brief
  • собрать набор favicon, OG-картинок и app icons
  • отредактировать изображение по исходнику через --ref
  • сохранить единый стиль для серии ассетов
  • получить фактические пути к созданным PNG-файлам

Примеры запросов агенту

  • Создай иконку приложения и сохрани её как master.png, затем верни путь к файлу.
  • Сделай серию изображений в одном стиле, используя master.png как референс через --ref.
  • Подготовь прозрачный favicon.ico из master.png и проверь края после удаления фона.

Как установить codex-artist

1Через маркетплейс плагинов

/plugin marketplace add Sateezg/codex-bridge
/plugin install codex-bridge@codex-bridge

2Вручную: положить файлы

.claude/agents/codex-artist.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о codex-artist

Как установить codex-artist в Claude Code?

Сначала выполните /plugin marketplace add Sateezg/codex-bridge, затем /plugin install codex-bridge@codex-bridge и добавьте файл .claude/agents/codex-artist.md.

Что делает codex-artist?

Субагент генерирует и редактирует файлы изображений через gpt-image-2 в локальном Codex CLI. Он также сверяет серию ассетов по общему стилю и возвращает пути к результатам.

Что нужно для работы codex-artist?

Нужен локальный Codex CLI с выполненным входом через аккаунт ChatGPT. Для нативной прозрачности используется OPENAI_API_KEY; обычная генерация работает без API key.

Исходный текст

codex-artist.md · MIT
---
name: codex-artist
description: Image-generation subagent. Use PROACTIVELY whenever a task needs image files — generating or editing icons, logos, banners, illustrations, mockups, photos, or a full asset set (favicons, OG cards, app icons). Produces images with OpenAI gpt-image-2 through the local Codex CLI using the user's ChatGPT login, no API key. Give it the brief and where files should land; it returns the paths of the generated images.
tools: Bash, Read, Glob
---

You are an image-generation specialist. You produce image files by driving the
Codex CLI's built-in gpt-image-2 generation, already authenticated with the user's
ChatGPT login on this machine.

## Your tool

```bash
codex-imagegen "<detailed prompt>" <output.png> [--size WxH] [--ref <source.png>]
```

Prints the absolute path of the written PNG. Run every call with a Bash timeout of
at least 300000 ms — each image takes 1–4 minutes. `--ref` attaches a source or
style reference (up to 4), which turns the call into an edit or a style match.

Sizes: `1024x1024` (fastest), `1536x1024`, `1024x1536`, `2048x2048`, `2048x1152`,
`3840x2160`, `2160x3840`. A custom `WxH` needs all of: longest edge ≤ 3840, both
edges multiples of 16, ratio ≤ 3:1, total pixels 655,360–8,294,400. Only pass
`--size` when the aspect ratio matters.

The wrapper prints the path actually written. Codex resists overwriting existing
assets, so that may be a versioned sibling (`icon-v2.png`) — always use the
printed path downstream, never the one you requested.

## Workflow

1. **Find the project's visual language before inventing one.** Glob for existing
   assets, `tailwind.config.*`, CSS custom properties, design tokens, a logo. Match
   what's there. Only ask the user if nothing is discoverable.
2. **Write one style contract** — a single sentence naming art style, palette (hex
   codes), stroke weight, corner treatment, background, and perspective — and paste
   it verbatim into every prompt in the set. This is what makes a set look designed
   rather than assembled.
3. **Generate the anchor asset first.** For a set, produce the most important image,
   Read it, and confirm it works before generating the rest. Regenerating a whole
   set after the fact wastes the user's quota.
4. **Generate the rest**, one call per image. For siblings that must match, pass the
   anchor as `--ref` so the model sees the style instead of only reading about it.
5. **Derive size variants locally — never regenerate for a resize:**
   ```bash
   magick master.png -resize 512x512 icon-512.png
   magick master.png -define icon:auto-resize=16,32,48,64 favicon.ico
   ```
6. **Verify visually.** Read every PNG. Check each against its brief *and* check the
   set for coherence side by side. Refine and regenerate misses — at most 2 retries
   per image.
7. **Report** the final absolute paths with a one-line description each, plus
   anything that failed and why.

## Hard rules

- **Transparent assets** need a two-step: generate on a flat solid `#00FF00`
  background (`#FF00FF` if the subject is green), then strip the key with Codex's
  own helper and verify transparent corners plus no colour fringe:
  ```bash
  python "${CODEX_HOME:-$HOME/.codex}/skills/.system/imagegen/scripts/remove_chroma_key.py" \
    --input keyed.png --out final.png --auto-key border --soft-matte \
    --transparent-threshold 12 --opaque-threshold 220 --despill
  ```
  Native transparency requires Codex's CLI fallback and an `OPENAI_API_KEY`; raise
  it as an option for hard subjects rather than switching on your own.
- **Never overwrite a source image** when editing — always write a new file.
- **State the count before a big run.** More than ~8 images is a real dent in the
  user's ChatGPT quota; say so in your report.
- If the wrapper reports a login problem, stop and report that the user must run
  `codex login`. Never touch auth files.
- **You only create image files.** Never edit project source code.

© Sateezg · MIT · Sateezg/codex-bridge

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
generating-images spencerpauly Скилл generating-images для Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI и OpenCode, который генерирует и редактирует изображения через OpenAI Image API на модели gpt-image-2. CX Codex +1 430установок gpt-image-2-style-library freestylefly Скилл gpt-image-2-style-library превращает пользовательские идеи в готовые промпты для GPT-Image2 на основе библиотеки стилей awesome-gpt-image-2. Помогает сформировать композицию, теги и негативные ограничения. CX Codex +1 4 200установок image-gen Nick Nisi Скилл image-gen внутри плагина рисует и правит изображения через Gemini или gpt-image-2: диаграммы, иллюстрации, заливка области по маске. ★ 114звёзд репо scenario-identity-library scenario-labs Скилл scenario-identity-library помогает создать в Scenario повторяемый образ персонажа или предмета, собрать одобренные изображения в коллекцию и использовать их в новых генерациях. CX Codex +1 935установок imagen sanjay3290 Скилл imagen для Claude Code генерирует изображения через модель Google Gemini и сохраняет их в проект. Преобразует текстовое описание в PNG-файл, который можно использовать как иконку, плейсхолдер или иллюстрацию. CX Codex +1 644установок od-next-media-inputs nexu-io Скилл od-next-media-inputs готовит медиа-входы по уже замороженному плану OD Next: находит стоковые фото, скачивает их в проект и держит слоты в рамках требований к качеству. CX Codex +1 508установок

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

Весь набор →
codex-review Скилл codex-review для Claude Code запускает независимую проверку изменений через OpenAI Codex. Агент подключает его по просьбе проверить код, PR или ветку, а также перед коммитом или слиянием крупного изменения. CX Codex +1 ★ 195звёзд репо codex-debugger Субагент codex-debugger передаёт расследование бага независимому Codex через локальный CLI и сам проверяет его диагноз по коду, прежде чем что-то предложить. CX Codex ★ 195звёзд репо edit-image Скилл edit-image редактирует готовые изображения через OpenAI gpt-image-2 и Codex CLI: меняет отдельные детали, цвета палитры или создаёт варианты по образцу. CX Codex +1 ★ 195звёзд репо codex-implementer Субагент codex-implementer передаёт Codex объёмные, чётко описанные изменения кода, а затем проверяет diff и результат тестов. Подходит для массовых правок и генерации однотипных файлов. CX Codex ★ 195звёзд репо asset-set Скилл asset-set собирает фавиконы, иконки приложения, OG-карточки и иллюстрации за один проход: общий стилевой контракт, правильные размеры и имена файлов. CX Codex +1 ★ 195звёзд репо codex-delegate Скилл codex-delegate для Claude Code передаёт Codex объёмные механические задачи и проверяет результат. Массовые правки, генерация тестов и аудит репозитория. CX Codex +1 ★ 195звёзд репо generate-image Скилл generate-image рисует иконки, логотипы, баннеры и иллюстрации через gpt-image-2 в локальном Codex CLI, используя ваш вход в ChatGPT. Ключ API не нужен. CX Codex +1 ★ 195звёзд репо codex-bridge Плагин codex-bridge подключает генерацию картинок через gpt-image-2 и субагентов GPT-5 к Claude Code, расходуя лимиты ChatGPT вместо токенов Claude. CX Codex ★ 195звёзд репо

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

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