コーディングエージェントのインストール — CLI・デスクトップアプリ・VS Code 拡張機能

生徒が光るスキルカートリッジを1つ持ち、そこから出たケーブルが6台の違うターミナルロボットにつながって、6台とも同じように光る絵

まずは言葉から

ツール・エージェント・ハーネスとは何ですか？

やのようなは一つですが、見る立場によって、、という三つの名前で呼ばれます。この三つの言葉を先に知っておくと、このページの残りがすっと読めます。

Claude CodeCodexHermes Agent 同じプログラム、三つの名前

ツール(Tool)

人が使う道具として見るとき

ツールは道具という意味です。人がコンピューターとを使うための道具で、Claude Code や Codex がツールです。こうしたツールはエージェントコーディングツール(agentic coding tool)とも呼ばれます。

You → Tool → Computer + AI
エージェント(Agent)

モデルとハーネスを合わせたものとして見るとき

エージェントは、自分でいくつもの手順を踏んで仕事をやり遂げる AI です。広い意味では、エージェントはとハーネスを合わせたものです — はこれを "Agent = Model + Harness" と書いています。だから Claude Code の中でモデルが動くと、二つを合わせてエージェントと呼びます。

Agent = Model + Harness
ハーネス(Harness)

モデル以外の部分として見るとき

広い意味では、ハーネスは AI モデル以外のすべて、つまりモデルを包んで仕事をさせるあらゆる AI ツールのことです。ファイルを読む、コマンドを実行する、許可を求める、結果をモデルに返す、といったことをハーネスが受け持ちます。だから Claude Code、Codex、はどれもハーネスです。

Harness = Agent − Model

最近はツールをハーネスやエージェントとも呼びます

最初はこうしたプログラムを単にツールと呼んでいました。今は、モデルを包む部分を言うときはハーネス、モデルまで含めて働く姿全体を言うときはエージェントと呼びます。三つの名前はどれも正しく、指しているのは同じプログラムです。

Agent = Model + Harness を詳しく見る

このページの6つのツール

大事な考え方

エージェント = モデル + ハーネス

LangChainは1行でこう言います。

Agent = Model + Harness. If you're not the model, you're the harness.

LangChain — The Anatomy of an Agent Harness (新しいウィンドウ)

モデル以外の・設定・は、すべてハーネスの一部です。モデルだけでは文章を予測するだけです。ハーネスがモデルを、ファイルを読み、コマンドを実行し、仕事が終わったら止まるエージェントにします。

エージェント

ターミナルであなたが話しかける相手

モデル

考える — 渡されたものをすべて読み、次の言葉かを予測する

ハーネス

それ以外のすべて — 入力を組み立て、ツールを実行し、ループを回し続ける

AGENTS.mdの読み込み
ツール — ファイル、、Web、
と承認
サンドボックス
ループ
と圧縮
セッションとー

光る脳の玉に、ノート・レンチ・画面・盾・錠前・ループの矢印などの道具が詰まったロボットの枠を足すと、胸にその玉を入れてノートパソコンで働く小さなロボットになる絵

ハーネスは6つ、モデルはたくさん

Claude Code・Codex・・・・agyは、すべてハーネスです。それぞれ違うモデル — Claude、、、Grok、Kimi、OpenCodeならほとんどどのモデルでも — を包んでいますが、ハーネスのする仕事はどれも同じです。だから、このページの習慣はツールからツールへそのまま持っていけます。

ハーネス — 3つの見方

プロンプトから報告まで

エージェントループを1ステップずつ

実際の1つの依頼が、の中でどう進むか追ってみましょう — 「押しても何も起きない登録ボタンを直して、テストを追加して」。仕事が確かめられるまで、モデルとハーネスが交代で動きます。

だれがするかあなた — 頼んで、承認するモデル — 考えて、決めるハーネス — 入力を組み立て、ツールを実行し、権限を確かめる

エージェントループ

あなた あなたのプロンプト あなたが入力した依頼
ハーネス 入力を組み立てる 指示、ツール、AGENTS.md、会話の履歴
モデル モデルの推論 ツール呼び出しか文章で答える
ハーネス ツールを実行 権限チェック、サンドボックス、承認
ハーネス 結果を足す 新しい出力を持ってモデルに戻る
モデル 最終報告 ツール呼び出しのない文章でターンが終わる

矢印は順番に進みます。太い矢印がループです — ツールの結果はすべてモデルに戻ります。点線の矢印は、モデルがツール呼び出しなしで文章だけで答えたときにだけ通ります。

1
ステップ 1 · あなた

プロンプトが届く

依頼を入力してEnterを押します。ハーネスはあなたの言葉をユーザーメッセージとして包み、入力のいちばん最後に置きます。
出てくるもの
```
{"type": "message", "role": "user",
 "content": [{"type": "input_text",
   "text": "Fix the signup button that does nothing and add a test"}]}
```
2
ステップ 2 · ハーネス

ハーネスが入力を組み立てる

モデルがあなたの言葉を見る前に、ハーネスが必要なものを集めます — ハーネス自身の指示、モデルが呼べるツールの一覧、サンドボックスといつ承認を求めるかの説明、AGENTS.mdファイル、作業フォルダーとシェル。次のターンからは、それまでの会話全体も入ります。
出てくるもの
```
instructions  base instructions for the model
tools         shell · update_plan · web_search · mcp__…
input
  developer   <permissions instructions> sandbox · approval
  user        AGENTS.md  (project root → cwd)
  user        <environment_context> cwd · shell
  user        "Fix the signup button …"
```
3
ステップ 3 · モデル

モデルが考える

ハーネスが入力をモデルに送ります。モデルの答え方は2つだけです — あなたへのメッセージか、ツール呼び出し(「このシェルコマンドを実行して」のような小さなの依頼)です。モデルが自分であなたのコンピューターに触れることはできません。
出てくるもの
```
{"type": "function_call", "name": "shell",
 "arguments": "{\"command\":\"rg -n signup src\"}",
 "call_id": "call_1"}
```
4
ステップ 4 · モデルハーネス

コンテキストを集める

ボタンを直すには、まずボタンを見つけなければなりません。そこでモデルは読むためのツールを頼みます — rgでコードを探す、フォルダーの一覧を見る、ファイルを読む。Claude Codeはこの段階を「gather (コンテキストを集める)」と呼びます。
出てくるもの
```
$ rg -n signup src
src/components/SignupButton.jsx:8:  <button type="button">Sign up</button>
src/api/auth.js:21:export async function signup(email, password) {
```
5
ステップ 5 · ハーネス

