
AIコーディングエージェントを用意する。Claude CodeとCodexの始め方
このシリーズのStep 1です。最初の記事でこのシリーズの完成形(スマホでAIに資産状況を聞ける状態)を紹介しています。
すでにClaude DesktopまたはCodexのアプリが手元で動いている方は、Step 2の記事からお読みください。
AIエージェントとは、日本語で指示するだけでコードを書いたりファイルを作ったりしてくれるソフトです。このシリーズのコードは全部エージェントに書いてもらう前提です。Pythonを書けなくても大丈夫です。
エージェントが手元で動くようになると、以降のStepで「次は何をすればいい?」「この画面で何を押せばいい?」「このエラーは何?」と聞くだけで答えてくれます。詰まったときに聞ける相手を先に用意するのが、このStepの目的です。
Claude Code と Codex、それぞれの特徴
どちらも日本語で指示して手元のファイルを操作できるデスクトップアプリです。このシリーズの手順を進めるにはどちらでも大きな差はありません。好みで選んでください。
Claude CodeはAnthropic製で、Claudeが裏で動きます。普段Claude.aiを使っていて慣れている方向け。利用にはClaude のPro / Max / Team / Enterprise いずれかのサブスクリプション契約が必要です(Freeプランでは使えません)。
CodexはOpenAI製で、GPT系のモデルが裏で動きます。普段ChatGPTを使っている方向け。ChatGPT Plus以上のプランに含まれます(ChatGPTを契約していればそのまま使えます)。2026年のアップデートで他のアプリの画面を見て操作するComputer Use機能、画像生成、ブラウザプレビューなどが足されています。
Claude Desktop のインストール
https://claude.ai/download を開きます。
ページ中央に「Windows版をダウンロード」「Mac版をダウンロード」のような大きなボタンが並んでいます。Windowsなら「Windows版をダウンロード」、Macなら「Mac版をダウンロード」を押します。Windowsはインストーラー(.exe)がダウンロードされるので開いて画面の指示に従って進めれば完了です。Macは.dmgファイルを開き、Claude.appをApplicationsフォルダにドラッグします。
インストール後にアプリを起動するとAnthropicへのログイン画面が出ます。https://claude.ai でアカウントを作り、メールアドレスとパスワードでログインします。
Chat / Cowork / Code タブの違い
Claude Desktopアプリには画面左上に Chat / Cowork / Code の3つのタブが並んでいます。ログイン直後は Chat タブ(Claude.aiと同じ通常の対話画面)が開くため、ここで迷いやすいポイントです。それぞれの違いは次の通り。
- Chat: 通常の会話。手元のファイルには触れない。Claude.aiの対話画面と同じ
- Cowork: クラウド上の仮想環境でClaudeが自律的に作業するモード。裏で走らせて他のことに戻るイメージ
- Code: Claudeがあなたのパソコン上のファイルを直接読み書きするモード。このシリーズで使うのはここ
画面左上の「Code」タブをクリックして切り替えます。「アップグレードが必要」と出た場合はサブスクリプション未契約なので先に契約が必要です。
Code タブでプロジェクトを選ぶ
Code タブに切り替えると「プロジェクト」の選択画面が出ます。プロジェクトとは、Claudeが読み書きする対象のフォルダのことです(Claudeはこのフォルダの中だけで作業します)。
手順:
1. 環境は「Local」を選びます(あなたのパソコン上で直接動かす)。Remote(クラウド実行)やSSHも選べますが、このシリーズではLocalでOK
2. 「Select folder」ボタンを押して、このシリーズ用の作業フォルダを指定します。まだ無ければエクスプローラー(Windows)またはFinder(Mac)で「portfolio-ai」のような名前の新しいフォルダを作ってから選びます
3. モデルは送信ボタンの左のドロップダウンから選びます。初めてならデフォルトのままで構いません
Windowsの場合、ローカル実行には Git が必要です。https://git-scm.com/downloads/win からインストーラーをダウンロードして入れておきます。Macには標準で入っているのでそのままで大丈夫です。
プロジェクトを指定すると、画面下部に入力欄が出ます。ここが最初にチャットする場所です。試しに次のように入力して Enter キーを押してみてください。
「test.pyというファイルを作って。中身は『hello』と表示されるだけのPython」
Claudeが差分を見せてくれるので、内容を確認して「Accept」をクリックするとプロジェクト内に test.py が作られます。ファイルが作られれば準備完了です。
Codex のインストール
https://developers.openai.com/codex/app を開きます。
ページ中央の「1. ダウンロードしてインストール」の下に「macOS(Apple Silicon)版をダウンロード」の大きなボタンと、その下に「別のオペレーティングシステムが必要ですか?」として「Windows版をダウンロード」「Linuxの通知を受け取る」のリンクが並んでいます。Windowsなら「Windows版をダウンロード」をクリック。Microsoft Storeが開くので「入手」ボタンでインストールできます。Macなら自分のMacに合ったボタン(Apple Silicon / Intel)をクリック。.dmgを開いて指示通り進めれば完了です。
インストール後にアプリを起動するとOpenAIへのログイン画面が出ます。ChatGPTアカウントでサインインします。
Codex でプロジェクトを選ぶ
サインイン後、Codex は「プロジェクトを選択してください」の画面を出します。プロジェクトとは、Codex が読み書きするフォルダのことです。Claude Code 側の呼び名と同じ意味合いです。過去にCodexを使ったことがあれば履歴のプロジェクトも並びます。
手順:
1. 「Select a project folder」のボタンで、このシリーズ用の作業フォルダを指定します。まだ無ければエクスプローラー(Windows)またはFinder(Mac)で新しいフォルダ(例:「portfolio-ai」)を作ってから選びます
2. 実行モードは「Local」を選びます。これでCodexがあなたのマシン上で直接動きます(もう一つの「Cloud」を選ぶとOpenAIのサーバー上で動き、手元のファイルには反映されません)
プロジェクトを選ぶとメイン画面にチャット領域が開きます。画面左のサイドバーに「New thread」「Automations」「Skills」などの項目、右側のメイン領域の下部に入力欄があります。ここが最初にチャットする場所です。試しに次のように入力して送ります。
「test.pyというファイルを作って。中身は『hello』と表示されるだけのPython」
指定したプロジェクトフォルダの中に test.py が作成されれば準備完了です。公式ドキュメントはタスク実行の前後でGit checkpoint(コミット)を取ることを推奨していますが、このシリーズでは深く触れません。
料金について
Claude Code Desktop はClaudeの Pro / Max / Team / Enterprise プラン(月額)のどれかが必要。Codex はChatGPTのPlus以上のプラン(月額)に含まれます。どちらも月数千円程度で、このシリーズの範囲ならこれ以上の費用は発生しません。
Step 2 へ
エージェントが動いてチャット応答が返ってきたら完了です。Step 2では、このエージェントに自分の資産データを読み込ませる仕組みを作ってもらいます。
このシリーズの完成形(スマホから AI に資産を聞ける状態)はフック記事で紹介しています。手順全 6 記事を通した後、動いた後の運用(エラー対処、セキュリティ設計、データ設計)はZenn Book「自分のポートフォリオをAIに相談する — 動いた後の運用設計ガイド」に体系化しています。