|

open-design 完全入門ガイド:3ステップで構築するオープンソースAI画像生成システム(19のスキルを詳細解説)

作者注:open-design は Anthropic Claude Design のオープンソース代替案です。本記事では、初心者の方に向けて 19 のスキルと 71 のデザインシステムを備えたアーキテクチャの原理、インストール手順、および Claude API の設定方法を網羅的に解説します。

GitHub で最近、デザイン界隈の注目を集めているオープンソースプロジェクト「open-design」が登場しました。これは Anthropic Claude Design の「オープンソース版代替」と呼ばれており、ローカルデプロイ、19 種類の組み込みスキル、71 種類のブランド級デザインシステムを特徴としています。

これは単なる AI のラッパーツールではありません。 開発者向けに設計された完全なフレームワークであり、すでにインストール済みの CLI(Claude Code、Codex、Cursor、Gemini CLI など)を通じてデザイン生成を駆動できます。Apache-2.0 ライセンスで提供されており、ローカル実行だけでなく Vercel へのデプロイも可能です。

核心的価値: 本記事を読めば、open-design のアーキテクチャ、19 のスキルの能力、そして Claude API 中継サービス(APIYI apiyi.com など)を活用して、スムーズにワークフローを構築する方法が理解できます。

open-design-tutorial-guide-ja 图示

一、open-design とは:オープンソース Claude Design 代替案の 3 つの核心的ポジショニング

open-design は nexu-io チームによって開発された、ローカル優先(Local-first)、Vercel デプロイ可能、スキル駆動型のデザイン生成プラットフォームです。最大の特徴は、AI エージェントを内蔵していないことであり、エージェントの実行はPCにインストール済みの CLI ツールに委ねるという点です。

1.1 open-design の核心的ポジショニング

比較項目 open-design の特徴 Claude Design との差異
実行モード ローカル優先 + Vercel デプロイ可 Claude Design はオンラインホスティングのみ
エージェントのソース ローカル CLI(Claude Code/Codex 等)を再利用 Claude Design は Opus に強く依存
ライセンス Apache-2.0 オープンソース クローズドソースの商用製品
スキル数 19 のファイルベーススキル 非公開の独自スキル(拡張不可)
デザインシステム 71 のブランド級デザインシステム デザインシステムは非公開
APIキー BYOK(自分のキーを持ち込み) 公式課金

1.2 なぜ open-design が初心者に注目されているのか

AI 支援デザインの分野に初めて触れる方にとって、open-design は Claude Design よりも「透明性」の高い選択肢を提供します。

  • コードが完全オープンソース:ワークフローの細部まで把握でき、二次開発が容易
  • ベンダーロックインなし:Anthropic、OpenAI、Google のモデルを自由に切り替え可能
  • 追加サブスクリプション不要:Claude Code などの CLI に既に課金している場合、Claude Design を別途契約する必要はありません
  • BYOK 対応:APIYI(apiyi.com)のような Claude API 中継サービスに接続することで、コスト管理や同時実行管理をより柔軟に行えます

💡 初心者へのアドバイス:Claude API を使ったことがない場合は、まず APIYI(apiyi.com)に登録して統一 API キーを取得してから open-design のデプロイを開始することをお勧めします。これにより、Anthropic 公式アカウントの作成、カード登録、海外決済といった煩雑なプロセスを省略できます。

1.3 open-design はどのようなユーザーに適しているか

  • 個人開発者:デザイナーを雇わずに、製品のランディングページ、ダッシュボード、モバイルプロトタイプを作成したい方
  • プロダクトマネージャー(PM):プロトタイプ、PRD ドキュメント、ロードマップの可視化を素早く行いたい方
  • 技術ブロガー:高品質なカバー画像、比較画像、インフォグラフィックを生成したい方
  • デザイナー:AI を活用して、繰り返し作業(メールテンプレート、請求書、カンバンなど)を効率化したい方

二、open-design 核心特性:19 Skills + 71 Design Systems 详解

open-design 的核心架构由两个抽象层组成:Skills(能力)Design Systems(视觉风格)。19 + 71 的组合理论上可以产生超过 1300 种“能力 × 风格”组合。