ハーネスがツールを実行する

ハーネスが権限を確かめます。許可されていて、サンドボックスの中ですか? それなら実行します。まだ許可されていませんか? それなら先にあなたに聞きます。そのあと、と出力を会話に足して、もう一度モデルに聞きます。この行き来がループで、1つの依頼で何十回も回ることがあります。
出てくるもの
```
{"type": "function_call_output",
 "call_id": "call_1",
 "output": "src/components/SignupButton.jsx:8: …"}
```
6
ステップ 6 · モデルハーネス

ファイルを変える

コードがわかると、モデルは編集を頼みます — ファイルの一部を置きかえる新しい文章です。ハーネスがそれを書き込み、あなたはで見られます。Claude Codeは編集の前ごとにチェックポイントを保存するので、ます。
出てくるもの
```
--- a/src/components/SignupButton.jsx
+++ b/src/components/SignupButton.jsx
-  <button type="button">Sign up</button>
+  <button type="button" onClick={() => signup(email, password)}>
+    Sign up
+  </button>
```
7
ステップ 7 · モデルハーネス

コマンドを実行する

次にモデルは、シェルでテストやを実行するよう頼みます。フォルダーの外のものを変えられるコマンドこそ、承認とサンドボックスが大事になる場面です。
出てくるもの
```
$ npm test -- SignupButton
```
8
ステップ 8 · モデル

確かめる

モデルがテストのログを読みます。テストが失敗したら、コードを読む・直す(ステップ4と6)に戻って、もう一度テストを実行します — テストが通るまで、または行き詰まって止まり、あなたに聞くまで。
出てくるもの
```
FAIL  SignupButton.test.jsx
  ✕ calls signup when clicked
… fix → run again …
PASS  SignupButton.test.jsx
  ✓ calls signup when clicked
```
9
ステップ 9 · モデルハーネス

最終報告

モデルがツール呼び出しなしで文章で答えると、ターンが終わります。ハーネスはまとめを表示し、操作をあなたに返します。よい報告には、何を変えたか、テストの結果、確かめていないことが書かれています。
出てくるもの
```
{"type": "message", "role": "assistant",
 "content": [{"type": "output_text",
   "text": "Connected the button to signup() and added SignupButton.test.jsx. npm test passes."}]}
```

会話はターンごとに長くなる

ターンごとにツール呼び出しと結果が足され、一覧全体がもう一度送られます。 — モデルが一度に読める最大の量 — が少しずつ埋まっていきます。

新しい呼び出しと結果指示、ツール、AGENTS.md ターン 1
新しい呼び出しと結果これまでの呼び出しと結果指示、ツール、AGENTS.md ターン 2
新しい呼び出しと結果これまでの呼び出しと結果これまでの呼び出しと結果指示、ツール、AGENTS.md ターン 3
まとめ指示、ツール、AGENTS.md 圧縮のあと

指示、ツール、AGENTS.md
これまでの呼び出しと結果
新しい呼び出しと結果
まとめ

プロンプトキャッシュ

Codexでは、前の入力が新しい入力の先頭部分とまったく同じなので、が前の計算を再利用できます。会話の途中でツール・モデル・サンドボックス・承認モード・作業フォルダーを変えると、その先頭部分が崩れて、次の依頼が遅くなります。
圧縮

会話が長くなりすぎると、ハーネスは会話を短いまとめに置きかえて続けます。Codexは上限を超えると自動で行います。Claude Codeも自動で行い、焦点を決めて/compactを実行することもできます。会話の最初のほうのルールは消えることがあるので、ずっと守るルールはAGENTS.mdに書きましょう。
承認とサンドボックスはハーネスの仕事

モデルは頼むだけです。コマンドを実行するか、あなたの承認を待つか、止めるかはハーネスが決めます。Codexのサンドボックスは自分のシェルツールにだけかかります — MCPツールは自分で制限を守る必要があります。

CodexとClaude Code — 同じループ、違う細かいところ

CodexとClaude Codeはループをどう説明しているか
テーマ	Codex	Claude Code
名前	エージェントループ(agent loop) — アシスタントのメッセージがターンを終えるまで、とツール呼び出しがくり返されます。出典 (新しいウィンドウ)	ループ(agentic loop) — コンテキストを集める、行動する、結果を確かめる。この段階はまじり合います。出典 (新しいウィンドウ)
会話	依頼のたびに会話の履歴全体を送り直すので、1つ1つの依頼がそれだけで成り立ちます。出典 (新しいウィンドウ)	すべてのメッセージ・ツールの使用・結果が~/.claude/projectsの下のファイルに保存されるので、再開や分岐ができます。出典 (新しいウィンドウ)
圧縮	auto_compact_limitを超えると、専用の圧縮で自動で行います。出典 (新しいウィンドウ)	上限の近くで自動で行います。焦点を決めた/compactで、必要なものを残せます。出典 (新しいウィンドウ)
安全	サンドボックスと承認のルールをモデルに伝え、シェルツールで守らせます。出典 (新しいウィンドウ)	権限モード(Shift+Tab)と、ファイルの編集を元に戻すチェックポイント。出典 (新しいウィンドウ)

Codexの内容はOpenAIの記事から、Claude Codeの内容はAnthropicのドキュメントから取りました。ほかのツールも同じループで動きますが、ここまで詳しくは公開していません。

比べる

ツールごとにできること

どのマスも確かめた場所にリンクしています — 公式ページ、または2026-10-26に見たそのツールのの出力です。

表の見方ありなしあり(名前が違う) 未確認

