clawcodex: READMEの実装範囲と導入時に見るべき条件

clawcodexを読むための焦点

ClawCodex は Claude Code の Python 移植版で、TypeScript リファレンス実装から移植され、慣用的な Python に適合されています。リポジトリの説明では約 31 万行の完全な Python リビルドとされており、README は本番指向で、ソースダンプではなく動作する CLI エージェントと説明しています。移植は元のアーキテクチャを保持し、ツール呼び出しループ、ストリーミング REPL、セッション履歴、マルチターン実行を含みます。上流との主な違いは、ClawCodex が多くの LLM プロバイダーで動作するように設計されているのに対し、Claude Code は Claude モデルのみを対象としている点です。README はこれを上流に対する最大の前進と位置付けています。コードベースは読みやすくハックしやすいとされ、テストとマークダウン駆動のスキル拡張を備えています。プロジェクトは活発に開発されており、README のニュースセクションによると毎週新機能が追加されています。

READMEの設定例を検証用のAPIキーと作業ディレクトリで試し、/eco、DeepSeekのプレフィックスキャッシュ、プロバイダーのログイン状態を個別に確認する。権限プロンプト、スキル、スケジュールタスクを有効にする前に、実行されるコマンドと書き込み先を監査する。 第1章では、この章に書かれた設定名、ファイル名、コマンド、数値のいずれを確認したかを記録し、READMEの説明と実際の出力を混同しない。

インストールと設定

クイックインストールはワンライナーです: `curl -fsSL https://clawcodex.app/install.sh | bash` で、uv、Python 3.10+ をインストールし、`clawcodex` を PATH に追加します。インストーラにはライフサイクルヘルパーも含まれます: `doctor`、`verify`、`update`、`uninstall`。再実行しても安全で、macOS、Linux、WSL で動作します。ソースから手動でインストールする場合、README ではリポジトリをクローンし、venv を作成し、依存関係をインストールし、`python -m src.cli login` を実行して `~/.clawcodex/config.json` に設定を書き込む方法が示されています。設定ファイルには、プロバイダーの API キー、ベース URL、デフォルトモデル、およびオプションの session、settings、env ブロックが保存されます。README はインタラクティブなセットアップに `clawcodex login` を推奨しており、プロバイダー選択、API キー入力、オプションのベース URL とデフォルトモデルを順に案内し、選択したプロバイダーをデフォルトに設定します。設定はプロバイダーごとの環境変数フォールバックもサポートしているため、ほとんどのプロバイダーは設定ファイルを編集せずに動作します。

READMEの設定例を検証用のAPIキーと作業ディレクトリで試し、/eco、DeepSeekのプレフィックスキャッシュ、プロバイダーのログイン状態を個別に確認する。権限プロンプト、スキル、スケジュールタスクを有効にする前に、実行されるコマンドと書き込み先を監査する。 第2章では、この章に書かれた設定名、ファイル名、コマンド、数値のいずれを確認したかを記録し、READMEの説明と実際の出力を混同しない。

トークンコスト制御: /eco と DeepSeek プレフィックスキャッシュ

`/eco` トグルは、RTK のメソッドセットから移植された決定論的フィルタを使用して、すべての Bash 結果のモデルバインドレンダリングを圧縮します。README は測定されたベンチマークを報告しています: 27 の実コマンド出力を本番パイプラインで再生すると、92,989 トークンから 17,767 トークンへと 80% 削減されました。圧縮は生のレンダリングより悪くなることがないように保証されており、損失のある圧縮は常に完全な出力をディスクに保存し、実行可能なリカバリヒントを付けます。別途、ClawCodex はリクエストプレフィックスをバイト安定に保つため、DeepSeek のプロンプトキャッシュがシステム、ツール、履歴の全体をカバーできます。README によると、キャッシュヒット入力は 100 万トークンあたり約 0.0435 ドルで、Claude Fable 5 の 100 万トークンあたり 10 ドルより約 230 倍安いです。これら 2 つの機能は重ねられます: キャッシュにより安定プレフィックスがほぼ無料になり、`/eco` が毎ターン実際に支払う新しいサフィックスを縮小します。README には、RTK 自身のセッションモデルを測定比率で再計算した比較表もあり、平均的な仮定では 19% の削減、しかし太い尾を持つ実際のコーパスでは 80% の削減を示しています。

READMEの設定例を検証用のAPIキーと作業ディレクトリで試し、/eco、DeepSeekのプレフィックスキャッシュ、プロバイダーのログイン状態を個別に確認する。権限プロンプト、スキル、スケジュールタスクを有効にする前に、実行されるコマンドと書き込み先を監査する。 第3章では、この章に書かれた設定名、ファイル名、コマンド、数値のいずれを確認したかを記録し、READMEの説明と実際の出力を混同しない。

プロバイダーカバレッジとサブスクリプションログイン

README によると、ClawCodex は 30 のプロバイダーをサポートしており、Anthropic、OpenAI、Gemini、DeepSeek などのネイティブワイヤーフォーマットに加え、OpenAI 互換ベンダーや Ollama、vLLM、SGLang などのローカルサーバーが含まれます。新しい OpenAI 互換ベンダーは、openai_compatible_specs.py ファイルに 1 行追加するだけです。README は Claude Pro/Max と ChatGPT プランのサブスクリプションログインも文書化しています。Anthropic の場合、`clawcodex login` のサブスクリプションオプションで PKCE 認証ページが開きます。OpenAI の場合、ブラウザ、デバイスコード、Codex CLI からのインポートの 3 つの方法があります。README は、サードパーティクライアントからのサブスクリプション利用は公式にサポートされておらず、停止する可能性があると述べています。OpenAI のサブスクリプションモデルは gpt-5.5、gpt-5.4 などがリストされ、Anthropic 統合は OAuth と自動トークン更新を使用します。明示的な API キーは常にサブスクリプションより優先されます。