open-design-tutorial-guide-ja 图示

2.1 19 个内置 Skills 全景

open-design 的 19 个 Skills 按用途分为三大类:

设计交付类(8 个 Skills)

Skill 名称 用途 输出格式
web-prototype 单页 HTML 落地页 HTML
saas-landing SaaS 营销页面 HTML
dashboard 后台管理界面 HTML
pricing-page 定价页面 HTML
docs-page 三栏文档页 HTML
blog-post 长篇博客内容 HTML/Markdown
mobile-app 移动 App 屏幕 HTML + 设备框
simple-deck 简洁横向幻灯片 HTML

演示类(2 个 Skills)

  • guizang-ppt:杂志风格 Web PPT(默认演示模式)
  • magazine-poster:印刷品和海报设计

办公文档类(9 个 Skills)

包含 PM 规范文档(PRD)、周报、会议纪要、工程 Runbook、财务报表、HR Onboarding、发票、Kanban 看板、OKR 评分卡等。

2.2 71 套 Design Systems 分类

71 套品牌级设计系统按行业分类如下:

分类 代表品牌 风格特点
AI / LLM Claude、Cohere、Mistral、ElevenLabs、Ollama 简洁、技术感、低饱和
开发者工具 Cursor、Vercel、Linear、Framer、Supabase 暗色主题、等宽字体、高对比
生产力 Notion、Figma、Miro、Airtable、Cal 友好、白底、圆润元素
金融 Stripe、Coinbase、Binance、Wise 信任感、蓝色基调、专业
电商 / 出行 Shopify、Airbnb、Uber、Nike、Starbucks 视觉冲击、品牌色突出
媒体 Spotify、PlayStation、Wired、The Verge 编辑感、大图、强对比
汽车 Tesla、BMW、Ferrari、Lamborghini 高级感、金属质感、留白
基础风格 Default Neutral、Warm Editorial 通用底色

🎯 使用建议:新人无需一开始就尝试所有 Skills,建议先从 web-prototypesaas-landing 入手,搭配 Default Neutral 设计系统,跑通完整流程后再探索其他组合。如果遇到 Claude API 调用频繁的问题,可以使用 APIYI (apiyi.com) 的 API 中継服务,避免官方接口的速率限制。

2.3 五大视觉方向(Visual Direction)

如果你没有现成的品牌资产,open-design 提供 5 种预设视觉方向:

  1. Editorial:Monocle / FT 风格,印刷杂志感,暖色重点强调
  2. Modern Minimal:Linear / Vercel 风格,冷峻、结构化、克制
  3. Tech Utility:高密度信息、等宽字体、终端感
  4. Brutalist:粗犷、超大字体、锐利、无阴影
  5. Soft Warm:宽松、低对比、桃色中性色

每种方向都锁定了 OKLch 配色方案和字体栈,确保 AI 生成的结果不会“飘”。

三、open-design 快速上手:3 步完成本地部署

3.1 系统环境要求

部署 open-design 前请确认本地环境:

依赖项 版本要求 说明
Node.js ~24 推荐使用 nvm 管理
pnpm 10.33.x 通过 corepack 启用
Git 任意 用于克隆仓库
至少一个 CLI Agent Claude Code / Codex / Cursor 等 见下文兼容列表

3.2 三步完成安装

第一步:克隆仓库

git clone https://github.com/nexu-io/open-design.git
cd open-design

第二步:启用 pnpm 并安装依赖

corepack enable
pnpm install

第三步:启动本地服务

pnpm tools-dev run web

启动后会自动完成:

  1. 扫描 PATH 环境变量,识别可用的 Agent CLI
  2. 加载全部 19 个 Skills 和 71 套 Design Systems
  3. 创建 .od/ 运行目录(包含 SQLite、projects、artifacts)
  4. 在浏览器打开 Web 界面

3.3 验证安装是否成功