6つのコーディングエージェントCLIの共通機能
機能	Claude Code	Codex CLI	OpenCode	Grok Build	Kimi Code	Antigravity CLI
AGENTS.mdを読む	あり(名前が違う) `CLAUDE.md` AGENTS.mdを読むのはCLAUDE.mdがないときだけ。またはCLAUDE.mdに@AGENTS.mdを書く	あり `AGENTS.md`	あり `AGENTS.md`	あり `AGENTS.md`	あり `AGENTS.md`	あり `AGENTS.md` GEMINI.mdも読む
/goal — 長い目標	あり `/goal`	あり `/goal`	なし組み込みではない — 機能リクエストが出ている	あり `/goal`	あり `/goal`	あり `/goal`
スラッシュコマンド	あり `/help`	あり `/help`	あり `/help`	あり `/help`	あり `/help`	あり `/help`
計画モード	あり `/plan`	あり `/plan`	あり(名前が違う) `Plan agent` Tabで切り替え	あり `/plan`	あり `/plan`	あり `/plan`
承認モード	あり `--permission-mode` 確かめたコマンド claude --help	あり `/permissions`	あり `permission`	あり `--permission-mode` 確かめたコマンド grok --help	あり `--yolo · --auto` 確かめたコマンド kimi --help	あり `--mode` 確かめたコマンド agy --help
セッションの再開	あり `claude -c` 確かめたコマンド claude --help	あり `codex resume` 確かめたコマンド codex --help	あり `opencode -c` 確かめたコマンド opencode --help	あり `grok -c` 確かめたコマンド grok --help	あり `kimi -c` 確かめたコマンド kimi --help	あり `agy -c` 確かめたコマンド agy --help
会話なしで実行(headless)	あり `claude -p` 確かめたコマンド claude --help	あり `codex exec` 確かめたコマンド codex --help	あり `opencode run` 確かめたコマンド opencode --help	あり `grok -p` 確かめたコマンド grok --help	あり `kimi -p` 確かめたコマンド kimi --help	あり `agy -p` 確かめたコマンド agy --help
MCP	あり `claude mcp` 確かめたコマンド claude --help	あり `codex mcp` 確かめたコマンド codex --help	あり `opencode mcp` 確かめたコマンド opencode --help	あり `grok mcp` 確かめたコマンド grok --help	あり `/mcp`	あり `agy mcp` 確かめたコマンド agy --help
スキル(SKILL.md)	あり `.claude/skills`	あり `.agents/skills`	あり `.agents/skills`	あり `.grok/skills`	あり `.agents/skills`	あり `.agents/skills`
サブエージェント	あり `.claude/agents`	あり `.codex/agents`	あり `.opencode/agents`	あり `.grok/agents`	あり `.kimi-code/agents`	あり `.agents/agents`
モデルの切り替え	あり `/model`	あり `/model`	あり(名前が違う) `/models`	あり `/model`	あり `/model`	あり `/model`
コンテキストの圧縮	あり `/compact`	あり `/compact`	あり `/compact`	あり `/compact`	あり `/compact`	あり `/compact` 確かめたコマンド agy changelog
/initで指示ファイルを作る	あり(名前が違う) `/init → CLAUDE.md`	あり `/init → AGENTS.md`	あり `/init → AGENTS.md`	未確認	あり `/init → AGENTS.md`	未確認

コマンドはよく変わります。「未確認」は公式ページや--helpで見つけられなかったという意味で、ないという意味ではありません。

1つのファイルを、すべてのツールで

AGENTS.md — どの依頼にも必要なルール

形の違う3台のロボットが、開いた同じノートをのぞきこみ、それぞれチェックマークといっしょにうなずいている絵

AGENTS.mdはプロジェクトの中にあるふつうのファイルです。エージェントはあなたの最初の一言より先にこれを読むので、ルールをくり返し言う必要がありません。

何を書くか

プロジェクトの動かし方
テストのしかた — そしてテストは必ず通すこと
コーディングスタイル
さわってはいけないもの
報告のしかた

短い例

# AGENTS.md

## 実行
- npm install のあと npm run dev

## テスト
- 終える前に npm test を実行する。すべてのテストが通ること。

## スタイル
- React の関数コンポーネント、インデントはスペース2つ。

## さわらないもの
- .env、データベースのフォルダー、package-lock.json

## 報告
- 変えたファイル、テストの結果、確かめていないことを書く。

ツールごとの読む場所

Claude Code
自分のファイルはCLAUDE.mdです。そのフォルダーや上のフォルダーにCLAUDE.mdがないときだけAGENTS.mdを読みます。両方使うには、CLAUDE.mdに@AGENTS.mdと書きます。
出典 (新しいウィンドウ)
Codex CLI
プロジェクトのいちばん上のフォルダーから今のフォルダーまで、順番につなげて読み、近いファイルが優先されます。全体用のファイルは~/.codex/AGENTS.md。初期の上限は。
出典 (新しいウィンドウ)
OpenCode
プロジェクトのAGENTS.mdと~/.config/opencode/AGENTS.md。AGENTS.mdがないときはCLAUDE.mdを代わりに読みます。
出典 (新しいウィンドウ)
Grok Build
のいちばん上から作業中のフォルダーまで、すべてのフォルダーのAGENTS.md(とCLAUDE.md)。深いフォルダーのファイルが優先されます。
出典 (新しいウィンドウ)
Kimi Code
プロジェクトのAGENTS.mdか.kimi-code/AGENTS.md、そしてすべてのプロジェクトで使う~/.kimi-code/AGENTS.md。
出典 (新しいウィンドウ)
Antigravity CLI
どのフォルダーでもAGENTS.mdとGEMINI.md、そして.agents/rules。全体用のルールは~/.geminiにあります。見つかったルールはすべて合わせて使われます。
出典 (新しいウィンドウ)

CLAUDE.mdとAGENTS.mdをいっしょに使う

長い仕事

/goal — 終わるまで続ける

小さなロボットが、チェックマークのついた石を通りすぎながら長い石の階段を上り、てっぺんの旗をめざしている。そばには時計と満タンの電池がある絵

ふつうの依頼は、モデルがツールを呼ばなくなった時点で終わります。は代わりにゴールラインを決めます — エージェントは条件が満たされるまで、ターンを重ねて働き続けます。

/goal すべてのテストが通り、登録ボタンが signup() を呼ぶこと。データベースは変えないこと。

確かめられる目標を書く

テストできる形にします — 「もっとよくして」ではなく「tests/signupのテストがすべて通る」。
予算や時間などの上限を決めて、始める前にコミットします。
ときどき様子を見ましょう。長い目標は、違う方向へずれていくこともあります。

