開発者がCLIのClaude Codeをcc-ahaというGUIデスクトップ環境に変えた方法

コーディングエージェントをコンソールで実行しようとしたことがある人なら、同じ問題にぶつかったことがあるでしょう。ターミナルは1つのコマンドを実行するには最適です。しかし、AIが十几个のファイルを編集し始め、連続的な差分のストリームを監視しようとすると手に負えなくなります。適切なインターフェース、シンタックスハイライト、セッションタブ、変更のための明確なアンドゥボタンが欲しくなります。

こうしてcc-ahaプロジェクトが誕生しました。著者はClaude Code CLIツールのソースコードを取り、その周りにデスクトップアプリケーションを構築しました。その結果は自律型AIエージェントのためのデスクトップ環境で、macOS、Windows、Linuxで利用可能です。

アプリケーションの中身

通常のコンソールユーティリティは開発者をターミナルウィンドウに閉じ込めます。cc-ahaプロジェクトは異なるアプローチを取り、エージェントロジックをElectronシェルとReactインターフェースでラップしています。ニューラルネットワークのダイアログがファイルツリー、変更表示ウィンドウ、組み込みブラウザと共存するグラフィカル環境が得られます。

インターフェースはモデルのアクションに対して完全なコントロールを維持できるように設計されています。各コード変更はディスクに書き込まれる前にサイドパネルに表示されます。

cc-ahaで確認すべき4つの機能

エージェントのCLIバージョンで作業する場合、常にスピードと安全性のバランスを取る必要があります。cc-ahaのクリエイターたちは開発者の主な課題に対処しようとしました。

Git Worktreeによるタスク隔離

ニューラルネットワークを直接作業ブランチで実行するのは危険です。モデルの不注意な判断一つで、ローカル変更のクリーンアップに30分かかることになります。cc-ahaでは、セッション作成時に1クリックでエージェントを別のGit Worktreeに送ることができます。コード変更は隔離されたディレクトリで行われ、メインブランチは影響を受けません。

ビジュアルレビューと柔軟なパミッション設定

コンソールで常に確認を入力する代わりに、アプリケーションでは5段階の自律性を設定できます。各bashコマンドの実行にパミッションを求めることも、モデルに独立して作業させることもできます。変更されたすべてのファイルは明確な差分ハイライトで表示됩니다。

単一プロバイダーからの脱却

元のClaude CodeはAnthropic APIに依存しています。cc-ahaではこの制限が取り除かれています。標準でOllamaやLM Studio経由のローカルモデル接続をサポートしており、DeepSeek、GLM、Kimi、ChatGPTなどのサードパーティーAPIも利用可能です。強力なローカルサーバーがあれば、エージェントは外部サービスにデータを送信せずに動作できます。

メッセンジャーとモバイルWeb 통한管理

длительныйリファクタリングタスクを開始してコンピュータから離れた？セッションはTelegram、WhatsApp、飞书（Feishu）にリンクしたり、QRコード経由でモバイルWebインターフェースからアクセスしたりできます。エージェントが停止してコマンド実行のパミッションを求めた場合、スマートフォンの画面から直接アクションを承認できます。

テクニカルスタックの構成

cc-ahaのアーキテクチャはいくつかの馴染み深いWeb技術を組み合わせています：

• ネイティブBunランタイムがスクリプト実行とサーバーロジックを処理します。
• ElectronとReact、Viteがデスクトップ環境を形成します。
• コンソールインターフェースはInkライブラリとCommander.jsパーサーで構築されています。
• MCP（Model Context Protocol）とLSPプロトコルのサポートにより、エージェントはプロジェクトのコンテキストと型構造を読み取れます。
• Computer Useモジュールは、単純なファイル編集では解決できないタスクのために、ニューラルネットワークにスクリーンショット撮影とカーソル制御の機能を付与します。

プロジェクトをローカルで実行する方法

一番簡単な方法はGitHubのリリースセクションにアクセスして、プラットフォーム用の готовый готовый готовый готовый готовый готовый готовый готовый готовなインストーラーをダウンロードすることです。ただし、CLI部分をデバッグしたい場合やソースからビルドしたい場合は、ビルドには数分かかります。

Bunがインストールされている必要があります。コマンドシーケンスは以下のようになります：

git clone https://github.com/NanmiCoder/cc-haha.git
cd cc-haha
bun install

cp .env.example .env

./bin/claude-haha

初回起動後、設定に入って選択したプロバイダーのAPIキーを入力するか、ローカルOllamaサーバーのアドレスを指定する必要があります。

実践的な考慮事項

本番プロジェクトでツールを使用する前に、その出自を考慮する価値があります。コードベースはAnthropicのnpmレジストリから一般公開されたいくつかのソースに依存しています。そのため、リポジトリには標準的なオープンソースライセンスがなく、LICENSEファイルにはNOASSERTIONステータスが表示されます。

macOSとWindows用のビルド済みパッケージには、まだ開発者のデジタル署名が含まれていません。macOSでの初回起動時、OSが実行をブロックするため、OSのセキュリティ設定でアプリを手動で許可する必要があります。

cc-ahaが役立つ人

このツールは、コード作成にAIエージェントを積極的に使用しているが、明確な変更管理を備えたGUIインターフェースを好む人に向いています。DeepSeek、Claude、ローカルネットワーク間を切り替えられるため、幅広いシナリオで多用な作業環境を実現できます。