DAO-Code インストール教程：5 分で macOS を動かす（2026）

初めてDAO-CodeをmacOSへ導入する開発者向けの実作業ガイドです。公式バイナリ、npx、ソース導入を条件別に比較し、API設定、権限確認、最小タスクによる導入判定まで時系列で説明します。

【判断】最初の導入は公式のネイティブバイナリ用スクリプトを選びます。短時間の確認だけならnpx、DAO-Codeのコードを変更するならソース導入へ切り替えます。DAO-Code本体にDocker、Xcode、Metal対応のローカル推論環境は必要ありません。

この手順は、初めてDAO-CodeをmacOSへ入れる開発者、クリーンなMacでAI Agent環境を再現したいテスト担当者、iOSやmacOSの作業を別のMacで継続したい開発者向けです。最終更新は2026年9月3日です。内容は公式README、公式インストールスクリプト、Release情報、DeepSeek API文書を突き合わせています。

導入前に、3つのルートを決めます

公式READMEが案内する導入経路は、ネイティブバイナリ、npx、npmおよびソース導入です。目的を先に決めると、不要なDocker設定や開発ツールの追加を避けられます。

なお、正式Releaseページではv0.4.7が最新の正式版として表示されています。一方、masterのpackage.jsonには0.4.17が記載されています。Releaseの表示とmasterのpackage.jsonは同じ意味ではありません。配布ファイルを選ぶときは、開発ブランチの番号を正式版と混同しないでください。

注意：ネット上の記事にある「Web3専用ツール」「スマートコントラクト用」「Docker必須」という説明は、今回確認した公式資料では裏付けられません。ここではDAO-CodeをDeepSeek APIへ接続するクロスプラットフォームのターミナルコーディングAgentとして扱います。

macOSとCPU、PATHを先に確認します

まずターミナルを開き、次を順番に実行します。

sw_vers
echo "$SHELL"
uname -m
echo "$PATH"
command -v node
node --version

uname -mがarm64ならApple Silicon、x86_64ならIntel Macです。AppleのApple Silicon向けmacOSバイナリ資料でも、arm64とx64は別のアーキテクチャとして扱われています。Releaseに複数の資産がある場合、Mシリーズはarm64、Intel Macはx64を選びます。

Node.jsが見つからない場合は、Node.js公式ダウンロードページから現在のREADMEに合う版を用意します。ここで古いNode.jsをPATHへ残すと、インストール済みなのに別バージョンが呼び出される問題が起きます。command -v nodeとnode --versionの結果を記録してから先へ進みます。

公式スクリプトを安全に実行します

最短ルートは、公式のinstall.shを保存して内容を読んでから実行する方法です。リモートスクリプトを直接パイプで実行する形は、確認なしでは使いません。

curl -fsSL https://raw.githubusercontent.com/tigicion/dao-code/master/install.sh \
  -o dao-code-install.sh

sed -n '1,240p' dao-code-install.sh
chmod +x dao-code-install.sh
xattr -d com.apple.quarantine dao-code-install.sh 2>/dev/null || true
./dao-code-install.sh

sedで、書き込み先、PATH変更、取得元、追加コマンドを確認します。表示範囲に収まらない場合は、less dao-code-install.shで全体を読みます。実行方法や引数がREADMEの記述と異なる場合は、公式READMEの当該手順を優先し、独自のワンライナーへ置き換えません。

インストール後はシェルを再読み込みし、コマンドの場所を確認します。

hash -r
command -v dao
dao --version

daoが見つからないときは、インストール失敗と決めつけません。PATHへ追加されたディレクトリが現在のシェルへ反映されていない可能性があります。スクリプトの出力に示された設定を確認し、利用中のShellの設定ファイルへ反映します。

初回起動とDeepSeek APIの接続

daoを実行すると、初回ガイドに沿ってAPI Keyを保存する流れになります。KeyはDeepSeekのAPI Key管理画面で発行し、ターミナルの履歴、記事、画面共有へ貼り付けません。

dao

モデル名、設定ファイルの場所、入力項目は更新される可能性があります。そのため、画面を固定的に再現した説明ではなく、DeepSeek API公式文書と当日のDAO-Code READMEの表記を照合します。DeepSeek V4という名称を見かけても、利用可能なモデル名として入力できるとは限りません。選択肢に表示された正式名称を使います。