ありClaude Code
完了の条件を決めます。Claudeは条件が満たされるか、無理だと判断するか、エラーで止まるまで働き続けます。-pとも使えます。
出典 (新しいウィンドウ)
ありCodex CLI
大きな仕事が動いているあいだ、Codexが追い続ける目標です(goals機能、初期設定でオン)。
出典 (新しいウィンドウ)
なしOpenCode
まだ組み込みの/goalはありません — 代わりにカスタムコマンドを使います。
出典 (新しいウィンドウ)
ありGrok Build
目的と、なくてもよい--budgetを渡す/goal。ほかにstatus・pause・resume・clear。
出典 (新しいウィンドウ)
ありKimi Code
自分で進む目標を始めます。status・pause・resume・cancelなども使えます。
出典 (新しいウィンドウ)
ありAntigravity CLI
エージェントが止まろうとすると、がそれを止めて、自分の仕事を確かめて続けるように言います。
出典 (新しいウィンドウ)

AIコース — 目標とループ

プロンプトエンジニアリング

5W1Hで依頼を書く

真ん中の吹き出しカードが、人・箱・時計・地図のピン・電球・レンチが描かれた6つの丸いバッジとつながっている絵

うまくいかない結果の多くは、エージェントが推測できないことが抜けた依頼から生まれます。だれが・何を・いつ・どこで・なぜ・どのように — 6つの問いで、そうした抜けのほとんどを防げます。

よくないプロンプト

“ボタンが壊れてる。直して。”

どのボタン? どう壊れている? 直ったことはどうやってわかる? エージェントは推測するしかなく、違うファイルを変えてしまうかもしれません。

よいプロンプト — 5W1H

だれがホームページで登録したい新しい訪問者。
何を「登録」ボタンを押しても何も起きない。signup()を呼ぶように直して、テストを追加して。
いつ昨日のから、押すたびに起きている。
どこでホーム画面のsrc/components/SignupButton.jsx。のファイルにはさわらないで。
なぜ登録できないせいで、新しい会員を逃している。
どのように押しても何も起きない理由を見つけて、いちばん小さな変更で直し、 testを実行して、何を変えたか教えて。

5W1Hでよい結果が保証されるわけではありませんが、ほとんどの場合をカバーできます。それでもエージェントが何か聞いてくるなら、足りないピースはたいてい6つのうちのどれかです。

AIコース — プロンプトエンジニアリング

いっしょに使うともっとよい

AGENTS.md + 5W1Hのプロンプト

仕事を分けましょう。AGENTS.mdにはどの依頼にも必要なことを、にはこの依頼だけに必要なことを書きます。

AGENTS.md — 毎回

テストのしかた、コーディングスタイル、さわってはいけないもの、報告のしかた

プロンプト — 今回だけ

この1つの依頼の、だれが・何を・いつ・どこで・なぜ・どのように

分厚いルールブックと小さな付せんがすべりこむと、うれしそうなロボットがノートパソコンでタイピングを始める絵

エージェントは両方を読む

短いプロンプト

メッセージのたびに「テストを実行して、データベースにはさわらないで」と打たなくてよくなります。
どのツールでも同じルール

Claude CodeからCodexやKimiに移っても、ルールがついてきます。
チームで共有

ファイルはに入っているので、すべての人とすべてのエージェントが同じルールに従います。
直すのは一度だけ

エージェントが同じまちがいをくり返したら、また説明する代わりにAGENTS.mdに1行足しましょう。

チートシート

共通のコマンド

光るキーが5つついたキーボードのようなカード1枚が、形の違う3台の小さなターミナルマシンにケーブルでつながっている絵

同じ操作がほとんどのツールで使えます。例外は比較表にあります。

プロジェクトのフォルダーで始める
cd my-project claude · codex · opencode · grok · kimi · agy
指示ファイルを作る
/init Claude CodeはCLAUDE.mdを書きます。Grokとagyは未確認。
編集の前に計画する
/plan OpenCode — Tabを押してPlanエージェントに。
モデルを切り替える
/model OpenCode — /models。
コンテキストを空ける
/compact
長い目標を決める
/goal OpenCodeにはありません。
前のセッションを続ける
claude -c · opencode -c · grok -c · kimi -c · agy -c codex resume --last
会話なしで1回だけ実行
claude -p · grok -p · kimi -p · agy -p codex exec · opencode run
MCPサーバーを管理する
claude mcp · codex mcp · opencode mcp · grok mcp · agy mcp Kimi — 会話の中で/mcp。

SONUBでもっと学ぶ

公式の情報源

2026-10-26に、公式ドキュメントとインストールしたCLI(--help)で確かめました。コマンドは変わるので、公式ドキュメントも読んでください。

各ツールのドキュメント

よく使う3つの形

どの形でインストールしますか？

同じでも、いろいろな形で使えます。このページでは、その中でいちばんよく使う3つの形、ターミナルの、デスクトップアプリ、VS Code 拡張機能を扱います。形はこの3つだけではありません。ツールによっては、JetBrains などほかのエディター、Web ブラウザー、スマートフォンのアプリ、Slack や GitHub の中でも使え、で自分のプログラムに組み込むこともできます。自分に合う形を選び、下の共通の4ステップに沿ってインストールしたら、ツールごとに違うコマンド・ダウンロード先・拡張機能 ID だけを入れ替えましょう。

生徒の前から3本の道がターミナルの画面、ノートパソコンのデスクトップアプリ、コードエディターのサイドパネルへと伸び、3つの画面がすべて上にある同じ光る AI の玉と線でつながっている絵

CLI

こんなときに
が好き、または同じ作業をスクリプトで繰り返したいとき

いいところ
を調べ、ファイルを直し、コマンドを実行し、非対話実行（claude -p · ）でまでできます

例
失敗するテストをターミナルで調べたり、でリポジトリのチェックを走らせたりします

CLI のインストールを見る
デスクトップアプリ

こんなときに
複数のプロジェクトや続いている作業を、見やすい画面で整理したいとき

いいところ
会話を整理し、結果を目で確かめ、複数の作業を並べて任せられます

例
ある機能を独立したで任せておき、その間に別のプロジェクトを見ます

デスクトップアプリのインストールを見る
VS Code 拡張機能

こんなときに
ほとんどの時間をで過ごしているとき

いいところ
開いているファイルや選んだをそのまま会話に入れ、変更をソースの横で確かめられます

例
関数を1つ選んで、説明・修正・テスト追加を頼みます

VS Code 拡張機能のインストールを見る