打开浏览器访问 http://localhost:3000,应该能看到:

  • ✅ 顶部显示 Agent 选择器(已识别的 CLI 列表)
  • ✅ 左侧 Skill 选择器(19 个 Skill 卡片)
  • ✅ 右侧 Design System 选择器(71 个品牌)
  • ✅ 中间是初始化表单(Discovery Form)

如果某个 CLI 没有被识别,确认它是否已加入系统 PATH。

# 检查 CLI 是否可用
which claude
which codex
which cursor-agent

四、open-design 配合 Claude API:BYOK 配置完整指南

新人最容易卡住的环节往往是 API Key 配置。open-design 的 BYOK(Bring Your Own Key)模式支持两种方式调用 Claude 模型:通过 Claude Code CLI、或者直接走 Anthropic API SSE。

open-design-tutorial-guide-ja 图示

4.1 为什么需要 Claude API 中转服务

直接使用 Anthropic 官方 API 时,新人常遇到三个问题:

  1. 海外支付门槛:需要美元信用卡,国内 Visa/Master 经常被拒
  2. 速率限制严苛:新账号 Tier 1 每分钟 token 限制极低,复杂 Skill 容易触发
  3. 并发能力有限:当 open-design 同时处理多个 Skill 任务时,官方接口经常报 429

这时使用专业的 Claude API 中转服务(如 APIYI apiyi.com)可以一次性解决这三个问题,下面给出具体配置方法。

4.2 通过环境变量接入 APIYI(推荐)

open-design 的 Daemon 在调用 Anthropic API 时会读取标准的 Anthropic SDK 环境变量。在启动前,先配置好 ANTHROPIC_BASE_URLANTHROPIC_API_KEY

# macOS / Linux
export ANTHROPIC_BASE_URL="https://vip.apiyi.com"
export ANTHROPIC_API_KEY="sk-your-apiyi-key-here"

# Windows PowerShell
$env:ANTHROPIC_BASE_URL = "https://vip.apiyi.com"
$env:ANTHROPIC_API_KEY = "sk-your-apiyi-key-here"

# 启动 open-design
pnpm tools-dev run web

🎯 关键说明ANTHROPIC_BASE_URL 是 Anthropic 官方 SDK 支持的标准变量。APIYI apiyi.com 完全兼容 Anthropic 原生格式,所以无需修改任何代码,只要替换 base_url 即可让 open-design 透明地走中转通道。

4.3 配合 Claude Code CLI 使用

如果你已经安装了 Claude Code CLI,open-design 默认会优先使用它。在使用前,先把 Claude Code 自身指向 APIYI:

# 配置 Claude Code 使用 APIYI 中转
claude config set api-url https://vip.apiyi.com
claude config set api-key sk-your-apiyi-key-here

# 验证连接
claude --version
claude "你好" --max-tokens 100

配置完成后,open-design 调用 Claude Code 时会自动复用这套配置,不需要在 open-design 内额外设置。

4.4 APIYI 接入 vs 官方直连:完整对比

对比维度 Anthropic 官方 APIYI 中转 (apiyi.com)
支付方式 海外信用卡(美元) 国内充值(人民币)
价格 标准价 充值 100 美金送 10%(≈ 官网 85 折)
速率限制 Tier 1 严苛限制 不限并发
API 格式 Anthropic 原生 完全兼容 Anthropic 原生
接入难度 需修改 base_url 修改 base_url 即可
故障切换 单一通道 多机房负载均衡
技术支持 英文工单 中文客服

4.5 验证 API 配置是否生效

在 open-design Web 界面创建一个测试项目,选择最简单的 web-prototype Skill,输入プロンプト:"Create a simple landing page for a coffee shop",观察终端日志:

  • ✅ 看到 Connecting to https://vip.apiyi.com/v1/messages 表示走中转
  • ✅ 响应时间 < 5 秒(APIYI 中转通常比官方更快)
  • ✅ 没有 429 / 529 错误

如果出现连接失败,检查环境变量是否正确导出(可用 echo $ANTHROPIC_BASE_URL 验证)。

五、open-design 実践シナリオ:5つの典型的な応用事例

5.1 シナリオ1:個人開発者によるSaaSランディングページの作成

