Codexアプリ入門

まず全体像

何ができて、どこで使い分けるか。最初にここだけつかむと、身構えずに始められます。Codex（作業を任せる道具）は、質問に答えるだけの道具ではありません。手元の資料やファイルを見せながら、「この下書きを直して」「この資料を読んで要点をまとめて」「このページの見た目を確認して」といった、実際の仕事の一部を任せるための道具です。

ただし、最初から大仕事を丸ごと渡すと、うまくいかないことがあります。新しく入った人に、いきなり全部の仕事を口頭だけで頼むと、ずれやすいのと同じです。まずは小さな仕事を一つずつ切り分けて、どこまで任せると楽になるかを見るのが、失敗しない始め方です。

最初の見方

この道具の役目

Codexは作業を任せる箱

ここでいう「箱」は、仕事を入れて、途中のやり取りと結果を残しておく場所だと思ってください。質問と返事だけの場ではなく、「この案件で、この仕事を、こういう条件で進める」というまとまりを置く場所です。

大事なのは、Codexが最初から事情を全部知っているわけではないことです。社内の決まり、いつもの書き方、触ってはいけない場所は、先に教えないと分かりません。だからこそ、あとで出てくる「案件の分け方」「会話の分け方」「頼み方の型」が効いてきます。

• この道具の役目は、作業の下調べ、下書き、見直し、確認を手伝わせることです。

使い方は4つ

入口は1つではない

Codexは、入る場所が一つではありません。どこから使っても、していることは「作業を任せる」ことです。違うのは、どの画面で進めると楽かです。初めてなら、まずはCodexアプリから入るのがいちばん分かりやすいです。

• Codexアプリ

  画面で整理しながら使います。案件や会話を見失いにくく、初めての人向きです。「今どの仕事をしているか」を目で追いやすいのが利点です。

• VS Code拡張

  VS Code（ファイルを開いて直すための道具）の中で使います。ふだんからその画面で作業する人には便利ですが、触り慣れていない人は、まずアプリからで十分です。

• コマンド操作

  文字入力だけで素早く使います。速さはありますが、見える情報が少ないので、最初の一歩には向きません。慣れた人が手早く進める入口です。

• クラウド

  手元ではない外の作業場所で、続きを動かします。自分のパソコンを閉じても進めたいときに便利ですが、まずは「手元でどう動くか」を知ってから使うほうが安心です。

アプリの中は3通り

まず作業場所を選ぶ

アプリを開いたら、最初に考えるのは「どこで作業させるか」です。ここを何となく選ぶと、見てほしいものが見えていなかったり、逆に触ってほしくないものまで触れる状態になったりします。仕事を始める前の机選びだと思ってください。

ローカル

今のパソコンで、そのまま作業します。手元の資料や今開いている案件を使いたいときに向いています。最初はここから始めると分かりやすいです。

ただし、手元にあるものがそのまま見えるぶん、どの案件を開いているかは自分でも確認が必要です。違う案件のフォルダを開いたまま始めると、前提がずれます。

クラウド

外の作業場所で、手元とは別に進めます。自分のパソコンを閉じても続けやすいのがよい点です。時間のかかる確認や、あとで見返したい作業に向いています。

一方で、手元と別の場所なので、「今そこに何が置いてあるか」を意識しないと迷いやすくなります。最初はローカルで慣れてから使うと混乱しにくいです。

ワークツリー

同じ案件の作業用コピーを分けて、並行で進めます。たとえば、本番で使っているものに触れずに、別の案を試したいときに役立ちます。

身近に言えば、元の資料を残したまま「修正版その1」「修正版その2」を分けて作る感覚です。複数の直し案を比べたいときに便利ですが、最初は「別の作業コピー」と覚えれば十分です。

案件は一覧で開く

左の一覧が出発点

まず案件を選んでから会話を始める

左の一覧には、今まで扱った案件が並びます。ここを飛ばしていきなり話し始めると、どの仕事の話か曖昧になりやすいです。まず案件を選び、その案件の中で会話を始める。この順番が基本です。

新しく始める仕事なら、新しい案件を作って分けたほうが安全です。前の案件の資料や会話が混ざると、Codexも人と同じで勘違いしやすくなります。少し面倒でも、出発点をそろえるほうが、あとで楽になります。