選び方の目安は OpenAI Codex のドキュメントの比較にならいました — CLI (新しいウィンドウ) · デスクトップアプリ (新しいウィンドウ) · VS Code 拡張機能 (新しいウィンドウ)

形 1

CLI としてインストール

CLI はターミナルでコマンドを打って使う形です。インストールはコマンド1行で終わり、どのツールも同じ4ステップです。自分のパソコンに合う1行だけを選びましょう。

ターミナルを開きます — とはターミナル、は PowerShell です。
下から自分のパソコンに合うインストールコマンドを1行コピーして貼り付け、Enter を押します。Homebrew やを使っているなら、その行を使ってもかまいません。
ターミナルを新しく開き、下のカードの「確認」コマンドを実行してが表示されるか見ます。
プロジェクトのフォルダーに移動して（cd）、カードの「開始」コマンドを入力します。初回はが開くので、ログインするかを貼り付けます。

Claude Code

macOS · Linux

curl -fsSL https://claude.ai/install.sh | bash

Windows (PowerShell)

irm https://claude.ai/install.ps1 | iex

Homebrew · npm でインストール

Homebrew

brew install --cask claude-code

npm

npm install -g @anthropic-ai/claude-code

確認
claude --version

開始
claude

公式インストールガイド (新しいウィンドウ)
Codex CLI

macOS · Linux

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows (PowerShell)

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Homebrew · npm でインストール

Homebrew

brew install --cask codex

npm

npm install -g @openai/codex

確認
codex --version

開始
codex

公式インストールガイド (新しいウィンドウ)
OpenCode

macOS · Linux

curl -fsSL https://opencode.ai/v2/install | bash

Homebrew · npm でインストール

Homebrew

brew install anomalyco/tap/opencode-v2

npm

npm install -g @opencode/cli

確認
opencode --version

開始
opencode

公式インストールガイド (新しいウィンドウ)
Grok Build

macOS · Linux

curl -fsSL https://x.ai/cli/install.sh | bash

Windows (PowerShell)

irm https://x.ai/cli/install.ps1 | iex

確認
grok --version

開始
grok

公式インストールガイド (新しいウィンドウ)
Kimi Code

macOS · Linux

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

Windows (PowerShell)

irm https://code.kimi.com/kimi-code/install.ps1 | iex

Homebrew · npm でインストール

npm

npm install -g @moonshot-ai/kimi-code

確認
kimi --version

開始
kimi

公式インストールガイド (新しいウィンドウ)
Antigravity CLI

macOS · Linux

curl -fsSL https://antigravity.google/cli/install.sh | bash

Windows (PowerShell)

irm https://antigravity.google/cli/install.ps1 | iex

確認
agy --version

開始
agy

公式インストールガイド (新しいウィンドウ)

… | bash と irm … | iex は、インターネット上のスクリプトをそのまま自分のパソコンで実行します。ここに載せた公式のアドレスだけを使い、ほかの場所で見かけた似たコマンドは実行しないでください。

形 2

デスクトップアプリとしてインストール

デスクトップアプリはウィンドウとボタンで使う形です。ターミナルなしでダウンロードしてインストールし、複数の作業を画面で整理できます。すべてのツールに公式デスクトップアプリがあるわけではありません。

公式サイトから自分の OS（macOS・Windows・Linux）に合うアプリをダウンロードしてインストールします。
アプリを開き、その会社のアカウントでログインします。
作業したいプロジェクトのフォルダーを開きます。新しいプロジェクトを作ってもかまいません。
やりたいことを書いて任せ、会話・結果・変更されたファイルを画面で確かめます。複数の作業を並べて任せることもできます。

Claude Code

Claude Desktop — Code

はの Code タブで使います。CLI を別にインストールする必要はなく、有料プランが必要です。
ダウンロード (新しいウィンドウ) 公式インストールガイド (新しいウィンドウ)
Codex

Codex app

macOS（Apple Silicon）と Windows（Microsoft Store）版があります。CLI をインストールしていれば codex app でも開けます。
ダウンロード (新しいウィンドウ) 公式インストールガイド (新しいウィンドウ)
OpenCode

OpenCode Desktop
ダウンロード (新しいウィンドウ) 公式インストールガイド (新しいウィンドウ)
Grok Build

公式のデスクトップアプリは見つかりませんでした。
CLI としてインストール
Kimi Code

公式のデスクトップアプリは見つかりませんでした。
CLI としてインストール
Antigravity

Google Antigravity

はアプリそのものがコードエディター（）です — macOS 12 以降、Windows 10・11、Linux で動きます。
ダウンロード (新しいウィンドウ) 公式インストールガイド (新しいウィンドウ)

形 3

VS Code 拡張機能としてインストール

VS Code 拡張機能は、コードエディターの中にのパネルを追加する形です。拡張機能からインストールし、選んだコードについてすぐ質問できます。

VS Code で拡張機能ビューを開きます — +Shift+X（macOS は Cmd+Shift+X）。
下の拡張機能の名前かで検索し、[Install] を押します。ターミナルで code --install-extension を使ってインストールすることもできます。
サイドバーやエディター上部に増えたアイコンからエージェントのパネルを開き、ログインします。
コードを選んで説明・修正・テストを頼み、変更をソースの横で確かめてから受け入れます。

Claude Code

Claude Code for VS Code

拡張機能 ID anthropic.claude-code

code --install-extension anthropic.claude-code

VS Code Marketplace で見る (新しいウィンドウ) 公式インストールガイド (新しいウィンドウ)
Codex

Codex – OpenAI’s coding agent

拡張機能 ID openai.chatgpt

code --install-extension openai.chatgpt

VS Code Marketplace で見る (新しいウィンドウ) 公式インストールガイド (新しいウィンドウ)
OpenCode

opencode

拡張機能 ID sst-dev.opencode

code --install-extension sst-dev.opencode

VS Code Marketplace で見る (新しいウィンドウ) 公式インストールガイド (新しいウィンドウ)
Grok Build

公式の VS Code 拡張機能は見つかりませんでした。
CLI としてインストール
Kimi Code

Kimi Code

拡張機能 ID moonshot-ai.kimi-code

code --install-extension moonshot-ai.kimi-code

VS Code Marketplace で見る (新しいウィンドウ) 公式インストールガイド (新しいウィンドウ)
Antigravity

Google Antigravity

拡張機能 ID Google.google-antigravity