目標:3時間以内に公開可能なSaaS製品のランディングページを作成する

操作フロー

  1. open-designで saas-landing Skillを選択
  2. Design Systemで Linear または Vercel スタイルを選択
  3. Discovery Formに製品のポジショニング(ターゲット層、セールスポイント、価格帯)を入力
  4. AgentがHTMLを自動生成(Hero、Features、Pricing、CTAを含む)
  5. ZIPをエクスポートし、Vercelにデプロイ

API利用量の目安:1回の生成で約30-50Kの入力トークン + 8-15Kの出力トークンを消費します。5回繰り返して調整する場合、合計で約25万トークンを消費します。APIYI(apiyi.com)を利用して、繰り返し調整にかかるコストを抑えることをお勧めします。

5.2 シナリオ2:PMによるPRD(製品要求仕様書)の迅速な作成

目標:要件の記述に基づき、構造化されたPRDを自動生成する

操作フロー

  1. オフィスドキュメント系のSkill(PM仕様書)を選択
  2. Design Systemで Notion スタイルを選択
  3. 要件のポイントと制約を入力
  4. Agentが背景、目標、ユーザーストーリー、AC(受け入れ基準)、技術案を含む完全なPRDを生成
  5. MarkdownまたはHTMLとしてエクスポート

5.3 シナリオ3:技術ブロガーによるカバー画像の作成

目標:ブログ記事用に統一されたスタイルのカバー画像を生成する

操作フロー

  1. magazine-poster Skillを選択
  2. Design Systemで Wired または The Verge を選択
  3. 記事のテーマとキーワードを入力
  4. ビジュアルの方向性(Editorial / Brutalist / Soft Warm)を調整
  5. PNGとしてエクスポート

5.4 シナリオ4:モバイルアプリのプロトタイプ検証

目標:1日以内に5画面分のモバイルアプリプロトタイプを作成する

操作フロー

  1. mobile-app Skillを選択
  2. Device Frameで iPhone 15 Pro を選択
  3. Design Systemで Spotify または Airbnb を選択
  4. 画面ごとに生成(ホーム、リスト、詳細、設定、オンボーディング)
  5. フロントエンドの参考用にHTMLをエクスポート

5.5 シナリオ5:データダッシュボードのデザイン

目標:業務データ項目に基づき、インタラクティブなダッシュボードプロトタイプを生成する

操作フロー

  1. dashboard Skillを選択
  2. Design Systemで Stripe または Vercel を選択
  3. データ項目とグラフの種類の好みを入力
  4. Agentがサイドバー、KPIカード、グラフ、テーブルを含む完全なダッシュボードを生成

💡 シナリオ共通のアドバイス:上記の5つのシナリオはいずれも繰り返しの調整を伴い、その都度Claude APIの呼び出しが発生します。open-designをAPIYI(apiyi.com)に接続することをお勧めします。これにより、15%オフのコストメリットを享受できるだけでなく、並行処理制限なしの特性を活かして複数のSkillタスクを同時に実行できます。


六、open-design よくある質問(FAQ)

Q1: open-design と Claude Design の決定的な違いは何ですか?

決定的な違いはAgentの実行方式です。Claude DesignはAnthropicのクローズドなSaaS製品であり、Opusモデルに強く依存しています。一方、open-designはオープンソースプロジェクトであり、AgentはローカルのCLI(Claude Code、Codex、Cursorなど)から提供されます。言い換えれば、Claude Designは「製品」であり、open-designは「フレームワーク」です

すでにClaude Codeをサブスクリプションしているか、APIYI(apiyi.com)のAPIキーをお持ちであれば、open-designは実質的に追加コストゼロで利用できる選択肢となります。

Q2: Anthropicの公式アカウントを持っていませんが、open-designは使えますか?

全く問題ありません。open-designは任意のCLI Agentをサポートしており、Anthropic APIの使用を強制しません。一般的な代替案は以下の通りです:

  • Cursor Agentを使用する(Cursorサブスクリプションに含まれる)
  • Gemini CLIを使用する(Googleの無料枠)
  • OpenCode または Qwen Code を使用する
  • APIYI(apiyi.com)が提供するClaude API中継サービスを使用する(初心者におすすめ)

