AI開発企業が実践｜生産性爆上げCodex初期設定

こんにちは！株式会社オレンジアーチ 広報です🍊

最近よく耳にするAIエージェント、ClaudeやPerplexityなど、さまざまなAIツール・AIエージェントが登場し、私のような広報や人事の現場でも、AIを活用する機会が実際に増えています。

Codex CLIは設定次第で安全性も生産性も大きく変わるツールなので、

今回は、私が実践している「最初に整えるべき3つの設定」をご紹介！

まずはCodexをインストールしてみよう

初心者向けには、最も迷いにくいCodexデスクトップアプリから解説。

CodexにはCLIやIDE拡張機能など複数の利用方法がありますが、初めての方には画面操作で進められるCodexアプリがおすすめです。

1. Codexの公式ページを開き、使用しているPCに合ったアプリをダウンロードします。
2. ダウンロードしたインストーラーを開き、画面の案内に沿ってインストールします。
3. Codexを起動し、普段使用しているChatGPTアカウントでサインインします。
4. 「Add project」から、Codexに作業してもらうフォルダやGitリポジトリを選択します。
5. プロジェクトを開いたら、画面の入力欄にCodexへ依頼したい内容を入力します。
6. 最初は「このプロジェクトの構成を説明して」と依頼し、正しく読み込めているか確認しましょう。

※macOS版とWindows版があります。

🧑‍💻私がCodexを使いこなすための3つの設定習慣

① 権限（承認ポリシー・サンドボックス）は「絞って始める」

Codexは、~/.codex/config.tomlによるユーザー共通設定と、リポジトリ内の.codex/config.tomlによるプロジェクト固有設定を使い分けられます。

設定は、コマンドライン引数、プロジェクト設定、プロファイル設定、ユーザー設定、システム設定、デフォルト値の順で優先されます。

導入初期は、以下のような設定から始めるのがおすすめです。

sandbox_mode = "workspace-write"
approval_policy = "on-request"sandbox_mode = "workspace-write"
approval_policy = "on-request"

都度確認できる設定のまま始め、挙動を見ながら段階的に緩めるのがおすすめです。

② AGENTS.mdで「何を守ってほしいか」を伝える

config.tomlがCodexの「動作そのもの」を決めるのに対して
AGENTS.mdはCodexにプロジェクトの前提や作業ルールを伝える
説明書のような役割を持ちます。

ビルド・テストの実行方法、触ってほしくないディレクトリ、「変更したら検証し、結果を確認してからコミットする」という検証ループを明記しておくと、Codexが自律的に作業を進める際の基準になります。

AGENTS.mdはグローバル（~/.codex/AGENTS.md）→リポジトリ→作業ディレクトリの順にマージされ、より局所的な指示ほど優先されるため、プロジェクトごとに柔軟な制御が可能です。

③ プロンプトに「Goal・Context・Constraints・Done when」を含める

効果的なプロンプトには、次の4つの要素を含めることが重要です。

1. Goal
   何を作りたいか、何を解決したいか
2. Context
   関係するファイルやドキュメント、現在の状況
3. Constraints
   従うべきコーディング規約やセキュリティ要件、変更してはいけない範囲
4. Done when
   テストが通る、バグが再現しなくなるなどの完了条件

例えば、単に「このバグを直して」と依頼するのではなく、以下のように伝えます。

Goal：
ログイン後に画面が白くなる問題を修正してください。

Context：
src/authとsrc/pages/dashboardを確認してください。

Constraints：
既存の認証方式は変更せず、新しいライブラリも追加しないでください。

Done when：
既存テストがすべて通り、ログイン後にダッシュボードが正常に表示されること。Goal：
ログイン後に画面が白くなる問題を修正してください。

Context：
src/authとsrc/pages/dashboardを確認してください。

Constraints：
既存の認証方式は変更せず、新しいライブラリも追加しないでください。

Done when：
既存テストがすべて通り、ログイン後にダッシュボードが正常に表示されること。

目的や制約、完了条件を具体的に伝えることで、Codexが作業範囲を判断しやすくなり、意図しない大規模な変更も防ぎやすくなります。

最後にご紹介！
【オレンジアーチってどんな会社？】

• オレンジアーチの東京本社は、御徒町駅・上野広小路駅から徒歩1分！🚇
  
• 社員97%がエンジニア！ 東京・大阪を拠点に、社会インフラを支えるIT企業です。
  
• 客先常駐でも「絶対1人にさせない」！ 必ず先輩がいるチーム（3〜30名）で配属されます。
  
• 実働7.5h＆残業月14hで超ホワイト、 手厚い資格支援や面談で上流へのステップアップも応援しています。

時代が変わっても必要とされ続けるエンジニアへ。
私たちと一緒に、ワクワクする未来を作っていきませんか？

＼「話を聞きに行きたい」ボタンから、皆様とお話しできるのを楽しみにしています／