code --install-extension Google.google-antigravity

VS Code Marketplace で見る (新しいウィンドウ) 公式インストールガイド (新しいウィンドウ)

ターミナルで code コマンドが見つからないと表示されたら、VS Code のコマンドパレット（Ctrl+Shift+P · Cmd+Shift+P）で "Shell Command: Install 'code' command in PATH" を実行してください。

どの形でも同じエージェントです

CLI・デスクトップアプリ・VS Code 拡張機能は見た目が違うだけで、中では同じエージェントが同じループを回しています。だから「ツールの共通点」タブで学ぶこと — AGENTS.md・承認・・5W1H — のほとんどがそのまま使えます。コマンドとアドレスは 2026-10-26 に公式ドキュメントで確認しました。変わっていたら公式ガイドに従ってください。

ツールの共通点を見る

Claude Code + Codex

六つの良い習慣 — 作業する順番で

この六つの習慣は、どちらの公式ガイドにも出てきます。カードごとに、とでのやり方を示します。

ステップ 1 · 四つの部分で頼む

目的、コンテキスト(ファイル、ドキュメント、エラー全文 — ファイルは @ で添付)、制限、終わりの条件を伝えます。真似してほしい既存のパターンも示しましょう。調査は範囲をしぼり、エージェントが何百ものファイルを読まないようにします。

Claude Code
@file · cat error.log | claude -p "…"

Codex CLI
@file
ステップ 2 · 難しい作業は先に計画

たくさんのファイルに関わる作業や、よく知らない作業は、プランモードに切り替えます。読んで、計画して、計画を直してから作ります。大きな機能は、エージェントにインタビューしてもらい、書を書かせましょう。変更を一文で言えるなら、計画は省いて大丈夫です。

Claude Code
Shift+Tab · claude --permission-mode plan

Codex CLI
/plan · Shift+Tab
ステップ 3 · 自分で確かめさせる

テスト、、見比べるなど、合格か不合格かが分かるものを渡し、証拠を見せるように頼みます。作業を終えたことにする前に、新しいレビュアーにを読ませましょう。

Claude Code
/code-review

Codex CLI
/review
ステップ 4 · 長く使うルールはファイルに

くり返し言うルールは AGENTS.md か CLAUDE.md に書きます。短く、ビルドとテストのコマンドも入れます。ときどき必要な知識はに、外部の情報はで、必ず行う手順はフックにします。

Claude Code
CLAUDE.md · .claude/skills · claude mcp add

Codex CLI
AGENTS.md · .agents/skills · codex mcp add
ステップ 5 · コンテキストをきれいに保つ

作業一つにつき会話一つにして、関係ない作業の間では会話を消し、長くなったらします。二回直してもだめなら、よりよい依頼で新しく始めましょう。失敗だらけの長いセッションより、まっさらなセッションのほうが勝ちます。

Claude Code
/clear · /compact · /btw · /rewind

Codex CLI
/new · /compact · /fork
ステップ 6 · 広げて、並列で動かす

チャット画面なしで、スクリプトやから動かします。並列の作業にはそれぞれ専用のを用意し、動いている間は一手ずつ見守らずに自分の作業をしましょう。定期実行は、手作業でしっかり動くようになってからにします。

Claude Code
claude -p · git worktree

Codex CLI
codex exec · git worktree

四つの部分の依頼 — どちらのツールでも使えます

Goal: Remove an item from the cart when its quantity becomes 0.
Context: @src/cart.ts @tests/cart.test.ts — the total is NaN today.
Constraints: Keep the public API. No new packages.
Done when: a new test covers quantity 0 and the tests pass.
Show me the test output as evidence.

目的 · コンテキスト · 制限 · 終わりの条件、そして見たい証拠。ファイルと目的は自分のものに置き換えてください。

よくある間違い

十のよくある間違い — それぞれを直す習慣

Claude Code のガイドは失敗パターンを五つ、Codex のガイドは八つ挙げています。意味でまとめると十になります。チップは、それぞれがどちらの公式リスト由来かを示します。

関係ない作業を一つの会話に混ぜる、またはプロジェクト全体を一つのチャットで進める — コンテキストがノイズでいっぱいになります。

Claude CodeCodex CLI

直し方: はっきりした成果ごとに会話を一つにします。関係ない作業の間では、会話を消すか新しく開きます。
習慣 5 — コンテキストをきれいに保つ
同じことを何度も直させる — コンテキストが失敗した試みでいっぱいになります。

Claude Code

直し方: 二回直してもだめなら、学んだことを入れた、よりよい最初の依頼で新しく始めます。
習慣 5 — コンテキストをきれいに保つ
長く使うルールを毎回の依頼に詰め込む、またはルールファイルが長くなりすぎて大事なルールが埋もれる。

Claude CodeCodex CLI

直し方: 長く使うルールは AGENTS.md か CLAUDE.md に移して短く保ちます。エージェントがもう正しくできることは消すか、フックにします。
習慣 4 — 長く使うルールはファイルに
確かめられない成果を信じる — ビルドやテストのコマンドを渡さないと、コードは正しそうに見えても例外のケースが抜けます。

Claude CodeCodex CLI

直し方: 必ず確かめる方法(テスト、スクリプト、スクリーンショット)を渡し、ビルドとテストのコマンドを書いておきます。確かめられないものは出さないでください。
習慣 3 — 自分で確かめさせる
範囲を決めずに「調査して」と頼む — 何百ものファイルを読んで、コンテキストがいっぱいになります。

Claude Code

直し方: 依頼で範囲をしぼるか、調査をサブエージェントに任せます。
習慣 1 — 四つの部分で頼む
複雑な多段階の作業で、計画を飛ばす。

Codex CLI

直し方: プランモードで始め、コードを変える前に計画に合意します。
習慣 2 — 難しい作業は先に計画
流れを理解する前に、エージェントにパソコンへの全を渡す。

Codex CLI

直し方: 初期の権限から始めて、必要なときだけ広げます。
習慣 4 — 長く使うルールはファイルに
同じファイルに対して、いくつもの作業を同時に動かす。

Codex CLI

直し方: 並列の作業ごとに専用の Git worktree を用意します。
習慣 6 — 広げて、並列で動かす
手作業でしっかり動く前に、定期実行にする。

Codex CLI

