diff --git a/docs-tech/codebuff-local-oneliner/banner.png b/docs-tech/codebuff-local-oneliner/banner.png
new file mode 100644
index 0000000..b6e6616
Binary files /dev/null and b/docs-tech/codebuff-local-oneliner/banner.png differ
diff --git a/docs-tech/codebuff-local-oneliner/index.md b/docs-tech/codebuff-local-oneliner/index.md
new file mode 100644
index 0000000..81979c9
--- /dev/null
+++ b/docs-tech/codebuff-local-oneliner/index.md
@@ -0,0 +1,51 @@
+---
+sidebar_position: 2
+title: Codebuffをローカル展開するワンライナー
+description: OpenRouter + Codebuffをローカル環境に最短で導入する手順
+hide_table_of_contents: false
+displayed_sidebar: null
+image: /img/codebuff-local-oneliner-banner.png
+---
+
+# Codebuffをローカル展開するワンライナー
+
+Codebuffを手元マシンでサクッと使えるようにするための最短手順です。
+
+## 前提
+
+- Node.js 18+
+- `OPENROUTER_API_KEY` を取得済み
+
+## ワンライナー
+
+```bash title="セットアップ一発実行"
+export OPENROUTER_API_KEY="sk-or-xxx" && curl -sL https://www.techswan.online/scripts/codebuff-local-setup.sh | bash
+```
+
+特定のプロジェクトディレクトリを指定する場合は以下:
+
+```bash title="プロジェクト指定"
+export OPENROUTER_API_KEY="sk-or-xxx" && curl -sL https://www.techswan.online/scripts/codebuff-local-setup.sh | bash -s -- ~/my-project
+```
+
+## 何をしているか
+
+1. `npm i -g codebuff`
+2. プロジェクトへ移動
+3. `/init` 実行（`knowledge.md` と `.agents` を生成）
+4. `codebuff` 起動準備
+
+## 使い方のコツ
+
+- 初回は「まずプロジェクトの構造を説明して」から始める
+- 次に「小さな修正」を頼んで挙動を掴む
+- いきなり大改修より、段階的に指示した方が安定
+
+## 参考リンク
+
+- [Codebuff GitHub](https://github.com/CodebuffAI/codebuff)
+- [OpenRouter Models](https://openrouter.ai/models)
+
+---
+
+*この記事は2026年3月時点の情報です。*
diff --git a/docs-tech/index.md b/docs-tech/index.md
index 2d492b6..d024f63 100644
--- a/docs-tech/index.md
+++ b/docs-tech/index.md
@@ -23,6 +23,7 @@ slug: /
 ## その他
 
 - [ローカルサーバーでマイク・カメラを使う方法](/tech/browser-secure-context/)
+- [Codebuffをローカル展開するワンライナー](/tech/codebuff-local-oneliner/)
 - [ゲーム画面をリアルタイム翻訳するAIアプリを作った話](/tech/game-vision-companion/)
-- [ローカルGitea × Webhook連携で、AIとの開発をもっと楽にしよう！](/tech/gitea-webhook-ai-review/)
+- [Issue 立てるだけで AI がコードレビュー＆修正してくれる仕組みを作った](/tech/gitea-webhook-ai-review/)
 - [SearXNGでローカル検索APIを構築する](/tech/searxng-local-search/)
diff --git a/static/scripts/codebuff-local-setup.sh b/static/scripts/codebuff-local-setup.sh
new file mode 100755
index 0000000..36425a9
--- /dev/null
+++ b/static/scripts/codebuff-local-setup.sh
@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if ! command -v npm >/dev/null 2>&1; then
+  echo "[ERROR] npm が見つかりません。Node.js 18+ をインストールしてください" >&2
+  exit 1
+fi
+
+if [ -z "${OPENROUTER_API_KEY:-}" ]; then
+  echo "[ERROR] OPENROUTER_API_KEY が未設定です" >&2
+  echo "例: export OPENROUTER_API_KEY=\"sk-or-...\"" >&2
+  exit 1
+fi
+
+echo "[1/4] codebuff をインストール"
+npm install -g codebuff
+
+echo "[2/4] プロジェクトへ移動"
+PROJECT_DIR="${1:-$PWD}"
+cd "$PROJECT_DIR"
+
+echo "[3/4] codebuff 初期化 (/init)"
+# 既存設定がある場合はスキップ
+if [ ! -f "knowledge.md" ] && [ ! -d ".agents" ]; then
+  printf "/init\n" | codebuff || true
+fi
+
+echo "[4/4] 起動"
+cat <<MSG
+
+✅ セットアップ完了
+
+次に実行:
+  codebuff
+
+おすすめ最初の指示:
+  - "プロジェクト構成を把握して改善提案して"
+  - "テストを実行して失敗原因を直して"
+
+MSG