jpskill.com
📦 その他 コミュニティ

auto-claude-setup

Auto-ClaudeをWSL、Windows、Linux、macOSといった様々な環境にインストールしたり、開発環境を構築したりする際の手順や、発生する問題の解決を支援するSkill。

📜 元の英語説明(参考)

Complete Auto-Claude installation and setup guide for all platforms. Use when installing Auto-Claude on WSL, Windows, Linux, or macOS, setting up development environment, or troubleshooting installation issues.

🇯🇵 日本人クリエイター向け解説

一言でいうと

Auto-ClaudeをWSL、Windows、Linux、macOSといった様々な環境にインストールしたり、開発環境を構築したりする際の手順や、発生する問題の解決を支援するSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o auto-claude-setup.zip https://jpskill.com/download/9360.zip && unzip -o auto-claude-setup.zip && rm auto-claude-setup.zip
🪟 Windows (PowerShell)
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/9360.zip -OutFile "$d\auto-claude-setup.zip"; Expand-Archive "$d\auto-claude-setup.zip" -DestinationPath $d -Force; ri "$d\auto-claude-setup.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して auto-claude-setup.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → auto-claude-setup フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

Auto-Claude セットアップ

Auto-Claude 自律型コーディングフレームワークの完全なインストールと環境設定を行います。

クイックスタート

前提条件

要件 バージョン 注記
Python 3.12+ バックエンドと Memory Layer に必要
Node.js 24+ フロントエンドに必要
npm 10+ パッケージマネージャー
Git 最新 バージョン管理
Claude Pro/Max 有効 サブスクリプションが必要
Claude Code CLI 最新 npm install -g @anthropic-ai/claude-code

インストール方法

方法 1: プリビルドされたリリース (推奨)

GitHub Releases からダウンロードしてください:

プラットフォーム ダウンロード
Windows Auto-Claude-2.7.2.exe
macOS (Apple Silicon) Auto-Claude-2.7.2-arm64.dmg
macOS (Intel) Auto-Claude-2.7.2-x64.dmg
Linux (Universal) Auto-Claude-2.7.2.AppImage
Linux (Debian) Auto-Claude-2.7.2.deb

方法 2: ソースから (開発)

# リポジトリをクローン
git clone https://github.com/AndyMik90/Auto-Claude.git
cd Auto-Claude

# すべての依存関係をインストール
npm run install:all

# 開発モードで実行
npm run dev

# またはビルドして実行
npm start

プラットフォーム固有のセットアップ

WSL2 (Windows Subsystem for Linux)

# 1. WSL2 が更新されていることを確認
wsl --update

# 2. Python 3.12 をインストール
sudo apt update && sudo apt install -y python3.12 python3.12-venv python3.12-dev

# 3. Node.js 24+ を nvm 経由でインストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 24
nvm use 24

# 4. クローンしてセットアップ
git clone https://github.com/AndyMik90/Auto-Claude.git
cd Auto-Claude
npm run install:all

# 5. OAuth トークンをセットアップ
claude setup-token

Windows (ネイティブ)

# 1. Python 3.12 をインストール
winget install Python.Python.3.12

# 2. Node.js 24 をインストール
winget install OpenJS.NodeJS.LTS

# 3. Claude Code CLI をインストール
npm install -g @anthropic-ai/claude-code

# 4. クローンしてセットアップ
git clone https://github.com/AndyMik90/Auto-Claude.git
cd Auto-Claude
npm run install:all

Linux (Ubuntu/Debian)

# 1. Python 3.12 をインストール
sudo apt update
sudo apt install -y python3.12 python3.12-venv python3.12-dev

# 2. Node.js 24 を NodeSource 経由でインストール
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs

# 3. Claude Code CLI をインストール
sudo npm install -g @anthropic-ai/claude-code

# 4. クローンしてセットアップ
git clone https://github.com/AndyMik90/Auto-Claude.git
cd Auto-Claude
npm run install:all

macOS

# 1. Homebrew をインストール (インストールされていない場合)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. Python 3.12 と Node.js をインストール
brew install python@3.12 node@24

# 3. Claude Code CLI をインストール
npm install -g @anthropic-ai/claude-code

# 4. クローンしてセットアップ
git clone https://github.com/AndyMik90/Auto-Claude.git
cd Auto-Claude
npm run install:all

認証設定

OAuth トークンの設定

# OAuth トークンを生成 (認証のためにブラウザが開きます)
claude setup-token

# トークンは以下に保存されます:
# - macOS: Keychain
# - Windows: Credential Manager
# - Linux: ~/.config/claude/credentials

