はじめに02 / 16
インストールと準備
このページの内容
まず Noea デスクトップアプリをインストールし、少なくとも一つのコーディング Agent を準備します。インストール、ログイン、接続の検証はアプリが案内します。
インストーラを選ぶ
Noea のダウンロード欄で、OS とプロセッサに合う版を選びます。
| システム | 選び方 |
|---|---|
| macOS | Apple silicon、macOS 13 以降。Intel Mac 用インストーラは現在提供していません。 |
| Windows | Intel / AMD は x64、Windows on ARM デバイスは ARM64。 |
| Linux | プロセッサに合わせて x86_64 または ARM64。AppImage と .deb を提供しています。 |
macOS はディスクイメージを開いてインストールします。Windows はインストーラを実行します。現在のユーザー向けにインストールされ、管理者権限は不要です。Linux はディストリビューションに応じて AppImage または .deb を使います。
最初の Agent を準備する
Noea 起動時に準備完了の Agent がない場合、セットアップガイドが開きます。
- 一覧で Agent を選び、インストールをクリックします。
- ダウンロードを待ち、詳細パネルに従ってログインしてアクセスを許可します。
- Noea が接続を検証するのを待ちます。準備完了だけが検証合格を意味します。
- Noea の使用を開始する項目を選び、ワークベンチに進みます。
現在、Codex、Claude Code、OpenCode、CodeBuddy Code に対応しています。開始時は一つで十分です。後から設定 → エージェントで追加できます。
必要なランタイムは Noea がダウンロードするため、事前に Node.js をインストールする必要はありません。ダウンロードと準備の進行状況はアプリ内に表示されます。
Agent に応じた方法でログインする
ログインではブラウザ、アプリ内ターミナル、システムのターミナルが開く場合や、API キーの入力を求められる場合があります。選んだ Agent の案内に従ってください。
Codex は macOS と Windows ではブラウザ、Linux ではデバイスコードによるログインを優先します。OpenCode はモデルプロバイダーに接続して設定します。アカウント、API キー、カスタムエンドポイントはAgent、モデル、使用量をご覧ください。
ログイン後、Noea は再度接続を検証します。ログイン要求や失敗が続く場合は、Agent の詳細パネルで理由を確認します。
別のターミナルツールで Agent を使っていても、ここで使用可能かどうかは Noea の一覧の状態で判断してください。
ダウンロードや検証の問題を解決する
ダウンロードと Agent のリクエストはシステムの HTTP(S) プロキシ設定を使います。プロキシ環境変数がある場合はそちらが優先されます。この仕組みは SOCKS プロキシには対応していません。
ダウンロードが失敗したらネットワークとプロキシを確認し、同じ場所から再試行します。データ受信が短時間止まった際の準備中表示は、必ずしも失敗ではありません。
インストール後の検証が失敗したら、詳細パネルで再ログイン、プロバイダー設定の修正、ネットワーク問題の解決を行います。相談時は診断情報をコピーできます。トラブルシューティングをご覧ください。
プロジェクトを開く
ワークベンチでフォルダを開く…を選び、コードのフォルダを指定します。Noea はリンクされたプロジェクトを開くか作成します。最初のチュートリアルに完全な要件書、MCP サーバー、Skills は不要です。
最初のワークフローに進みましょう。