設定後は、API Keyを環境変数へ複製しないことも重要です。シェル履歴に残るexport、共有リポジトリの.env、スクリーンショットの3点を避けるだけでも、漏えい経路を減らせます。

最小タスクで導入を判定します

インストール成功は、バージョン表示だけでは判断しません。次の順番で、権限と承認の動作まで確認します。

1. 作業用ディレクトリを作成し、対象を読み取り専用の小さなフォルダーに限定します。
2. DAO-Codeへファイル一覧や構成の要約だけを依頼します。最初から削除、移動、インストールを許可しません。
3. 生成されたプロジェクト説明を確認し、実際のファイル内容と照合します。
4. 次に、変更を伴わないコマンドを提案させ、実行前の承認画面を確認します。
5. dao --versionの結果、対象ディレクトリ、権限表示、タスク出力を記録します。

この3段階、つまり読み取り専用スキャン、説明生成、承認付きコマンド実行のすべてが通り、コマンド呼び出しと承認フローが正常なら導入完了と判定します。APIエラーだけでなく、対象ディレクトリを間違えていないかも確認します。

経験上、最初の失敗原因はツール本体よりPATH、API Keyの保存先、対象ディレクトリの権限です。エラー全文を省略せず、dao --versionの結果と同じ記録に残すと再現調査が速くなります。

一時利用と継続開発を分けます

短い確認だけならnpxを選べます。実際のパッケージ名とオプションは、実行時点のREADMEにある表記を使います。

npx dao-code

この方法は、常設バイナリのPATH問題を避けやすい一方、毎回の取得やパッケージ解決を伴う場合があります。DAO-Code本体を修正する場合だけ、npmまたはソース導入へ進みます。ソース導入では、リポジトリ取得、依存関係の導入、README記載の起動コマンドを順に使い、masterのバージョンを正式Releaseと呼ばないようにします。

iOSやmacOSプロジェクトのビルドが目的なら、DAO-Codeの導入とは別にXcodeが必要です。DAO-Code自体のAPI呼び出しやターミナル作業に、XcodeやMetalによるローカルモデル推論を追加する必要はありません。

同じ導入確認を別のMacで再現したい場合は、Macレンタル環境の選び方を確認してください。iOSビルドまで含めるなら、Xcodeを使うリモート開発環境のように、作業内容と接続条件を先に確認します。

よくある質問

Apple SiliconとIntel Macのファイルを間違えた場合

Mシリーズはarm64、Intel Macはx86_64です。uname -mで再確認し、Releaseページから対応資産を取り直します。Rosettaに頼って解決する前に、まずアーキテクチャの選択が正しいか、command -v daoが古いバイナリを指していないかを調べます。

DockerやXcodeを先に入れる必要があるか

DAO-Codeの基本導入だけなら、DockerやXcodeを前提にしません。公式資料にない依存関係を追加すると、権限やPATHの問題が増えます。XcodeはiOS・macOSアプリのビルド工程で必要になる別の要件として扱います。

DeepSeek APIが認証エラーになる場合

API Keyの有効性、保存先、モデル名、利用制限を確認します。Keyを再発行する場合も、古い値をシェル履歴や設定ファイルへ残さないようにします。記事やスクリーンショットへ実際のKeyを表示してはいけません。

Node.jsの版が合わない場合

command -v nodeとnode --versionで、現在呼ばれている実体を確認します。複数のNode.jsが入っている場合はPATHの順序を直し、READMEが指定する条件と照合してから再実行します。版番号だけを見て、masterの0.4.17を正式Releaseと判断しないでください。

DAO-Codeを一度試すだけなら、公式スクリプトかnpxで十分です。ただし、長時間のAgent作業ではMacをオンラインに保つ負担、ローカルの権限汚染、環境を初期化する手間が積み上がります。iOSやmacOSのビルドではXcodeや対象プロジェクトの状態も維持しなければなりません。

そのため、短期の検証や別環境での再現が目的なら、ZekVPSのリモートMacを使う方が、手元のMacを占有せず、同じ验收手順をやり直せます。物理デバイス接続や長期の固定負荷が中心なら自前のMacが適しているため、作業期間と接続要件を比較して選ぶのが安全です。