• 左の一覧が出発点です。迷ったら、今開いている案件名を見直してください。

会話の切り方

長いやり取りを防ぐ

1つの会話に1つの仕事

ここはとても大事です。一つの会話の中に、別の仕事を次々入れないでください。最初は「見出しを直す話」をしていたのに、途中で「別ページの確認」や「説明文の書き換え」まで混ぜると、前の条件と新しい条件がからみます。

たとえば、「お知らせ文の下書き」と「見積もり案内の言い回し直し」は、どちらも文章の仕事ですが、目的も読み手も違います。だから会話も分けます。新しく入った人に頼みごとをするときも、一度に違う仕事を混ぜると取り違えやすいのと同じです。

• 仕事ごとに会話を分けると、話が混ざらないです。
• アプリを閉じても、会話が残りやすいので、あとで続きをしやすいです。

頼み方の型

出力がぶれにくくなる4点です。ここでいう出力とは、返ってくる下書きや提案、修正内容のことです。頼み方が長いほどよいわけではありません。大事なのは、必要な点だけ抜けなく伝えることです。

うまくいかない依頼は、「いい感じに整えておいて」のように、目的も条件も終わり方も曖昧なことが多いです。逆に、短くても要点がそろっていれば、かなり安定します。

依頼文は4点だけ

難しく書かない

頼む文は、長い作文にしなくて大丈夫です。次の4点を順番に置けば十分です。社内で仕事を引き継ぐときのメモに近い形です。

• 目的

  何を作るかを最初に言います。たとえば「案内文の下書きを作る」「今ある説明をやさしく直す」のように、到着点を先に示します。

• 手がかり

  見るべき資料や場所を伝えます。「このフォルダの資料を見る」「前回の文面を参考にする」といった情報です。手がかりがないと、見当違いの場所を見に行きます。

• 守る条件

  外せない決まりや前提を書きます。「言い切りは避ける」「専門用語を使わない」「削除はしない」などです。ここを省くと、できあがりは良く見えても使えないことがあります。

• 終わりの形

  何ができたら完了かを先に決めます。「見出しと本文を直した案を1つ出す」「変更点を箇条書きで添える」などです。終わり方が決まっていると、余計な作業が減ります。

先に計画だけ

Planモード

まず段取りを出させる

大きめの仕事では、いきなり作り始めさせないほうが安全です。まず「何をどの順番で進めるか」だけを出してもらいます。これがPlanモードです。料理で言えば、いきなり火をつける前に、材料と手順を並べる段階です。

計画だけを先に見ると、勘違いが早い段階で見つかります。「その資料は見なくてよい」「先に見た目ではなく文章を直してほしい」といった軌道修正が、まだ軽いうちにできます。大きい仕事ほど、この一手が効きます。

• いきなり作らせず、先に手順を並べさせると安心です。
• 大きい仕事ほど、この一手で失敗が減ります。

小さく試す

Codexを一度動かす

まず小さな依頼で動き方を見る

本番の仕事に入る前に、一度だけ小さく試してください。たとえば「この資料の要点を三つにまとめて」「この一段落だけやさしく直して」といった短い依頼です。ここで見るのは、賢さの勝負ではなく、あなたの仕事との相性です。

試すときは、返事の内容だけでなく、どこを見て、どんな確認をしてくるかも見ます。必要な資料が足りないときに質問してくるか。勝手に決めつけて進まないか。そうした癖が分かると、次の頼み方を調整しやすくなります。

• Codexを一度動かして、動き方と返し方を先に見ておきます。

考えさせ方は盛りすぎない

まず中くらい

考える強さをいつも最大にすればよい、というものではありません。小さな直しに重たい考え方を使うと、時間がかかったり、必要以上に話が大きくなったりします。まずは中くらいを基本にしてください。

• ふだんは中くらい

  ちょっとした修正や確認なら、これで十分なことが多いです。迷ったときの標準です。

• 深く考えさせる

  複雑な不具合や、大きな変更のときだけ使います。前提が多い仕事ほど向いています。

• 速さを優先する

  急ぎの小さな仕事で使い分けます。ただし、見落としやすくなるので、最後の見直しは自分で行います。

整えて強くする

