An Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault

Claudian – Obsidian 内の AI 搭載コーディングアシスタント

概要 – Claudian は、さまざまな LLM ベースのコーディングエージェント（Claude Code、Codex、Grok Build、OpenCode、Pi、DeepSeek Harness など）とボールトから直接対話できる Obsidian コミュニティプラグインです。ボールトがエージェントの作業ディレクトリになるため、モデルはファイルの読み取り、書き込み、検索、シェルコマンドの実行、多段階ワークフローの実行ができます。

主な機能

機能	説明
インライン編集	テキストを選択（またはカーソルを置く）してホットキーを押すと、エージェントがノートをその場で編集し、単語レベルの差分プレビューを表示します。
Zen モード	チャット UI がノート下部のコンパクトなコンポーザーに折りたたまれ、執筆に集中できます。
スラッシュコマンドとスキル	`/` または `$` を入力して、再利用可能なプロンプトテンプレート（スキル）を挿入します。スキルはボールトまたはユーザーにスコープできます。
@メンション	プロンプト内で他のボールトファイル、フォルダー、以前の Claudian セッションを参照します。
サイドチャット (`/side` または `/btw`)	メインチャットを妨げずに実験用の一時的なサイド会話を開きます。
MCP サーバー	各プロバイダーのネイティブ「Managed Client Protocol」設定を通じて外部ツールを接続します。
タブとセッションマネージャー	複数のチャットタブ、シングルペインまたはデュアルペインレイアウト、永続的なセッション管理。
コラボレーション	別のプラグイン（Claudian Collab）がリアルタイムのマルチユーザー編集を追加します。

サポートされているエージェント（プロバイダー）

Claude Code (Anthropic)
Codex (OpenAI)
Grok Build (xAI)
OpenCode (v2、v1 は 2026 年 10 月に非推奨)
Pi (Earendil Works)
DeepSeek Harness

使用するプロバイダーに対応する CLI または API サブスクリプションが必要です。

インストール

Obsidian から – 設定 → コミュニティプラグイン → 参照 → 「Claudian」を検索 → インストール → 有効化。
ソースから – <vault>/.obsidian/plugins/claudian にクローンし、npm install && npm run build を実行してから、Obsidian で有効化します。

開発モードは npm run dev（監視）または npm run build（本番ビルド）で利用できます。

仕組み（高レベルアーキテクチャ）

src/main.ts – プラグインのエントリポイント。
core – プロバイダーに依存しない実行エンジン、プロセス処理、プロンプトエンコーディング、ツール抽象化。
providers/* – 各 LLM サービス（Claude、Codex など）のアダプター。CLI 検出、モデル検出、履歴を処理します。
features/* – UI コンポーネント：チャットサイドバー、インライン編集モーダル、設定 UI など。
shared と utils – 再利用可能な UI コンポーネントと汎用ヘルパー。

プライバシーとデータ使用

プロバイダーに送信されるもの：プロンプト、添付ファイル/画像、ツール呼び出し結果。宛先（Anthropic、OpenAI など）はプロバイダーごとに設定可能です。
テレメトリなし：Claudian はバックグラウンド使用データを送信しません。ネットワークトラフィックは、プロバイダーまたは MCP エンドポイントを明示的に呼び出した場合にのみ発生します。

一般的なトラブルシューティング手順

CLI が見つからない – プロバイダーの CLI がシステムの PATH にあることを確認するか（または設定 → Claudian → プロバイダーでパスを手動で設定）、設定します。
モデルがない – プロバイダーの CLI を更新し、プロバイダーのモデルリストの下にある検出をクリックします。
認証エラー – ANTHROPIC_API_KEY などの環境変数が CLI 資格情報を上書きする場合があります。プラグインの環境設定でクリアまたは上書きしてください。
Node / npm パスの不一致 – CLI が使用する Node バイナリが GUI アプリの環境からアクセス可能であることを確認します（そのディレクトリを共有 PATH に追加します）。

ヘルプ / 貢献

バグや機能リクエストについては、GitHub リポジトリで issue を開いてください。
プルリクエストは歓迎します。CONTRIBUTING.md を参照してください。新しいプロバイダーは受け付けていません – メンテナーによって上流で追加される必要があります。

ライセンスとスポンサー

MIT ライセンス。
Moonshot AI (Kimi) と Ke Holdings Inc. (BEIKE) がスポンサーです。プロモーションリンクからアフィリエイトコミッションは受け取っていません。

要約： Claudian は、最新の LLM コーディングエージェントを搭載したインタラクティブなコーディングプレイグラウンドに Obsidian ボールトを変え、フル機能のチャット UI、インライン編集、拡張可能なツール統合を提供し、データフローを透明でテレメトリなしに保ちます。

YishenTu/claudian