APIYIは日本円での決済に対応しており、海外アカウント作成の手間を省けるため、国内の開発者にとって非常に使いやすいサービスです。

Q3: 19種類のSkillsのうち、初心者がまず試すべきものは?

「習得のしやすさ + 出力の価値の高さ」の順で、以下の順序を推奨します:

  1. web-prototype – 最も簡単、1ページのHTML
  2. saas-landing – 実用性が高く、製品に直接利用可能
  3. simple-deck – PPTの代替、5分でプレゼン資料を作成
  4. dashboard – データ可視化の練習に最適
  5. mobile-app – モバイルレイアウトの学習

オフィスドキュメント系(PRDや週報など)も非常に実用的ですが、プロンプトの微調整が必要になります。

Q4: 71種類のDesign Systemsは固定ですか?カスタマイズは可能ですか?

自由に追加・拡張可能です。Design Systemsの本質は DESIGN.md ファイルであり、9つのセクションからなるスキーマに従っています。以下の手順で行えます:

  1. design-systems/ ディレクトリに新しいフォルダを作成(ブランド名など)
  2. DESIGN.md を作成し、配色、フォント、間隔、コンポーネントスタイルを記述
  3. デーモンを再起動すると、新しいデザインシステムがセレクターに自動的に表示されます

このようなファイルベースの拡張性は、Claude Designにはないopen-designの核心的な強みです。

Q5: open-design を使うとAPIトークンを大量に消費しますか?

消費しますが、制御可能です。各Skillのプロンプトスタックは比較的長く(システムプロンプトで約5-10Kトークン)、出力を含めると1回の生成で約20-40Kトークンを消費します。

コストを抑える方法:

  • APIYI(apiyi.com)の中継サービスを利用し、チャージ時のボーナス(実質約15%オフ)を活用する
  • OpusではなくClaude Sonnet 3.5/4.5を優先的に使用する(コストパフォーマンスが5倍以上高い)
  • Claudeのネイティブ機能であるプロンプトキャッシングを活用する(APIYIは完全対応)

Q6: open-design は日本語のプロンプトをサポートしていますか?

完全サポートしています。open-design自体はプロンプトのオーケストレーションフレームワークであり、最終的な日本語の理解能力は選択したモデルに依存します。Claude Sonnet 4.5やOpus 4.7は日本語のサポートが非常に優れており、「国潮風(中国の伝統スタイル)」や「サイバーパンク」といったデザインの文脈も正確に理解します。

Q7: Vercelにデプロイした後、ローカルで .od ディレクトリにアクセスできますか?

できません。Vercelはサーバーレスアーキテクチャであり、永続的なファイルシステムを持ちません。Vercelへのデプロイが必要な場合は、ハイブリッドモードを推奨します。Web層はVercelにデプロイし、デーモンはローカルまたは自前のサーバーで実行し、トンネル(Cloudflare Tunnelなど)を通じてVercelのWeb層に公開する方法です。

Q8: open-design の「Anti-AI-Slop(AI臭さ排除)」メカニズムは何をしていますか?

open-designのプロンプトスタックには、6つの「AI臭さ」を防ぐメカニズムが組み込まれています:

  1. 初期化フォームの強制:最初のステップで必ず要件を収集し、即時の生成を禁止
  2. ブランド資産5ステッププロトコル:ポジショニング → ダウンロード → カラー抽出 → brand-specへの書き込み → 確認
  3. 5次元自己評価:生成前にAI自身がスコアリングを行う(哲学、階層、実行、具体性、抑制)
  4. P0/P1/P2チェックリスト:各Skillに強制的なチェック項目を設定
  5. AI Slopブラックリスト:グラデーション、汎用的な絵文字、角丸の左ボーダーカード、架空のデータの使用を明示的に禁止
  6. 誠実なプレースホルダー:捏造されたデータの代わりに やグレーのブロックを使用

このメカニズムこそが、一般的なAIデザインツールとopen-designを分かつ核心的な壁となっています。

