Claude Codeは、開いている開発フォルダーを調べ、ファイル編集やコマンド実行を伴う作業を支援する開発用の道具です。
アプリへClaudeを組み込むAPIとは役割が異なり、主な利用者はアプリの開発者です。
効果を出すには、完成品を一度に頼むのではなく、調査、計画、変更、検証を一つの作業単位として渡します。
アプリ開発の目的に合う相談先は、外注と学習を目的別に分けた相談ガイドにまとめています。
| 段階 | Claude Codeへ任せること | 開発者が決めること |
|---|---|---|
| 企画 | 既存資料の整理と不足の列挙 | 誰の何を解決するか |
| 設計 | 影響範囲と選択肢の調査 | 採用する構成と制約 |
| 実装 | 指定範囲の編集とテスト追加 | 変更の許容範囲 |
| 検証 | テスト実行と差分の説明 | 合否と次の修正 |
| 公開 | 手順書と確認項目の整理 | 署名、審査、公開操作 |
Claude Codeは開発フォルダーで作業する
通常のチャットは、貼り付けた断片を中心に答えます。
Claude Codeは、許可されたフォルダーの構成を調べ、関連ファイルを読んでから変更案を作れます。
Claude Codeの動作概要では、情報収集、操作、検証を繰り返して作業する仕組みが説明されています。
ただし、フォルダーへアクセスできることと、製品の目的を理解していることは同じではありません。
利用者像、守る仕様、変更禁止の範囲は開発者が言葉にして渡します。
| 頼み方 | 起こりやすい結果 | 改善した依頼 |
|---|---|---|
| アプリを完成させて | 範囲が広く差分を確認しにくい | ログイン失敗時の表示だけを修正する |
| バグを直して | 再現条件が不明なまま推測する | 三つの再現手順と期待値を渡す |
| きれいにして | 見た目と内部構造が同時に変わる | 挙動を変えず一つの画面を分割する |
| テストして | 何を合格とするか揺れる | 指定した二つのコマンドを実行する |
開発支援とAPI組み込みの違いは、Claudeをアプリ開発へ使う方法で先に整理できます。
着手前に四つの材料を渡す
Claude Codeへ最初に渡す材料は、目的、再現条件、制約、合格条件です。
長い仕様書をそのまま置くより、今回の作業に必要な部分を短く切り出します。
- 目的は「通信失敗でも入力内容を失わない」のように利用者の変化で書く
- 再現条件は端末、操作順、現在の結果、期待する結果を並べる
- 制約は変更しない画面、利用中のAPI、対応OSを明記する
- 合格条件は実行するテストと目視確認を示す
既存アプリでは、最初から編集を頼まず、関係するファイルとデータの流れを説明させます。
公式の一般的な作業例には、コードベースの調査、バグ修正、リファクタリング、テスト、編集前の計画といった進め方があります。
調査結果に不足があれば、人が仕様を補ってから編集へ進みます。
この一呼吸で、存在しない前提を基に広い変更が作られる危険を減らせます。
調査から差分確認までを一周させる
一回の依頼は、実装したという報告ではなく、検証可能な差分で終えます。
- 関係するファイルと現在の処理を調べる
- 変更候補と影響範囲を説明する
- 承認した範囲だけを編集する
- テストと静的検査を実行する
- 差分、結果、残る未確認事項をまとめる
Claude Codeのクイックスタートでも、プロジェクトの調査、変更提案、編集、Gitによる差分確認という流れを確認できます。
実行できないテストがある場合は、合格にせず、環境不足と未確認範囲を残します。
履歴管理では一つの依頼を一つの論点へ寄せます。
画面修正、依存関係更新、データ移行を同じ差分へ混ぜると、問題が起きたときに戻す単位が大きくなります。
iOSとAndroidでは実機工程を人が握る
Claude CodeはSwift、Kotlin、JavaScriptなどのコードを扱えますが、公開先の条件を代替しません。
iOSアプリは対応するMac、Xcode、署名、実機かシミュレーターが関わります。
AndroidアプリはSDK、ビルド環境、署名、実機かエミュレーターが関わります。
| 確認対象 | Claude Codeが支援できること | 人が確認する証拠 |
|---|---|---|
| 画面 | コード修正とプレビュー起動 | 対象端末のスクリーンショット |
| 権限 | 設定ファイルと処理の確認 | 実機で許可と拒否を試した結果 |
| 通信 | 失敗処理とテストの追加 | オフラインと遅延時の挙動 |
| 署名 | 手順や設定箇所の整理 | 自分の証明書で作った成果物 |
| ストア | 説明文や確認表の下書き | 開発者が入力した提出情報 |
モバイルアプリの検証観点は、OWASP MASVSで保存、認証、通信、端末機能、プライバシーなどに分けて確認できます。
コードがビルドできても、実機で権限を拒否したときに止まるなら公開品質とはいえません。
3ファイルと2テストに絞る変更の具体例
プロフィール保存時のエラー表示を直す場面を考えます。
最初の依頼で編集対象を3ファイル以内、確認する自動テストを2件に絞ると、差分の目的を追いやすくなります。
| 対象 | 変更内容 | 検証 |
|---|---|---|
| 入力画面 | 送信中と失敗の表示を分ける | 失敗後も入力値が残る |
| 通信処理 | 時間切れを明示的に返す | 時間切れのテストが通る |
| 既存テスト | 正常時の期待値を維持する | 保存成功のテストが通る |
3ファイルを超える必要が判明したら、その理由を聞いて依頼を分割します。
2件の自動テストに加え、通信を切った実機確認を1回行えば、自動検証と利用者の見え方を分けて記録できます。
数字はすべての修正へ当てはめる上限ではありません。
変更を小さくし、失敗したときに原因を追えるかを判断するための目安です。
権限と秘密情報を作業前に点検する
開発フォルダーには、APIキー、顧客データ、本番接続情報が含まれる場合があります。
Claude Codeを開く前に、秘密情報をコードから分離し、不要なフォルダーを作業対象から外します。
コマンド実行では、内容と影響範囲を確認してから許可します。
削除、公開、本番データ更新のように取り消しにくい操作は、検証環境と分け、人が最後の操作を担当します。
Claude Codeのセキュリティ資料を使い、権限、承認、データの扱いを利用環境に合わせて確認してください。
組織の開発手順全体は、NIST SSDFに沿って、準備、保護、成果物、脆弱性対応へ接続できます。
Claude Codeでのアプリ開発によくある質問
Claude CodeとClaude APIは同じものですか？
同じではありません。
Claude Codeは開発者がプロジェクトを調査して編集するための道具で、Claude APIは完成したアプリからモデル機能を呼び出すための接続手段です。
どちらを使うかは、開発者を助けたいのか、利用者へAI機能を提供したいのかで決めます。
Claude CodeはWindowsでも使えますか？
利用可能な環境と導入方法は更新されるため、実際に使う時点の公式クイックスタートで対応条件を確認してください。
スマホアプリを作る場合は、Claude Codeの対応環境とは別に、iOSやAndroidのSDKとビルド条件も必要です。
Claude Codeにすべてのファイル編集を任せてもよいですか？
変更範囲を決めずに任せるのは避けます。
まず関連ファイルを説明させ、守る挙動と合格条件を渡し、差分を確認してから採用してください。
大きな変更は独立した作業領域やブランチで試すと戻しやすくなります。
Claude Codeがテスト成功と報告すれば公開できますか？
テスト成功は重要な証拠ですが、公開判断のすべてではありません。
実行したコマンド、対象範囲、未実行の試験を確認し、実機操作、署名、ストア情報も人が点検します。
小さな差分と検証結果を積み上げる
Claude Codeは、曖昧な企画を一回で完成品へ変える道具ではありません。
目的と制約を渡し、小さな差分を検証可能な状態で積み上げると、開発速度と説明可能性を両立できます。
- 開発フォルダーの理解と製品判断は別の役割である
- 一回の作業は調査、計画、編集、検証までを含める
- モバイル公開にはSDK、実機、署名、審査の確認が残る
- 秘密情報と取り消しにくい操作は人が管理する
次にCodexと進めるアプリ開発を確認すると、作業分担と検証条件を別の開発エージェントでも比較できます。
