OpenClaudeの使い方｜任意LLMのCLI比較

課題

コーディングエージェントを使いたい一方で、特定クラウドのハーネスにモデル提供者を固定したくない、という需要が強まっています。Claude Code 系のターミナルUX（tools / agents / MCP / slash commands）を保ったまま、OpenAI 互換 API・Gemini・Ollama などへ切り替えたい場面が増えているからです。

📑目次

1. OpenClaude とは何か（マルチプロバイダのターミナル・ハーネス）
2. 導入手順（npm → /provider → 動作確認）
3. プロバイダ・機能・実務で効くポイント
4. Claude Code / OpenCode / Gemini CLI / Codex 系との比較軸
5. ライセンス・セキュリティ・採用前チェックリスト
6. よくある質問（FAQ）
7. まとめと次のアクション

---

OpenClaude の位置づけ

OpenClaude（Gitlawb/openclaude）は、クラウドとローカルの複数バックエンド向け オープンソース coding-agent CLI です。公式 README は、prompts / tools / agents / MCP / slash commands / streaming を 1つのターミナルUX に載せる、と説明しています。

---

調査時点の規模感

調査時点の導入・規模感は次のとおりです。

• 配布: npm の @gitlawb/openclaude
• ランタイム: Node.js 22以上
• 安定線: v0.26.0（GitHub Release 公開 2026-07-27）
• GitHub 規模感: 約 30.4k★ / 8.9k forks

---

重要な境界

重要な境界もあります。

• プロジェクト自身が Claude Code 由来の大幅改変フォークであり、Anthropic 非公式
• ライセンスは「改変部分は MIT / 由来部分は Anthropic 側が残る」と README の Disclaimer・License に明記
• 名称が近い OpenCode とは別リポジトリ・別配布

---

この記事でできること

この記事では、(1) 公式の位置づけと導入手順、(2) プロバイダ設定と実務ポイント、(3) Claude Code / OpenCode / Gemini CLI / Codex 系との比較軸、(4) ライセンス・秘密情報・採用前チェックリストまでを整理し、試験導入か見送りかを決められる状態にします。

---

OpenClaude とは何か（マルチプロバイダのターミナル・ハーネス）

結論から言うと、OpenClaude は「チャットボットの薄いラッパー」でも「IDE専用プラグイン」でもなく、ターミナル上で変更をレビューしながら回す coding-agent ループ を、複数モデル提供者へ開いた OSS CLI です。

公式の定義と対応プロバイダ

公式 README は、次を Supported Providers として列挙しています。

• OpenAI 互換 API
• Gemini
• GitHub Models
• Codex OAuth / Codex
• Ollama
• Atomic Chat
• Bedrock / Vertex / Foundry など

サイト（openclaude.gitlawb.com）も、200+ models 表現とともに、ターミナルで動き変更をレビューできる agent loop を訴求しています。

Why OpenClaude として README が挙げる要点は次のとおりです。

• プロバイダ横断で 単一の CLI UX を維持できる
• /provider によるガイド付きプロファイル
• bash / file / grep / glob / agents / tasks / MCP / web などのツール群
• リポジトリ同梱の VS Code 拡張（起動統合など）

---

設定 cutover（~/.openclaude）

設定の cutover も実務で効きます。

• 現行 README の既定: ~/.openclaude と ~/.openclaude.json
• 既定では ~/.claude / プロジェクト .claude/ / CLAUDE_CONFIG_DIR を読みません
• 旧 Claude Code 設定からの移行は意図的なコピーに限定
• Claude Code 認証の丸ごと持ち込みは非推奨

第三者ドキュメントの一部には Claude Code パス再利用の表現が残る場合があります。運用の正は現行公式 README の cutover とし、第三者はエコシステム採用の裏取りとして扱います。

---

独立ソースの位置づけ

独立ソース側の位置づけも揃っています。

• Actionable Notes: post-leak の runnable fork 群の中に OpenClaude を列挙
• Sébastien Dubois や OpenApps 系: provider lock-in 解除＋Claude Code 近傍UXとして説明
• ByteRover の CLI tools ドキュメント: 外部 connector 表に OpenClaude を掲載（GitHub/npm 以外のツール生態系でも名前が通っている証拠）

出典

---

一言サマリー

項目	内容	出典
製品	マルチプロバイダ coding-agent CLI	GitHub README
配布	npm @gitlawb/openclaude / AUR openclaude	npm / AUR / README
ランタイム	Node.js ≥22（ソースビルドは Bun 別途）	README / npm engines
最新安定（調査時）	v0.26.0（2026-07-27）	GitHub Releases
規模感（調査時）	約 30.4k★ / 8.9k forks	GitHub API 2026-07-28
公式性	Anthropic 非公式・独立コミュニティ	README Disclaimer
ライセンス	改変 MIT + 由来 Claude Code は Anthropic	README License

出典: Gitlawb/openclaude、npm @gitlawb/openclaude、Release v0.26.0（2026年7月時点）

---

導入手順（npm → /provider → 動作確認）

最短の成功パターンは「バージョン確認可能な npm 導入 → 試験用キーだけで /provider → 使い捨てリポジトリで小さなタスク → /diff でレビュー」です。

前提

• Node.js 22以上
• ripgrep（rg）が PATH にあること。install 後に not found なら、OS パッケージで rg を入れてからシェルを再起動します

---

公式 Quick Start に沿った手順

1. npm install -g @gitlawb/openclaude@latest
2. openclaude --version と npm view @gitlawb/openclaude dist-tags で 0.26.x を確認
3. openclaude で起動
4. 対話内で /provider（保存先は .openclaude-profile.json 系）。GitHub Models は /onboard-github
5. 任意: プロジェクトで /init → 小さなタスク → /diff で変更確認（TechLatest の masterclass でも同様の導線）

---

環境変数ショートカット（公式）

• OpenAI 系: CLAUDE_CODE_USE_OPENAI=1 + OPENAI_API_KEY + OPENAI_MODEL
• Ollama: 上記に加え OPENAI_BASE_URL=http://localhost:11434/v1 とモデル名（OpenClaude は Ollama native chat API と 32768 context 要求の注記あり）
• .env の自動読込はしない。/provider を推奨するか、openclaude --provider-env-file .env を使う

Arch Linux では AUR の openclaude（調査時点 0.26.0-1、2026-07-27 更新）もコミュニティ包装として存在します。

• 例: paru -S openclaude
• 意味: npm 以外の配布が追従していることの裏取り

---

長時間タスクと VS Code

長時間タスクは次のコマンド群です。

• openclaude --bg "..." / ps / logs / kill
• ローカル child process であり daemon/network service ではない
• メタデータは通常 ~/.openclaude/bg-sessions/ に置かれる
• VS Code 向け: リポジトリ同梱の vscode-extension/openclaude-vscode

---

つまずきやすい点

つまずきやすい点は次です。

• Node 版が 22 未満
• rg 未導入
• API キーをプロファイルや設定ファイルに平文保存したまま git 管理してしまう（独立 note / dsebastien でも注意）
• Anthropic 固有機能を、他プロバイダでも同じ前提で期待する

---

プロバイダ・機能・実務で効くポイント

プロバイダ表の読み方

プロバイダ表は「使える名前の一覧」ではなく、setup path（/provider / env / onboard）と notes 付きの期待値表として読むのが安全です。

• OpenAI 互換は OpenRouter / DeepSeek / Groq / Mistral / LM Studio などの /v1 を広くカバー
• ただし 機能はプロバイダ非対称

---

コスト・Web・ヘッドレス

コスト最適化では、~/.openclaude.json の次でサブエージェント別にモデルを振り分けられます。

• agentModels
• agentRouting

その他の実務レバー:

• GitHub Copilot 系: Premium Request 抑制のためサブエージェント直列化の注記あり
• Web 検索: 非 Anthropic 既定で DuckDuckGo fallback になる経路があり、rate-limit や ToS の注意が付く
• 安定化したい場合: Firecrawl キーを任意で足せる
• ヘッドレス連携: gRPC server（npm run dev:grpc）の導線があり、他アプリや CI からの統合を想定したドキュメントがある

---

独立実務の証拠

独立実務の証拠も具体です。

• TechLatest masterclass: install → /provider → 多数の slash → permissions → /init → /diff /rewind /cost → --bg
• Zenn（mskbhd）: v0.23 系で LSP diagnostics / /diagnostics を OpenRouter 経由で検証（interactive と -p の差分に注意）
• note.com 系: /provider と ~/.openclaude.json の per-agent 割り当て、API キー平文の注意

---

過大期待しない軸

公式 Provider notes を「過大期待しない」軸にすると判断が楽です。

• 小モデルは多段 tool が弱くなりやすい
• tool/function calling が強いモデルを選ぶ
• 上記前提をチームで共有しておくと失敗が減る

---

Claude Code / OpenCode / Gemini CLI / Codex 系との比較軸

ここでの目的は優劣の断定ではなく、公式ハーネス vs マルチプロバイダ fork の役割分担です。名称が近い OpenCode は別製品として混同しないでください。

比較表

軸	OpenClaude	Claude Code（公式系）	OpenCode 等の別ハーネス	読むときの問い
プロバイダ	多バックエンドを一つの CLI に	主に Anthropic 公式経路	製品ごとにモデル方針が異なる	ロックインを外したいか
UX 祖先	Claude Code 由来の大幅改変	公式本体	別系統が多い	既存 Claude Code 操作感を残したいか
設定ディレクトリ	既定 ~/.openclaude（cutover 後）	~/.claude 系	製品依存	設定混線を避けられるか
拡張	MCP / skills / agents / slash	skills / MCP / hooks 等	製品依存	既存 MCP 資産を流用したいか
法的・商標	非公式 + 二重ライセンス注意	公式利用規約	各 OSS/商用条件	企業利用の法務レビューが通るか
ローカル LLM	Ollama 等を公式導線で記載	製品方針依存	強い場合あり	オフライン/社内モデルが必須か

出典: OpenClaude README Disclaimer/Providers、dsebastien / OpenApps / note.com などの独立整理（2026年7月時点）。OpenCode は別製品。

---

選択ヒューリスティック

選択のヒューリスティックは次です。

• Anthropic 公式サポート・規約内運用が最優先 → Claude Code 公式
• Claude Code に近いターミナル操作のままプロバイダを外したい・検証したい → OpenClaude を隔離環境で試験
• そもそも別 UX / アーキテクチャを選びたい → OpenCode や各公式 CLI を個別比較（本記事は OpenClaude 中心）

---

関連記事と発見シグナル

Claude Code のハーネス構造や公式 CLI の安全運用については、既存記事の Claude Codeのハーネスとは｜モデル・内部ループ・外部設定の3層 や Claude Code vs Codex CLI 徹底比較、Claude Code セキュリティ設定ガイド も併せて参照すると、比較軸の背景が取りやすくなります。

SNS 上の「ソース露出後フォーク議論」は発見シグナルです。人気やブックマーク数は事実根拠には使いません。

---

ライセンス・セキュリティ・採用前チェックリスト

Disclaimer と二重ライセンス

採用判断で最初に読むべきは README の Disclaimer と License です。

• Anthropic 非提携であり、Claude / Claude Code は Anthropic の商標
• OpenClaude 側の改変は MIT、derived Claude Code は Anthropic 側が残る、という 二重レイヤー
• 企業導入では一次 LICENSE の確認と法務判断が必須
• OpenApps などの第三者カタログも dual-layer を独立に整理

---

秘密情報

秘密情報の扱いは次を固定してください。

• /provider プロファイルと ~/.openclaude.json をリポジトリにコミットしない
• 平文 api_key が設定ファイルに残る前提でディレクトリ権限とバックアップ範囲を決める
• 本番キー・顧客データを最初の試験に載せない

---

権限と Web 検索

権限面では、bash や file 編集がエージェントから走る前提です。

• permission ゲートと /diff レビューを習慣化
• WebSearch の DuckDuckGo fallback は ToS / ブロックリスクを知ったうえで使う
• 必要なら Firecrawl を検討

---

読者向けチェックリスト（次アクション）

• ✓ 目的は「プロバイダ固定解除」か「公式サポート優先」か決めた
• ✓ Node.js 22以上と ripgrep を用意した
• ✓ npm i -g @gitlawb/openclaude@latest 後に version が 0.26.x 系
• ✓ /provider で試験用キーのみ設定し、git 管理外を確認した
• ✓ 最初のタスクは使い捨てリポジトリまたは worktree
• ✓ /diff で差分レビューしてから commit する運用にした
• ✓ LICENSE / Disclaimer を法務または自分で読み、社内ポリシーと矛盾しないか確認した
• ✓ Anthropic 固有機能が他プロバイダで欠ける前提をチームで共有した
• ✓ 本番データ・本番資格情報は載せていない

迷ったら、Ollama または安い OpenAI 互換で無害タスクを1本だけ回し、成功したら MCP / サブエージェント / background を足す順序が安全です。

---

関連記事:

• Agent Zero v2.6 — Docker 上のフル Linux デスクトップを持つ OSS エージェント（Opus 5 比較で再バズ）
• グラフとループの使い分け｜導入判断チェックリスト【2026】
• Claude Opus 5が浅く感じる原因｜lean promptとCLAUDE.md改修

よくある質問（FAQ）

Q1. OpenClaude は Anthropic 公式ですか？

いいえ。README Disclaimer で独立コミュニティプロジェクトかつ非提携と明記されています。

---

Q2. OpenCode と同じものですか？

いいえ。Gitlawb/openclaude は別リポジトリ・別配布（npm @gitlawb/openclaude）です。名称が近いため混同しやすい点に注意してください。

---

Q3. 最低限の導入コマンドは？

Node.js 22以上のうえ npm install -g @gitlawb/openclaude@latest → openclaude → /provider です。version は Release / npm の 0.26.0 系を確認します。

---

Q4. Claude Code の設定（~/.claude）はそのまま使えますか？

現行 README の cutover では既定で ~/.claude を読みません。必要な自作設定だけ意図的に .openclaude 側へ移し、認証の丸コピーは避けてください。

---

Q5. 企業利用で最優先の注意は？

二重ライセンス（改変 MIT + 由来 Anthropic）、商標、秘密鍵の保存場所、エージェントのファイル/シェル権限です。法務レビューなしの本番投入は避けてください。

---

Q6. ローカル LLM だけでも使えますか？

README に Ollama クイックスタートがあります。ただし小モデルは多段 tool が弱くなり得る、と公式 Provider notes にあります。

---

まとめと次のアクション

OpenClaude は、「Claude Code 近傍のターミナル・エージェントUXを、マルチプロバイダで使う」ための OSS CLI です。v0.26.0・npm 配布・約30k★規模で、導入導線も明確です。一方で Anthropic 公式ではないため、法務と秘密管理と権限レビューはセットです。

今すぐ取る次アクションは、次のどれか1つに絞ると進めやすいです。

1. 試験: 使い捨て repo で npm 導入 → /provider → 小さなリファクタ1本 → /diff
2. 比較: 上表の軸で Claude Code 公式継続か OpenClaude 試験かをチームで決める
3. 見送り: 公式サポート/規約が必須なら Claude Code 公式を維持し、フォークは追跡のみ

一次情報は GitHub README、Release v0.26.0、npm、公式サイト を確認してください。