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本体の挙動とは独立した参考情報です。
下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。
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
$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. 下の青いボタンを押して
auto-claude-setup.zipをダウンロード - 2. ZIPファイルをダブルクリックで解凍 →
auto-claude-setupフォルダができる - 3. そのフォルダを
C:\Users\あなたの名前\.claude\skills\(Win)または~/.claude/skills/(Mac)へ移動 - 4. Claude Code を再起動
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
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 をインストールします:
- Visual Studio Build Tools 2022 をダウンロード
- "C++ によるデスクトップ開発" ワークロードを選択
- "MSVC v143 - VS 2022 C++ x64/x86 Spectre 緩和ライブラリ" を追加
- ターミナルを再起動して
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:
- Download Visual Studio Build Tools 2022
- Select "Desktop development with C++" workload
- Add "MSVC v143 - VS 2022 C++ x64/x86 Spectre-mitigated libs"
- Restart terminal and run
npm installagain
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