• Mac: macOS 13（Ventura）以降（Apple Silicon / Intel両対応）。 Windows: Windows 10 バージョン 1809 以降、または Windows 11（64bit版）。
• Claude 有料アカウント: Proプラン等に加入済みであること。
• X アカウント: 段階2へ進む場合は X Premium 以上と X Developer アカウント。
• Git について: Claude Code 自体は Git がなくても動きますが、Windowsで check_hook.sh などの Bash スクリプトを動かす場合は Git Bash（Git for Windows）が必要になる場合があります（初期セットアップ段階では不要です）。

1. キーボードで CommandCtrl + Shift + P を押す。
2. display language と入力して Enter。
3. 一覧から「日本語 (ja)」を選び、再起動（Restart）する。

1. CommandCtrl + Shift + X を押す。
2. 検索欄に Claude Code と入力。
3. 発行元が「Anthropic」であることを確認し、「インストール」をクリック。

※ 拡張機能は内部でClaude Codeを動かしますが、システムのPATHに claude コマンドを追加するわけではありません（拡張機能だけでチャットやファイル作成は完結します）。

1. 星マークアイコンをクリック。
2. パネル内の「Sign in」をクリック。
3. ブラウザが自動で開くので、Claude アカウントでログインして承認する。

1. まず挨拶してみる：
   こんにちは。あなたに何ができるか、初心者向けに3つ教えて
2. 次に、実際にファイルを作ってもらう：
   買い物メモ.txt というファイルを作って、中に牛乳・卵・パン と書いておいて

1. ダウンロードした x_article_skills_generic.zip を展開（解凍）する。
2. 出てきた x_article_workspace フォルダを、そのままホームフォルダ直下に移動する。
3. VS Code を開き、「ファイル」→「フォルダーを開く」から x_article_workspace を選んで開く。
4. 「作成者を信頼しますか？」ダイアログが出たら、青いボタンの 「はい、作成者を信頼します」 をクリック。

1. 「LTS（推奨版）」のインストーラをダウンロードして実行（基本「Next」で進める。「Tools for Native Modules」のチェックは不要）。
2. インストール完了後、VS Code を一度閉じて開き直す。
3. ターミナルでバージョンを確認：

node --version

以下の依頼文を丸ごとコピーして、Claude Code パネルに貼り付けて送信します：

これから「X記事を Claude Code で自動で書く仕組み」を、このフォルダに設定します。
あなたが作業者、僕が答える側です。以下のルールで進めてください：
1. 「導入手順書.md」を読んで状況を把握してください。
2. 質問は1回に1つだけ。僕の回答を待ってから次へ進んでください。
3. まずは「段階1（記事の執筆とローカル検査）」を完了することを目標とします。
4. APIキーやパスワードなどの機密情報は、このチャットで尋ねないでください（後で僕がローカルで設定します）。
5. 外部への勝手な投稿や課金が発生する操作は、僕の明示的な指示があるまで行わないでください。
6. skills/ の中から「〔要記入」を探し、僕に質問しながら1つずつ埋めてください。

準備ができたら、まず僕のOS環境を確認した上で、最初の質問をしてください。

※ Mac の場合は、ターミナルで実行権限を付けておきます：

chmod +x skills/x_article_workflow/post_article.py skills/x_article_workflow/check_hook.sh

Claude Code に以下を依頼して確認します：

skills/ の中にまだ「〔要記入」が残っていないか検索して、残っていれば教えてください。なければ「すべて完了」と報告してください。

1. 既存のアプリ登録を確認する:
   ターミナルコピー

   npx -y @xdevplatform/xurl auth apps list

   ※ すでに xapi が登録されている場合は、次の登録手順（上書き）をスキップしてください。
2. 自作アプリを xurl に登録する:
   ステップ 8-8 で控えた Client ID と Client Secret を、引用符内のプレースホルダー（YOUR_CLIENT_ID / YOUR_CLIENT_SECRET）に当てはめて実行します。
   ⚠️ 重要（機密情報の保護）: Client Secret はパスワードと同じ秘密情報です。AIチャット欄に貼り付けたり、画面キャプチャを撮ったりせず、必ずご自身のPCのターミナルに直接入力してください。
   ターミナルコピー

   npx -y @xdevplatform/xurl auth apps add xapi --client-id "YOUR_CLIENT_ID" --client-secret "YOUR_CLIENT_SECRET"

3. デフォルトアプリに設定する:
   ターミナルコピー

   npx -y @xdevplatform/xurl auth default xapi

4. OAuth 2.0 認可を実行する:
   ターミナルコピー

   npx -y @xdevplatform/xurl auth oauth2 --app xapi

   ブラウザが開くので、記事を投稿したいXアカウントで「連携アプリを認証」をクリックします。
5. 本人アカウントであることを確認する（必須）:
   auth status はトークンの有効状態を示すだけです。実際に投入されるアカウント名を確認するため、必ず whoami を実行してください。
   ターミナルコピー

   npx -y @xdevplatform/xurl whoami

6. projects/.env の設定と一致確認:
   whoami で表示された自分のXアカウント名（@なし）を projects/.env の X_USER に記入します。書き込み前に双方が完全に一致していることを確認してください。
   projects/.envコピー

   X_USER=自分のXユーザー名

   ※ 新仕様ではスクリプト内のコードを書き換える必要はなく、この .env の X_USER が自動で投入先になります。

projects/.env に OPENAI_API_KEY を追記します：

X_USER=自分のXユーザー名
OPENAI_API_KEY=sk-...

1. 執筆テスト（段階1）:
   Claude Code に指示：
   「ネタ帳の IDEA-001 で1本書いて。投入はまだしないで」
   → outputs/x_articles/ に記事が保存されます。
2. ローカル検査（--check）:
   ターミナルで実行：
   
   ターミナル（仮想環境のPythonで実行）コピー

   ./.venv/bin/python.\.venv\Scripts\python.exe skills/x_article_workflow/post_article.py "outputs/x_articles/<記事ファイル名>.md" --check

   ※ --check によるローカル構文・ルール確認では、警告（⚠️ 🚨）が出ても終了コード 0 で完了することがあります。指摘された警告内容を確認して適宜修正してください。
3. 送信確認（--dry --thumb none）:
   
   ターミナルコピー

   ./.venv/bin/python.\.venv\Scripts\python.exe skills/x_article_workflow/post_article.py "outputs/x_articles/<記事ファイル名>.md" --dry --thumb none

   ※ --thumb none を付けることで画像生成の意図しない実行を防ぎます。送信予定JSONの先頭600文字が表示されます。
4. 下書き実投入（段階2の人・--post）:
   
   ターミナル（※記事下書きが作成されます）コピー

   ./.venv/bin/python.\.venv\Scripts\python.exe skills/x_article_workflow/post_article.py "outputs/x_articles/<記事ファイル名>.md" --post

   ※ --post 実行時には厳格なバリデーションが行われます。「4行以上（全角84字超）の段落」が残っていると終了コード 7 で停止し、CTA不一致エラーがあると終了コード 9 で安全に停止します。