直し方: 確実になるまで手作業で動かし、それから定期実行にします。
習慣 6 — 広げて、並列で動かす
並列で作業せず、エージェントを一手ずつ見守る。

Codex CLI

直し方: はっきりしたゴールを決めて任せ、その間は自分の作業をします。
習慣 6 — 広げて、並列で動かす

出典

2026-10-26 に公式ドキュメントで確認しました。おすすめのモデルは2026年11月時点の SONUB の選択です。モデルはよく変わるので、モデルのページも確認してください。

コンテキストと使用量

コンテキストを小さくすると、使用量が長くもつ

依頼のたびに会話全体がモデルにもう一度送られます。だからコンテキストが大きいほど、プランの上限は早く尽きます。このタブでは、使用量の見方、上限が戻る時期、コンテキストを埋めるもの、そして 1M ではなく約 400k でする方法を説明します。コマンドと設定は 2026-10-26 に公式ドキュメントで確認しました。

机に向かう生徒と光るAIの玉。真ん中には、底に色つきブロックが薄く敷かれ、チャットの紙の山が増えて上よりずっと下の光る紫の線まで届いた背の高いグラス。右側には、紙を小さなまとめカード1枚に押しつぶすプレス機、更新の矢印つきの時計、しっかり満たされた電池

使用量とリセットあとどれだけ残り、いつ戻るか
コンテキストを埋めるもの基本コンテキスト + 増えていく会話
圧縮自動と手動
1M ではなく約 400kツールごとの設定

ステップ 1

今の使用量とリセット時刻を確かめる

サブスクはメッセージを1通ずつ数えません。時間の枠ごとに戻る使用量の許容量をくれます。上限に当たってからではなく、長い作業の前に数字を見ましょう。

Claude Code

確認コマンド/usage/context

/usage はプランの使用量バーと、直近1日または1週間に何が使ったか(・・サーバー)を表示します。/ は今コンテキストがどれだけ埋まっているかを表示します。

戻る時期 5時間ごと毎週

5時間のローリング枠と週ごとの枠があります。上限に当たると、メッセージにリセット時刻が出ます。例: 「resets 3:45pm」。
出典 (新しいウィンドウ)
Codex CLI

確認コマンド/status/usage weekly

/status はモデル、このセッションのトークン使用量、残りの上限を表示します。/usage daily や /usage weekly はトークンの動きを表示します。使用量ダッシュボード(chatgpt.com/codex/settings/usage)にリセット時刻が出ます。

戻る時期 5時間ごと毎週

Plus と Business には5時間の枠があり(Pro には今はありません)、週ごとの上限もかかることがあります。
出典 (新しいウィンドウ)
OpenCode

確認コマンドopencode stats --days 7 --models

opencode stats は日ごと・モデルごとのトークンと費用を表示します。

戻る時期 5時間ごと毎週毎月

OpenCode Go は月の上限を分けます: 5時間で最大 20%、1週間で 50%、1か月で 100%。
出典 (新しいウィンドウ)
Grok Build

確認コマンド/usage/context

/usage はクレジットの使用量を、/context はコンテキストの使用量を表示します。

戻る時期公式ドキュメントに記載なし

公式ドキュメントには、上限がいつ戻るか書かれていません。
出典 (新しいウィンドウ)
Kimi Code

確認コマンド/usage

/usage はトークン使用量、コンテキストの埋まり具合、割り当て量を表示します。

戻る時期 5時間ごと毎週毎月

使用量 API は5時間・7日・1か月の枠と、それぞれのリセット時刻を返します。
出典 (新しいウィンドウ)
Antigravity CLI

確認コマンド/usage/context

/usage(または /quota)はモデルごとの残りのリクエスト数とトークン数を表示します。/context はコンテキストを埋めているものを表示します。

戻る時期 5時間ごと毎週

Google AI Pro は週の上限まで5時間ごとに戻ります。Pro や Ultra でなければ、割り当ては毎週戻ります。
出典 (新しいウィンドウ)

無料で続ける方法

追加の使用量にお金を払う前に、すでに無料のものを使いましょう。

Codex — /usage を開き、もらったリセットがあれば使います。クレジットを買わずにレート制限をリセットできます。
/usage
Claude Code — 上限で作業が止まったら、セッションを開いたままにします。リセット後に自動で待って作業を続けます(初期設定でオン。/rate-limit-options か autoContinueAtUsageLimit 設定で選べます)。
/rate-limit-options · autoContinueAtUsageLimit

ステップ 2

基本コンテキストと、会話で増えるコンテキスト

コンテキストは2つの部分でできています。基本コンテキストは、何も入力する前に読み込まれ、毎回の依頼につきます。会話はその上に積まれ、依頼・ファイルの読み込み・コマンドの出力のたびに増えます。

新しい呼び出しと結果指示、ツール、AGENTS.md ターン 1
新しい呼び出しと結果これまでの呼び出しと結果指示、ツール、AGENTS.md ターン 2
新しい呼び出しと結果これまでの呼び出しと結果これまでの呼び出しと結果指示、ツール、AGENTS.md ターン 3
まとめ指示、ツール、AGENTS.md 圧縮のあと

指示、ツール、AGENTS.md
これまでの呼び出しと結果
新しい呼び出しと結果
まとめ

形だけの図です — 基本は変わらず、その上に会話が積まれます。依頼のたびに山全体が送られます。

基本コンテキスト — 頼む前からそこにある

システムプロンプト
組み込みツール
MCP ツール
スキルの説明
CLAUDE.md · AGENTS.md · メモリ

SONUB の基準で 6% 以下に保ちます。何かを頼む前に、新しい会話を開いて /context(、agy)か /status()を見ます。

会話 — 依頼のたびに増える

あなたの依頼と答え
エージェントが読んだファイル
コマンドとテストの出力

答え、が読んだファイル、コマンドの出力が、そのたびに足されます。会話を圧縮するか消すまで、何も出ていきません。

基本コンテキストが 6% を超えていますか? 使わない MCP サーバーを切り、使わないスキルとプラグインを消し、CLAUDE.md と AGENTS.md には毎回の依頼に必要なルールだけ残します。

ステップ 3

自動圧縮と手動圧縮

圧縮は、古い会話をまとめに置きかえて、セッションを続けられるようにします。細かい内容は失われ、まとめを作る依頼そのものも会話全体を読みます。

自動