環境設定

apps/backend/.env を例から作成します:

cd apps/backend
cp .env.example .env

必須の設定:

# OAuth トークン (キーチェーンを使用しない場合)
CLAUDE_CODE_OAUTH_TOKEN=your-oauth-token-here

オプションの設定:

# モデルのオーバーライド (デフォルト: claude-opus-4-5-20251101)
AUTO_BUILD_MODEL=claude-opus-4-5-20251101

# デフォルトの git ブランチ
DEFAULT_BRANCH=main

# デバッグモード
DEBUG=true
DEBUG_LEVEL=2

# Linear 連携
LINEAR_API_KEY=lin_api_xxxxx

# メモリシステム (Graphiti)
GRAPHITI_ENABLED=true
GRAPHITI_LLM_PROVIDER=openai
OPENAI_API_KEY=sk-xxxxx

検証

インストールのテスト

# Python のバージョンを確認
python3 --version  # 3.12+ である必要があります

# Node.js のバージョンを確認
node --version  # 24+ である必要があります

# Claude Code CLI を確認
claude --version

# バックエンドをテスト
cd apps/backend
source .venv/bin/activate  # または Windows では .venv\Scripts\activate
python run.py --help

# フロントエンドをテスト
cd apps/frontend
npm run dev

最初のタスクを実行

cd apps/backend
source .venv/bin/activate

# スペックをインタラクティブに作成
python spec_runner.py --interactive

# またはタスクの説明とともに
python spec_runner.py --task "Add a hello world endpoint"

プロジェクト構成

Auto-Claude/
├── apps/
│   ├── backend/           # Python CLI とエージェント
│   │   ├── agents/        # エージェントの実装
│   │   ├── core/          # クライアント、認証、セキュリティ
│   │   ├── prompts/       # エージェントのシステムプロンプト
│   │   ├── spec/          # スペック作成パイプライン
│   │   ├── .env           # あなたの設定
│   │   └── run.py         # メインのエントリーポイント
│   └── frontend/          # Electron デスクトップ UI
├── guides/                # ドキュメント
├── tests/                 # テストスイート
└── scripts/               # ビルドユーティリティ

よくある問題

Windows: node-gyp エラー

Visual Studio Build Tools をインストールします:

  1. Visual Studio Build Tools 2022 をダウンロード
  2. "C++ によるデスクトップ開発" ワークロードを選択
  3. "MSVC v143 - VS 2022 C++ x64/x86 Spectre 緩和ライブラリ" を追加
  4. ターミナルを再起動して npm install を再度実行

Python のバージョンの不一致

# どの Python が使用されているかを確認
which python3
python3 --version

# 特定の Python バージョンで venv を作成
python3.12 -m venv .venv

OAuth トークンの問題

# トークン設定を再実行
claude setup-token

# トークンが設定されていることを確認
echo $CLAUDE_CODE_OAUTH_TOKEN

# Claude Code が動作しているか確認
claude --version

関連スキル

  • auto-claude-cli: コア CLI 操作
  • auto-claude-spec: スペック作成ワークフロー
  • auto-claude-memory: メモリシステムの設定
  • auto-claude-troubleshooting: デバッグガイド

参考文献

  • [Offi
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Auto-Claude Setup

Complete installation and environment setup for the Auto-Claude autonomous coding framework.

Quick Start

Prerequisites

Requirement Version Notes
Python 3.12+ Required for backend and Memory Layer
Node.js 24+ Required for frontend
npm 10+ Package manager
Git Latest Version control
Claude Pro/Max Active Subscription required
Claude Code CLI Latest npm install -g @anthropic-ai/claude-code

Installation Methods

Method 1: Pre-built Release (Recommended)

Download from GitHub Releases:

Platform Download
Windows Auto-Claude-2.7.2.exe
macOS (Apple Silicon) Auto-Claude-2.7.2-arm64.dmg
macOS (Intel) Auto-Claude-2.7.2-x64.dmg
Linux (Universal) Auto-Claude-2.7.2.AppImage
Linux (Debian) Auto-Claude-2.7.2.deb

Method 2: From Source (Development)

# Clone repository
git clone https://github.com/AndyMik90/Auto-Claude.git
cd Auto-Claude

# Install all dependencies
npm run install:all

# Run in development mode
npm run dev

# Or build and run
npm start

Platform-Specific Setup

WSL2 (Windows Subsystem for Linux)

# 1. Ensure WSL2 is updated
wsl --update

# 2. Install Python 3.12
sudo apt update && sudo apt install -y python3.12 python3.12-venv python3.12-dev

# 3. Install Node.js 24+ via nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 24
nvm use 24

# 4. Clone and setup
git clone https://github.com/AndyMik90/Auto-Claude.git
cd Auto-Claude
npm run install:all

# 5. Setup OAuth token
claude setup-token

Windows (Native)

# 1. Install Python 3.12
winget install Python.Python.3.12

# 2. Install Node.js 24
winget install OpenJS.NodeJS.LTS

# 3. Install Claude Code CLI
npm install -g @anthropic-ai/claude-code

# 4. Clone and setup
git clone https://github.com/AndyMik90/Auto-Claude.git
cd Auto-Claude
npm run install:all

Linux (Ubuntu/Debian)

# 1. Install Python 3.12
sudo apt update
sudo apt install -y python3.12 python3.12-venv python3.12-dev

# 2. Install Node.js 24 via NodeSource
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs

# 3. Install Claude Code CLI
sudo npm install -g @anthropic-ai/claude-code

# 4. Clone and setup
git clone https://github.com/AndyMik90/Auto-Claude.git
cd Auto-Claude
npm run install:all

macOS

# 1. Install Homebrew (if not installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. Install Python 3.12 and Node.js
brew install python@3.12 node@24

# 3. Install Claude Code CLI
npm install -g @anthropic-ai/claude-code

# 4. Clone and setup
git clone https://github.com/AndyMik90/Auto-Claude.git
cd Auto-Claude
npm run install:all

Authentication Setup

OAuth Token Configuration

# Generate OAuth token (opens browser for authentication)
claude setup-token

# Token is saved to:
# - macOS: Keychain
# - Windows: Credential Manager
# - Linux: ~/.config/claude/credentials

Environment Configuration

Create apps/backend/.env from the example:

cd apps/backend
cp .env.example .env

Required Configuration:

# OAuth token (if not using keychain)
CLAUDE_CODE_OAUTH_TOKEN=your-oauth-token-here

Optional Configuration:

# Model override (default: claude-opus-4-5-20251101)
AUTO_BUILD_MODEL=claude-opus-4-5-20251101

# Default git branch
DEFAULT_BRANCH=main

# Debug mode
DEBUG=true
DEBUG_LEVEL=2

# Linear integration
LINEAR_API_KEY=lin_api_xxxxx

# Memory system (Graphiti)
GRAPHITI_ENABLED=true
GRAPHITI_LLM_PROVIDER=openai
OPENAI_API_KEY=sk-xxxxx

Verification

Test Installation

# Check Python version
python3 --version  # Should be 3.12+

# Check Node.js version
node --version  # Should be 24+

# Check Claude Code CLI
claude --version

# Test backend
cd apps/backend
source .venv/bin/activate  # or .venv\Scripts\activate on Windows
python run.py --help

# Test frontend
cd apps/frontend
npm run dev

Run First Task

cd apps/backend
source .venv/bin/activate

# Create a spec interactively
python spec_runner.py --interactive

# Or with a task description
python spec_runner.py --task "Add a hello world endpoint"

Project Structure

Auto-Claude/
├── apps/
│   ├── backend/           # Python CLI and agents
│   │   ├── agents/        # Agent implementations
│   │   ├── core/          # Client, auth, security
│   │   ├── prompts/       # Agent system prompts
│   │   ├── spec/          # Spec creation pipeline
│   │   ├── .env           # Your configuration
│   │   └── run.py         # Main entry point
│   └── frontend/          # Electron desktop UI
├── guides/                # Documentation
├── tests/                 # Test suite
└── scripts/               # Build utilities

Common Issues

Windows: node-gyp Errors

Install Visual Studio Build Tools:

  1. Download Visual Studio Build Tools 2022
  2. Select "Desktop development with C++" workload
  3. Add "MSVC v143 - VS 2022 C++ x64/x86 Spectre-mitigated libs"
  4. Restart terminal and run npm install again

Python Version Mismatch

# Check which Python is being used
which python3
python3 --version

# Create venv with specific Python version
python3.12 -m venv .venv

OAuth Token Issues

# Re-run token setup
claude setup-token

# Verify token is set
echo $CLAUDE_CODE_OAUTH_TOKEN

# Check Claude Code is working
claude --version

Related Skills

  • auto-claude-cli: Core CLI operations
  • auto-claude-spec: Spec creation workflow
  • auto-claude-memory: Memory system configuration
  • auto-claude-troubleshooting: Debugging guide

References