毎回の説明を減らし、安全に使うための話です。使い始めの失敗は、多くが「同じことを毎回打つ」「触ってよい範囲が曖昧」の二つから起きます。ここを整えると、頼むたびに楽になります。

人に仕事を渡すときも、最初に共通ルールを書いた引き継ぎ書があると楽です。それと同じ考え方です。

同じ注意は書き置く

agents.md

毎回言うことは先に置く

agents.md（毎回の注意を書いておくメモ）は、共通ルールの置き場所です。書き方の決まり、避けたい言い回し、勝手に削除してほしくないものなど、何度も伝えることを先にまとめておきます。

たとえば、「専門用語は使わない」「元の意味を変えない」「新しい案を出す前に今の内容を要約する」といった方針です。これがあると、会話のたびに同じ説明を打たなくてすみます。ただし、その仕事だけの特別な条件は、会話の中でもう一度伝えたほうが安全です。

• 作り方の決まりや、してほしくないことを書きます。
• 同じ指示を毎回打たなくてよくなります。

安全設定は3段階

最初は弱く開けない

最初のうちは、「何でも自由にしてよい」状態にしないでください。慣れていないときほど、確認の手間より安全を優先します。まず見せるだけにして、どんな直し方をするか見てから、少しずつ任せる範囲を広げます。

• 見るだけ

  まずは内容確認に使います。読み取りと提案だけさせる段階です。初回はここから始めるのが安心です。

• 書き込み可

  修正まで任せたいときに使います。提案が安定してきたら、この段階に進みます。

• 全面許可

  できることが増えるぶん、思わぬ変更も起きやすくなります。慣れるまでは常用しないほうが安全です。

見た目はその場で確かめる

内蔵ブラウザ

文章だけでなく、見た目もその場で確認する

文章の直しは、文章だけ読んでいても足りません。見出しが長すぎて折り返していないか、ボタンの位置がずれていないか、読みやすさが保たれているかは、実際の見た目で確かめる必要があります。内蔵ブラウザは、その確認をその場でしやすくするための画面です。

特に、画面に出る案内文や説明文は、文として正しくても見た目で読みにくいことがあります。文字だけで満足せず、必ず一度は画面で見てください。

• 内蔵ブラウザで、直した後の見え方まで確認します。

直しは差分で見る

GitHub

GitHub（変更点を見比べやすい場所）では、どこが直ったかを差分で見ます。差分とは、変わった部分だけを抜き出して比べる見方です。全部を読み直すより、どこを触ったかが分かりやすくなります。

この画面では、足された行だけでなく、消えた行にも目を向けてください。頼んでいない場所まで変わっていないか、関係ない削除が入っていないかを見るためです。

図では、変更された場所のまとまりと、ファイルの一覧を見てください。直してほしかった場所だけが変わっているか、余計な変更が混ざっていないかを確認するのがポイントです。

自動化は後回し

n8n

n8n（作業をつないで自動で回す道具）のような自動化は、便利そうに見えます。ですが、最初からそこに進むと、うまくいかない理由が分からなくなりやすいです。まずは手で一回ずつ回して、「どう頼むとよいか」「どこで確認が必要か」を固めるほうが先です。

自動化は、毎回やる流れが安定してからで十分です。仕事の形が決まっていないうちに自動化すると、間違った流れをそのまま繰り返してしまいます。

図では、作業が矢印でつながっていく見え方を見てください。見た目は分かりやすくても、途中の確認を飛ばしやすいので、最初は「仕組みを作る」より「正しい手順を決める」ことを優先します。

まとめ

最初の失敗を減らす使い方は、難しい設定よりも、作業の分け方で決まります。明日やることは多くありません。まずは小さく始めて、確認しながら広げていけば大丈夫です。

• 最初に作業場所を選ぶ
• 会話は1仕事ごとに分ける
• 依頼文は4点でそろえる
• 大きい仕事はPlanから始める
• 安全設定と見直しを先に整える

最後に

AI図書館

フォローといいね、お願いします

AIを仕事で使う話を、やさしく1本ずつ出しています。難しい言葉を覚えるより、明日どう動くかが分かることを大切にしています。

• AIを仕事で使う話を、やさしく1本ずつ出しています。
• 次の回もここで会いましょう。