コンテキストがしきい値に達すると、ツールが自分で圧縮します。しきい値はステップ 4 の設定で選びます。
手動

区切りのよいところで圧縮し、残すものを伝えます。例: /compact Focus on the failing test and the files we changed.
まっさらで始める

次の作業が関係ないなら、代わりに新しい会話を開きます(、/new)。お金はかからず、古いものはすべて消えます。

ツール	手動で圧縮	まっさらで始める	自動 — 設定	初期設定
Claude Code	`/compact`	`/clear`	`autoCompactEnabled · autoCompactWindow`	初期設定でオン。1M モデルでは、ウィンドウを決めないと約 967K で圧縮します。
Codex CLI	`/compact`	`/new`	`model_auto_compact_token_limit`	model_auto_compact_token_limit で圧縮します。未設定なら、モデルの初期値で圧縮します。
OpenCode	`opencode api post /api/session/<id>/compact`	—	`compaction.auto · compaction.buffer`	初期設定でオン。上限の 15%(最低 16k)を空けておき、まとめのそばに直近の約 15,000 トークンを残します。
Grok Build	`/compact`	—	`auto_compact_threshold_percent`	初期設定ではコンテキストウィンドウの 85% で圧縮します。
Kimi Code	`/compact`	—	`loop_control.reserved_context_size`	空き容量が loop_control.reserved_context_size を下回ると圧縮します。
Antigravity CLI	ドキュメントに記載なし	—	ドキュメントに記載なし	古いターンを自分でチェックポイントのまとめに圧縮します。そのためのコマンドや設定はドキュメントにありません。

ステップ 4

1M ではなく約 400k を使う

今のモデルは 1M トークンを持てますが、全部埋める必要はありません。ツールが約 400k で圧縮すれば、依頼ごとに運ぶ量が減り、同じプランが長くもちます。

1M ウィンドウ(Claude Code)

基本コンテキスト ≤ 6%
SONUB: 444k で圧縮
初期値: 約 967K
1M

なぜ使用量を節約できるのか

公式ドキュメントはどちらも、使用量をコンテキストの大きさと結びつけています。Claude Code: トークンのコストはコンテキストの大きさに比例し、依頼のたびに会話全体が送られます。Codex: コンテキストを多く持つ長いセッションは、メッセージごとにかなり多く使います。900K 近くの依頼は、450K 近くの依頼の約2倍を運びます。サブスクでは、これでAIを約2倍使える、と言う人もいます — よくある報告で、公式の数字ではありません。

Claude Code

~/.claude/settings.json

{
  "autoCompactWindow": 444000
}

どのモデルでも、コンテキストが 444,000 トークンに達したら圧縮します(設定できる範囲は 100k–1M)。あるモデルで /autocompact により保存したウィンドウが優先されます — 新しい会話で /context を見て確かめます。

同じこと: /autocompact 444k · claude --autocompact 444k
確認: /context

Codex CLI

~/.codex/config.toml

model_context_window = 500000
model_auto_compact_token_limit = 475000

model_context_window は Codex にウィンドウが 500,000 トークンだと伝え、model_auto_compact_token_limit は 475,000(その 95%)で圧縮します。新しい会話で /status を見て確かめます。

確認: /status

ほかのツール

OpenCode

compaction.buffer はモデルの上限の下に空けておく容量です — 1M モデルでは 600000 にすると約 400k で圧縮が始まります。
opencode.jsonc
```
{
  "compaction": { "buffer": 600000 }
}
```
Grok Build

auto_compact_threshold_percent は圧縮を始めるウィンドウの割合です — 1M ウィンドウでは 40 が約 400k です。
~/.grok/config.toml
```
[session]
auto_compact_threshold_percent = 40
```
Kimi Code

初期のウィンドウは 256K(KIMI_MODEL_MAX_CONTEXT_SIZE 262144)で、すでに 400k より小さいので、変えるものはありません。
Antigravity CLI

ウィンドウや圧縮の位置の設定はドキュメントにありません — 自分で圧縮します。

約 400k と 6% は SONUB の基準で、公式の推奨ではありません — 公式ドキュメントは設定を説明しているだけです。

出典

コマンド・設定・初期値は、次の公式ドキュメントで 2026-10-26 に確認しました。

キャンセルする保留中の予約を選んでください。予約ごとに確認が必要です。

あなたの:

閉じる

ツール・エージェント・ハーネスとは何ですか？

ツール(Tool)

エージェント(Agent)

ハーネス(Harness)

最近はツールをハーネスやエージェントとも呼びます

このページの6つのツール

エージェント = モデル + ハーネス

エージェント

モデル

ハーネス

ハーネスは6つ、モデルはたくさん

エージェントループを1ステップずつ

プロンプトが届く

ハーネスが入力を組み立てる

モデルが考える

コンテキストを集める

ハーネスがツールを実行する

ファイルを変える

コマンドを実行する

確かめる

最終報告

会話はターンごとに長くなる

プロンプトキャッシュ

圧縮

承認とサンドボックスはハーネスの仕事

CodexとClaude Code — 同じループ、違う細かいところ

ツールごとにできること

AGENTS.md — どの依頼にも必要なルール

何を書くか

ツールごとの読む場所

/goal — 終わるまで続ける

確かめられる目標を書く

5W1Hで依頼を書く

よくないプロンプト

よいプロンプト — 5W1H

AGENTS.md + 5W1Hのプロンプト

AGENTS.md — 毎回

プロンプト — 今回だけ

短いプロンプト

どのツールでも同じルール

チームで共有

直すのは一度だけ

共通のコマンド

プロジェクトのフォルダーで始める

指示ファイルを作る

編集の前に計画する

モデルを切り替える

コンテキストを空ける

長い目標を決める

前のセッションを続ける

会話なしで1回だけ実行

MCPサーバーを管理する

SONUBでもっと学ぶ

公式の情報源

各ツールのドキュメント

どの形でインストールしますか？

CLI

デスクトップアプリ

VS Code 拡張機能

CLI としてインストール

Claude Code

Codex CLI

OpenCode

Grok Build

Kimi Code

Antigravity CLI

デスクトップアプリとしてインストール

Claude Code

Codex

OpenCode

Grok Build

Kimi Code

Antigravity

VS Code 拡張機能としてインストール

Claude Code

Codex

OpenCode

Grok Build

Kimi Code

Antigravity