Codepilotは全プラットフォーム対応のオープンソースAgentクライアントで、GitHub Starはすでに5100を突破しています。Claude、OpenAI、そしてほぼすべての中国国産モデルのCodeplan連携に対応し、Skillsマーケット、MCP管理、IMリモート接続、デザインモード、生成UIなどの機能を内蔵しています。

Claude CodeやOpenClawを使ったことはあるが機能の柔軟性が足りないと感じた方、あるいは1つの統一インターフェースで複数のAIモデルを管理したい方には、Codepilotは試す価値があります。

始める前の準備

• OS：macOS、WindowsまたはLinux
• 少なくとも1つのAIモデルのAPI Key（Claude、OpenAI、中国国産モデルのいずれでも可）
• 所要時間：インストールと設定に15-30分

ステップ1：アプリをインストールする

CodepilotのGitHub Releasesページにアクセスし、プラットフォームに対応したインストーラをダウンロードします。

macOSユーザーへの注意：Intel版とApple Silicon版を区別してください。間違えると動作が重くなります。

Windowsユーザー：初回起動時にセキュリティ警告が出ますが、そのまま続行してインストールすれば大丈夫です。

macOSユーザー：公証署名がないため、Appleがブロックしてきます。まずインストールを完了させ、その後「システム設定 > プライバシーとセキュリティ」へ進み、下にスクロールして「このまま開く」を見つけてクリックします。

ステップ2：モデルプロバイダを設定する

インストール完了後、「設定 > プロバイダ > プロバイダを追加」に進みます。

中国国産モデルのCodeplan設定（Zhipuを例に）

1. ZhipuのCodeplanページでAPI Keyを取得する
2. Codepilotで「GLM (CN)」を選択する
3. API Keyを入力する
4. 「接続テスト」をクリックして接続を確認する

現在対応している中国国産Codeplanチャネル：Zhipu、MiniMax、Kimi、MIMO、Volcano Ark、Alibaba Cloud Bailian。

サードパーティAnthropic APIの設定

中国国内のサードパーティClaudeプロキシAPIを使っている場合：

1. 「Anthropic Third-party API」チャネルを選択する
2. 名前を入力する（自由につけて、識別しやすくすればOK）
3. ベースURLを入力する（プロバイダのドキュメントにあるClaudeCodeセクションで探す）
4. API Keyタイプの選択：プロバイダの環境変数の接頭辞が AUTH か API_KEY かで判断する
5. プロバイダがモデル名の設定を求める場合は「詳細」を展開して対応する名前を入力する

Claude Codeアカウントの利用枠を使う

Claude ProまたはMaxメンバーシップを持っている場合：

1. 先にClaude Codeをインストールする（「設定 > Claude Code」からワンクリックでインストール可能）
2. 実行エンジンを「Claude Code」に切り替える
3. 入力ボックス下のモデル選択にClaude Codeカテゴリが表示される

注意：Codepilotが読み取れるのはAnthropicのログイン状態と手動で設定したグローバル環境変数だけです。CC Switchなどのツールで設定した状態は読み取れないため、再追加が必要です。

OpenAIアカウントの認可

「ChatGPTでログイン」を選び、開いたページで認可すれば完了です。以降はGPT-5.4などのモデルが使えます。

Ollamaローカルモデル

Ollamaをインストールし、必要なモデルをプルしてから、プロバイダでOllama接続を選び、モデル名を入力します。

ステップ3：プロジェクトとチャットを作成する

Codepilotはプロジェクト制を採用しており、各チャットは1つのローカルフォルダに対応します。

1. 「新規プロジェクト」をクリックしてフォルダを1つ選ぶ
2. AIはそのフォルダ下のすべてのファイルを見て、操作できる
3. 入力ボックス下でモデル、コード/プランモード、権限レベルを切り替えられる

タスクが複雑な修正の場合は、先に「プランモード」を有効にし、AIに計画させてから実行させるのがおすすめです。

ステップ4：SkillsとMCPのインストールと使用

Skills

左側の「Skills」パネルを開き、「スキルマーケット」に切り替えて、必要なSkillsを検索してインストールをクリックします。

使い方：入力ボックスで機能を記述し Skills キーワードを添えるか、入力ボックスの稲妻アイコンをクリックして利用可能なすべてのSkillsを確認します。

MCP

左側の「MCP」をクリックしてMCP管理パネルに切り替えると、インストール済みのMCPサービスを確認できるほか、「サーバーを追加」をクリックして新しいものをインストールできます。

使い方：会話の中でニーズを記述するだけで、AIが対応するMCPツールを自動的に呼び出します。

ステップ5：FeishuやQQなどのIMでリモート接続する

CodepilotはOpenClawに似たIMリモート接続機能を備えています。

1. 「設定 > リモートブリッジ」に進み、スイッチをオンにしてブリッジを起動する
2. 下のチャネルで必要なIM（Feishu、WeChat、QQ、Discordなど）を有効にする
3. リモート接続時の作業ディレクトリとデフォルトモデルを設定する
4. ページ下部の設定ガイドに従い、対応するIMの開発者プラットフォームで設定を完了する

設定が完了すれば、パソコンの電源を切っても、Agentはクラウド上であなたのメッセージを受け取り、処理し続けます。

ステップ6（上級）：アシスタントモードと生成UI

アシスタントモード

「設定 > アシスタント」でアシスタントフォルダを1つ指定すると（Obsidianボルトのフォルダを推奨）、アシスタントは長期記憶を持ち、自らタスクを確認して実行するようになります。

生成UI

AIに「XXXXを可視化して説明して」と頼むと、インタラクティブなチャートやフローチャートをリアルタイムで生成します。生成されたUIはボードに「Pin」でき、データはリアルタイム更新に対応しています。

よくある質問

• Q：Macで開くときにブロックされる？ A：「システム設定 > プライバシーとセキュリティ」で「このまま開く」を見つけてください。

• Q：サードパーティAPIに接続できない？ A：ベースURLがプロバイダのドキュメントのClaudeCodeセクションから取得したものか確認し、API Keyタイプの選択が正しいか確かめてください。

• Q：OpenAIモデルを選ぶと能力が落ちる？ A：OpenAIモデル使用時はAgentアーキテクチャがAI SDKモードに切り替わるため、コード記述能力はClaude Codeモードに及ばない場合があります。

• Q：CC Switchの設定をインポートできる？ A：直接読み取ることはできず、サードパーティAPIのやり方で再追加する必要があります。

プロジェクトリンク

• GitHub: https://github.com/op7418/CodePilot