READMEの設定例を検証用のAPIキーと作業ディレクトリで試し、/eco、DeepSeekのプレフィックスキャッシュ、プロバイダーのログイン状態を個別に確認する。権限プロンプト、スキル、スケジュールタスクを有効にする前に、実行されるコマンドと書き込み先を監査する。 第4章では、この章に書かれた設定名、ファイル名、コマンド、数値のいずれを確認したかを記録し、READMEの説明と実際の出力を混同しない。

権限と安全性

インタラクティブな CLI はデフォルトでフルアクセスで起動します。つまり、尋ねることなく任意のファイルを編集し、任意のコマンドを実行できます。ユーザーは `/permissions` でこれを変更でき、3 つのレベルがあります: 承認を求める、私のために承認、フルアクセス。選択したレベルは `~/.clawcodex/settings.json` の `permissions.defaultMode` に保存されます。`-p` によるヘッドレス実行は、明示的に上書きしない限り `default` のままであり、保存されたフルアクセスはこれを緩めません。リポジトリ提供の設定は権限を厳しくすることはできますが、決して広げることはできず、`default` と `dontAsk` モードに制限されています。README はまた、`--dangerously-skip-permissions` フラグがすべてのチェックを無効にすると説明し、特定の環境変数が設定されていない限り、root として実行するときは拒否されると述べています。`/plan` モードは、明示的に緩和されない限り、フルアクセスセッションでも編集を制限し続けます。

READMEの設定例を検証用のAPIキーと作業ディレクトリで試し、/eco、DeepSeekのプレフィックスキャッシュ、プロバイダーのログイン状態を個別に確認する。権限プロンプト、スキル、スケジュールタスクを有効にする前に、実行されるコマンドと書き込み先を監査する。 第5章では、この章に書かれた設定名、ファイル名、コマンド、数値のいずれを確認したかを記録し、READMEの説明と実際の出力を混同しない。

ベンチマークとその注意点

README は、Claude Opus 5 で effort=xhigh の単一実行で Terminal-Bench 2.1 の pass@1 が 80.9% で、89 タスク中 72 を解決したと報告しています。これは、リーダーボードの k=5 平均に対する単一の k=1 パスであり、公開リーダーボードで約 3 位になるだろうと述べています。README には SWE-bench Verified の比較も含まれており、ClawCodex は 499 インスタンス中 291 を解決（58.2%）、openclaude は 265 を解決（53.0%）で、どちらも Gemini 2.5 Pro で駆動されました。両方の結果には、統計的不確実性と再現性に関する明示的な注意事項が添えられており、README はローカル再現用の評価ハーネスへのリンクを提供しています。Terminal-Bench の結果は、ランク付けされた提出ではなく方向性のあるものと説明されています。

READMEの設定例を検証用のAPIキーと作業ディレクトリで試し、/eco、DeepSeekのプレフィックスキャッシュ、プロバイダーのログイン状態を個別に確認する。権限プロンプト、スキル、スケジュールタスクを有効にする前に、実行されるコマンドと書き込み先を監査する。 第6章では、この章に書かれた設定名、ファイル名、コマンド、数値のいずれを確認したかを記録し、READMEの説明と実際の出力を混同しない。

スキルとスケジュールタスク

スキルは `.clawcodex/skills` ディレクトリの `SKILL.md` ファイルに保存されるマークダウンベースのスラッシュコマンドです。名前付き引数とツール制限をサポートしています。`/loop` コマンドは、固定スケジュールまたはセルフペースモードでプロンプトを繰り返し実行し、CronCreate、CronList、CronDelete ツールで管理される cron 式を使用します。スケジュールされたプロンプトは、セッションがアイドル状態のときにターン間で起動し、繰り返しジョブは 7 日後に自動的に期限切れになります。README には、`/eco`、`/stream`、`/compact` などを含む REPL コマンドの完全な表があります。スキルシステムは、プロジェクトレベルとユーザーレベルのスキルをサポートし、`$path` などの引数とプレースホルダー構文があります。`/loop` 機能にはセルフペースモードもあり、モデルが ScheduleWakeup ツールを介して次の遅延を選択します。

READMEの設定例を検証用のAPIキーと作業ディレクトリで試し、/eco、DeepSeekのプレフィックスキャッシュ、プロバイダーのログイン状態を個別に確認する。権限プロンプト、スキル、スケジュールタスクを有効にする前に、実行されるコマンドと書き込み先を監査する。 第7章では、この章に書かれた設定名、ファイル名、コマンド、数値のいずれを確認したかを記録し、READMEの説明と実際の出力を混同しない。

編集部の結論

clawcodexは、READMEに記載された機能と前提が自分の用途に重なる場合に、検証用環境から評価を始められるプロジェクトです。READMEの設定例を検証用のAPIキーと作業ディレクトリで試し、/eco、DeepSeekのプレフィックスキャッシュ、プロバイダーのログイン状態を個別に確認する。権限プロンプト、スキル、スケジュールタスクを有効にする前に、実行されるコマンドと書き込み先を監査する。 本番採用に向くかは、ここで確認した入力、出力、権限、ライセンスの条件が運用要件を満たすかで判断します。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes