iCode Agent · はじめに
iCode Agent をインストールします。
1 つのパッケージを 1 回インストールするだけ。iCode Agent は Node.js 22 以降で、Windows、macOS、Linux 上で動作します。
このガイドではターミナルエージェントを扱います。デスクトップ環境についてはiCode Workbenchをご覧ください。
1. インストール
グローバルにインストールし、任意のプロジェクトで実行します。
npm install -g @icodehq/icode-agent cd ~/my-project icode-agent
インストールしたくない場合は、npx @icodehq/icode-agent で一度だけ実行できます。
2. モデルを設定する
初回起動時、iCode Agent はワークスペースを開く前にモデルを設定します。openai と anthropic プロトコルに対応しているため、公式 API とも互換エンドポイントとも連携できます。
- 既存の設定を選ぶか、新しく追加します。プロトコル、エンドポイント、モデル名、API キーです。
- 保存される前に、実際の接続テストに合格する必要があります。
- 設定は
~/.icode-agent/models.jsonにローカル保存されます。
モデルは /model または Ctrl+P でいつでも切り替えられます。
非対話での使用
スクリプトと CI 向け:
icode-agent -p "run the tests and report failures" # print the final response icode-agent --mode json -p "find TODO comments" # stream events as JSON lines icode-agent -c -p "now fix what you found" # continue the last session
トラブルシューティング
- ワークスペースが開かない — まだモデルが有効になっていません。セットアップを完了するか、
~/.icode-agent/models.jsonを直接作成してください。 - コマンドがすぐに失敗する — Windows では既定で PowerShell でコマンドが実行されます。CMD を使うには設定で
"shell": "cmd"を指定してください。 - 長いタスクが遅くなる — iCode Agent はリクエストを抑えるため古いコンテキストを要約します。実行すると通知します。
クロスプラットフォーム対応は実装済みです。自動検証は Linux で行われており、Windows と macOS のネイティブ検証は保留中です。
解決しない場合は、Issue を作成してください。