七、open-design Key Takeaways 核心要点

  • open-design はオープンソースの Claude Design 代替案:Apache-2.0 ライセンスを採用し、ローカル優先かつ Vercel へのデプロイが可能です。
  • 中核となる構成:19種類のスキル(Skills)と71種類のデザインシステム(Design Systems)で構成され、1300通り以上の「能力 × スタイル」の組み合わせが可能です。
  • エージェント実行:ローカル CLI を再利用し、Claude Code、Codex、Cursor、Gemini CLI、OpenCode、Qwen などをサポートしています。
  • 3ステップでローカルデプロイ:リポジトリのクローン → pnpm installpnpm tools-dev run web を実行するだけです。
  • BYOK 設定:必要な環境変数は ANTHROPIC_BASE_URLANTHROPIC_API_KEY の2つだけです。
  • 初心者への推奨:APIYI(apiyi.com)のAPI中継サービスを活用しましょう。ネイティブフォーマット互換、無制限の同時接続に対応しており、100ドルのチャージで10%のボーナスが付与されます。
  • Anti-AI-Slop メカニズム:6重の「AIっぽさ」排除設計により、高品質なアウトプットを保証します。

八、まとめ

open-design は、過小評価されているオープンソースプロジェクトの一つです。Claude Design のように「AIデザイナー」として大々的に宣伝するのではなく、スキル + デザインシステム + エージェントオーケストレーション を組み合わせた実用的なフレームワークとして位置づけられています。この「ツールとしての本質」が、プロのエンジニア層から迅速に支持を得ている理由です。

初心者にとって open-design を使い始める際の最大の障壁は技術面ではなく、API の設定です。この障壁を最も簡単に乗り越える方法は、APIYI(apiyi.com)のようなプロフェッショナルな Claude API 中継サービスを利用することです。ネイティブフォーマットとの完全互換によりコードを一行も変更する必要がなく、国内決済に対応しているため海外クレジットカードも不要です。また、同時接続が無制限であるため、open-design のマルチスキルワークフローを安心して実行できます。さらに、100ドルのチャージで10%のボーナスが付与されるため、実質的に公式サイトの価格から約15%オフで利用できる計算になります。

AI を活用したデザインワークフローの導入を検討しているなら、open-design と APIYI(apiyi.com)の組み合わせは、日本の開発者にとって現在最もフレンドリーな選択肢です。今日からデプロイを始めれば、1時間以内に最初のスキルを動かすことができるでしょう。

🎯 次のステップ:APIYI(apiyi.com)にアクセスしてアカウントを作成し、APIキーを取得してください。本記事の第4章に従って環境変数を設定し、BYOK 接続を完了させましょう。まずは web-prototype スキルでフローを試し、その後、他の18種類のスキルの可能性を順次探索してみてください。

参考資料

  1. open-design GitHub リポジトリ: プロジェクトのメインリポジトリ

    • リンク: github.com/nexu-io/open-design
    • 説明: 完全なソースコード、19個のスキル、71種類のデザインシステムを収録
  2. Anthropic 公式ドキュメント: Claude API 利用ガイド

    • リンク: docs.anthropic.com/claude/docs
    • 説明: APIパラメータ、プロンプト構造、モデル比較
  3. APIYI 公式サイト: Claude API 中継サービスプラットフォーム

    • リンク: apiyi.com
    • 説明: ネイティブフォーマット互換、同時接続数無制限、人民元でのチャージ対応、100ドル以上のチャージで10%ボーナス付与

著者: 技術チーム
最終更新: 2026-04-30
APIYIについて: APIYI (apiyi.com) は、プロフェッショナルなClaude API中継サービスプロバイダーです。Claude Sonnet 4.5やClaude Opus 4.7を含む全シリーズのモデルへの安定した接続を提供し、Anthropicのネイティブフォーマットでの呼び出しをサポートしています。100ドルのチャージで10%のボーナス(公式サイト比で約15%オフに相当)が付与され、同時接続数は無制限。技術サポートの迅速な対応も強みです。

類似投稿