AWS Emulator とは?インストール方法と、Claude Code / Codex でローカルに AWS アプリをテストする手順(1.0.322 で検証)

AWS Emulator は AWS 公式のローカル AWS エミュレーターで、2026 年 11 月 11 日(米国時間)に一般提供(GA)が始まりました。追加のサービス料金はかからず、ソースは公開されており、AWS アカウントも不要で、200 以上のサービスをカバーします。本記事では Debian 13 上で 1.0.322 を検証し、インストールコマンド、AWS CLI をローカル endpoint に向けて S3 バケットと DynamoDB テーブルを作る手順、遭遇したエラー、Claude Code・Codex・Cursor にエミュレーター相手でコードを書かせてテストさせる方法をまとめます。

13 分钟阅读
AWS Emulator とは?インストール方法と、Claude Code / Codex でローカルに AWS アプリをテストする手順(1.0.322 で検証)

AWS Emulator は AWS 公式のローカル AWS エミュレーターです。自分のマシン上に HTTPS endpoint を立て、AWS CLI、AWS SDK、コーディングエージェントはクラウドと同じ API でそこを呼び出します。AWS アカウントは不要で、作成されるものは本物のクラウドリソースではありません。AWS News Blog によると、2026 年 11 月 11 日(米国時間)に一般提供(GA)となりました。北京時間では 11 月 12 日の午前 2 時ごろです。

2026 年 11 月 13 日(北京時間、UTC+8)、Debian 13 x86_64 のマシンに当時 LTS チャネルにあった AWS Emulator 1.0.322 をインストールしました。AWS CLI 2.40.1 で S3 バケット、DynamoDB テーブル、SQS キュー、Lambda 関数を作成し、さらに Claude Code 2.1.319 と Codex CLI 0.167.0 にそれぞれエミュレーター相手でコードを書かせてテストを実行させました。以下のコマンド、所要時間、出力はすべてこの実行で得たものです。

Create API Key →

結論

質問回答
AWS Emulator とは?AWS 公式のローカル AWS API エミュレーター。Rust 製で GUI はありません。AWS によると 400 以上の API モデルから作られ、200 以上の AWS サービスをカバーします。
料金や AWS アカウントは必要?AWS によると追加のサービス料金はなく、AWS アカウントも不要です。ソースは GitHub にあり、CC0(パブリックドメイン)で公開されています。
インストール方法は?Linux は RPM または Debian パッケージ。macOS と Windows は公式ドキュメントの Dockerfile でイメージを自分でビルドします(公式のビルド済みイメージはありません)。Rust プロジェクトは組み込みモードも使えます。
使い方は?aws-emulator を起動すると、既定で https://127.0.0.1:9297 で待ち受けます。環境変数をいくつか設定して AWS CLI と SDK をそこに向ければ、アプリのコードは変更不要です。
検証結果ダウンロードとインストールで約 6 秒、起動後約 0.3 秒でヘルスチェックが ok を返しました。S3、DynamoDB、SQS、Lambda はすべて動作。同じ「S3 + DynamoDB + pytest」タスクを Claude Code は約 32 秒、Codex は約 81 秒で終え、どちらも 2 passed でした。
一番の注意点IAM ポリシーは AWS と同じようには評価されず、単一アカウント・単一リージョンのみのエミュレーションです。権限やセキュリティは本番前に本物の AWS でテストしてください。

AWS Emulator とは

AWS News Blog によると、AWS Emulator は起動時に独自の認証情報、config ファイル、証明書を生成し、~/.aws/emulator/9297/ に書き出します。SDK の環境変数をそこに向けると、リクエストは AWS ではなく自分のマシンに送られます。AWS SDK と同じ API モデルから作られているため、返ってくるデータやエラーはクラウドと同じ形式です。

主な用途はコーディングエージェントです。@AWSNewsroom によると、AWS Emulator のコードはすべて Amazon Bedrock AgentCore 上で動く自律型 AI エージェントが書いたもので、数百のエージェントが 3 つのチームに分かれ、テスト作成、機能実装、レビューを担当しています。AWS の Swami Sivasubramanian 氏による All Things Distributed のゲスト記事によると、エージェントはまず「フィデリティテスト」を書いて本物の AWS で通し、そのうえで同じテストに通るまでエミュレーターを実装します。AWS CTO の @Werner 氏は、これは完全にエージェントが書いてテストしたもので、200 以上の AWS サービスについて本番に近いテスト環境を提供すると述べています。

発表後の反響も大きく、X の公開データによると、11 月 13 日未明(北京時間)時点で @AWSNewsroom の発表ポストは約 11.1 万回表示、705 いいね、206 リポスト、@awsdevelopers の発表ポストは約 7.8 万回表示、1203 いいね、758 ブックマークでした。GitHub リポジトリ aws/aws-emulator は同時点で約 4400 スターです。

タイムライン

日時(北京時間)出来事
11 月 11 日1.0.322 リリース(aws-emulator -v のリリース日は 2026.11.10)
11 月 12 日 午前 2 時ごろAWS News Blog、Werner 氏、AWS 公式アカウントが GA を発表
11 月 13 日 0:16LTS/latest からダウンロードしたパッケージはまだ 1.0.322。同時刻に GitHub Releases に v1.0.336 が公開

AWS Emulator はリリース頻度が高く、公式 skill も常に最新版を使うよう求めています。読者がインストールするときは、おそらく私たちより新しいバージョンになっています。

AWS Emulator のインストール

公式ドキュメント(Getting started)には 4 つの方法があります。AI コーディングエージェントに任せる、Linux パッケージ、Docker、Rust の組み込みモードです。

Linux:RPM または Debian パッケージ

bash
# Debian / Ubuntu(x86_64)
curl -fsSLo aws-emulator.deb https://downloads.aws.com/aws-emulator/packages/aws-emulator/LTS/latest/aws-emulator_amd64.deb
sudo apt-get install -y ./aws-emulator.deb

# Amazon Linux / Fedora / RHEL(x86_64)
sudo dnf install -y https://downloads.aws.com/aws-emulator/packages/aws-emulator/LTS/latest/aws-emulator-x86_64.rpm

# バージョン確認
aws-emulator -v

ARM マシンではファイル名を aws-emulator_arm64.deb または aws-emulator-aarch64.rpm に替えます。パッケージは /opt/aws-emulator/ にインストールされ、aws-emulator コマンドが /usr/bin/ に置かれます。

実際の出力:

text
Version: 1.0.322
Release date: 2026.11.10
Commit: 7753983c6e495ec3612695b1336bf4936fc7b7fd

deb パッケージは約 171 MB で、ダウンロードは 1.7 秒、ダウンロードと apt-get install を合わせて約 6 秒でした。公式ドキュメントには GPG 検証の手順もあります。各パッケージの隣に同名の .sig ファイルがあり、https://downloads.aws.com/keys/gpg/current.asc をインポートすると、フィンガープリントは 98BC F336 A3BE 53B7 34E9 67C5 2E5B F49B D940 F624 になるはずです。手順どおりに検証し、Good signature from "SSM Publishing <ssm-publishing@amazon.com>" を確認しました。

macOS / Windows:Dockerfile からビルド

Docker ガイドによると、公式のビルド済みイメージはなく、次の Dockerfile で自分でビルドします。Apple シリコンでは x86_64.rpm を aarch64.rpm に替えてください。

dockerfile
FROM public.ecr.aws/amazonlinux/amazonlinux:2023-minimal
ADD https://downloads.aws.com/aws-emulator/packages/aws-emulator/LTS/latest/aws-emulator-x86_64.rpm /tmp/aws-emulator.rpm
RUN rpm -i /tmp/aws-emulator.rpm && rm /tmp/aws-emulator.rpm \
 && mkdir -p /home/emulator && chown 1000 /home/emulator
USER 1000
ENV HOME=/home/emulator
EXPOSE 9297
ENTRYPOINT ["aws-emulator", "-b", "0.0.0.0"]
bash
docker build -t aws-emulator .
mkdir -p ~/.aws/emulator
PORT=9297
docker run --rm --memory=2g --memory-swap=2g -p 127.0.0.1:$PORT:$PORT \
  -e HOME="$HOME" -v "$HOME/.aws/emulator:$HOME/.aws/emulator" \
  aws-emulator -p $PORT

ポートは -p 9297:9297 ではなく -p 127.0.0.1:9297:9297 と書いてください。短い書き方だと、ネットワーク上の他のマシンからもアクセスできてしまいます。今回の検証マシンには Docker がないため、Docker の手順は公式ドキュメントに沿って整理したもので、実行はしていません。

起動して AWS CLI を向ける

1 つ目のターミナルでエミュレーターを起動します(-t off で、既定で有効な匿名テレメトリーをオフにします)。

bash
aws-emulator -t off

ログは JSON Lines 形式で、endpoint、config、証明書のパスを示す行があります。

text
"endpoint_url":"https://127.0.0.1:9297","health_check_url":"https://127.0.0.1:9297/__admin/health","config_file":"/home/box/.aws/emulator/9297/config","ca_file":"/home/box/.aws/emulator/9297/ca.pem"

2 つ目のターミナルで環境変数を設定します。この一式は AWS News Blog のもので、最後の行で本物の AWS 認証情報を消しています。

bash
export AWS_ENDPOINT_URL=https://127.0.0.1:9297
export AWS_SHARED_CREDENTIALS_FILE=~/.aws/emulator/9297/emulator_credentials
export AWS_CONFIG_FILE=~/.aws/emulator/9297/config
export AWS_EC2_METADATA_DISABLED=true
export AWS_DISABLE_HOST_PREFIX_INJECTION=true
export AWS_REGION=us-east-1
export AWS_DEFAULT_REGION=us-east-1
unset AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_SESSION_TOKEN AWS_PROFILE

まず、エミュレーターにつながっていることを確認します。

bash
curl --cacert ~/.aws/emulator/9297/ca.pem https://127.0.0.1:9297/__admin/health
aws sts get-caller-identity

今回は起動後約 0.27 秒でヘルスチェックが ok を返しました。get-caller-identity はエミュレーター固定のアカウント 000000000000 と ARN arn:aws:iam::000000000000:user/emulator を返します。このアカウントが見えていれば、リクエストは本物の AWS に送られていません。アイドル時の常駐メモリは約 283 MB でした。

検証:S3、DynamoDB、SQS、Lambda

bash
aws s3 mb s3://aicodewith-emu-demo
echo "hello from the emulator" > hello.txt
aws s3 cp hello.txt s3://aicodewith-emu-demo/
aws s3 ls s3://aicodewith-emu-demo/

aws dynamodb create-table --table-name notes \
  --attribute-definitions AttributeName=id,AttributeType=S \
  --key-schema AttributeName=id,KeyType=HASH --billing-mode PAY_PER_REQUEST
aws dynamodb wait table-exists --table-name notes
aws dynamodb put-item --table-name notes --item '{"id":{"S":"n1"},"msg":{"S":"hello"}}'
aws dynamodb get-item --table-name notes --key '{"id":{"S":"n1"}}'
操作結果1 コマンドあたりの時間
s3 mb / s3 cp / s3 lsmake_bucket: aicodewith-emu-demo、24 バイトをアップロード、一覧に hello.txt約 0.55〜0.6 秒
dynamodb create-tableステータス CREATING約 0.5 秒
テーブル作成直後の put-itemResourceNotFoundException: Requested resource not found約 0.5 秒
wait table-exists 後の put-item / get-item書き込み成功、{"id":"n1","msg":"hello"} を読み戻し約 0.5 秒
sqs create-queue / send-message / receive-message送ったメッセージ本文 "hi" を受信約 0.5 秒
lambda create-function(Python 3.13)+ invokeStatusCode: 200、関数の戻り値は {"ok": true, "echo": {"a": 1}}約 0.6 秒

1 コマンド約 0.5 秒のほとんどは AWS CLI 自体の起動時間で、エミュレーターの応答は速いです。

知っておきたい挙動が 2 つあり、どちらも本物の AWS と同じです。

  • 作成直後の DynamoDB テーブルにはすぐ書き込めません。 作成直後のステータスは CREATING で、すぐに put-item すると ResourceNotFoundException になります。書き込む前に aws dynamodb wait table-exists を実行するか、コードで waiter を使ってください。エージェントが書くテストが最もつまずきやすい箇所です。
  • Lambda はロールの信頼ポリシーをチェックします。 最初に Statement が空のロールで関数を作ろうとしたところ、The role defined for the function cannot be assumed by Lambda で失敗しました。信頼ポリシーに lambda.amazonaws.com の sts:AssumeRole を追加すると作成できました。

Claude Code・Codex・Cursor をエミュレーター相手に動かす

方法 1:公式の aws-emulator skill をインストール

AI コーディングエージェント向けガイドによると、AWS CLI 2.35.0 以降なら 1 コマンドで公式 skill をインストールできます。あとはエージェントに「Install AWS Emulator and point my project at it」と頼むだけです。

bash
aws agent-toolkit add-skill --skill-name aws-emulator --region us-east-1

このコマンドはマシン上で見つかったすべてのエージェントに skill をインストールし、AWS アカウントは不要です。AWS CLI 2.40.1 では 1 回約 0.6 秒で、見つかったエージェントごとに次のディレクトリへ書き込まれました。

  • Claude Code:~/.claude/skills/aws-emulator/
  • Codex:~/.agents/skills/aws-emulator/
  • Cursor:~/.cursor/skills/aws-emulator/

注意:AWS_ENDPOINT_URL を設定したシェルでこのコマンドを実行しないでください。最初はエミュレーターに向けたターミナルで実行してしまい、skill のダウンロード要求までエミュレーターに送られて UnknownService ... GetLatestSkillVersion になりました。新しいターミナルで実行すれば解決します。

skill の中身はドキュメントのみでスクリプトはありません。Linux、Docker、Rust 組み込みモードのインストール手順、各 SDK の接続方法、エラー対応表、「自分のプロジェクトがエミュレーターで動くか」の互換性チェック手順が入っています。skill の一般的な仕組みは「Agent Skills の使い方」を参照してください。

方法 2:環境変数を設定してエージェントにタスクを渡す

Claude Code、Codex、Cursor のエージェントはいずれもターミナルでコマンドを実行します。いちばん手軽なのは、エージェントを起動するターミナルで前節の環境変数を設定しておくことです。エージェントが実行する aws コマンドや boto3 のテストは自動的にエミュレーターへ送られ、エージェントが間違えても本物のアカウントには触れません。Cursor のターミナルも同じ環境変数を読みます。今回 Cursor では skill のインストールだけを行い、タスクは実行していません。

Claude Code と Codex には同じタスクを渡しました。プロジェクトは空の Python リポジトリで、.venv に boto3 1.44.1 と pytest 9.2.0 を入れてあります。

text
The shell already points the AWS CLI and SDKs at a local AWS Emulator (AWS_ENDPOINT_URL=https://127.0.0.1:9297); never use a real AWS account.
1. Write notes.py with save_note(bucket, table, note_id, text): put the text in S3 at notes/<note_id>.txt and put an item {id, s3_key} in the DynamoDB table; and get_note(bucket, table, note_id) that returns the text by reading the item and then the S3 object.
2. Write tests/test_notes.py with pytest: create a uniquely named bucket and table (string key "id", PAY_PER_REQUEST, wait until the table exists) against the emulator, then test save/get round trip and that get_note of a missing id raises KeyError.
3. Run .venv/bin/pytest -q until it passes, then verify with the aws CLI that the object and item exist. Finish with a 3-line summary.
クライアントモデル実時間結果
Claude Code 2.1.319(claude -p)claude-opus-5-5約 32.3 秒、5 ターンnotes.py と tests/test_notes.py を作成、2 passed。aws CLI でオブジェクト notes/n1.txt と対応するアイテムを確認
Codex CLI 0.167.0(codex exec)gpt-6.1-sol約 80.9 秒notes.py、tests/test_notes.py に加えて pytest.ini も作成。2 passed in 3.36s、その後スクリプトでオブジェクトとアイテムを確認

どちらも自分から get_waiter("table_exists") を使い、「作成直後に書き込む」落とし穴を避けていました。その後、Claude Code のディレクトリで自分たちでも .venv/bin/pytest -q を再実行し、やはり 2 passed in 3.24s でした。aws s3 ls には両方の実行で作られた notes-test-* バケットが表示されます。エージェントの自己報告は参考にしつつ、最終的には自分で再実行した結果で判断してください。

今回はどちらも非対話モードで、Claude Code には --permission-mode bypassPermissions、Codex には --dangerously-bypass-approvals-and-sandbox を付けました。これは使い捨てのテストディレクトリ向けです。実際のリポジトリでは hooks で危険なコマンドを止めましょう。詳しくは「Claude Code / Codex / Cursor の Agent Hooks 設定」を参照してください。Claude Code と Codex を 1 つの画面から操作したい場合は「T3 Code で Claude Code と Codex を使う」が参考になります。

Claude Code / Codex を AICodeWith API Key につなぐ

上のテストでは、どちらのクライアントも AICodeWith API Key を使いました。公式サブスクリプションでログインしたくない場合は、各 CLI のグローバル設定を書くだけです。

Claude Code は ~/.claude/settings.json を書きます(詳しくは「Claude Code のサードパーティ API 設定」)。

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "あなたの AICodeWith API Key"
  }
}

Codex は ~/.codex/config.toml を書きます(ダウンロードとインストールは「Codex のダウンロード」、各項目は「Codex config.toml 設定ガイド」)。

toml
model_provider = "aicodewith"
model = "gpt-6.1-sol"

[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "あなたの AICodeWith API Key"

書いたら、まず単体で確認します:claude -p "Reply with exactly: pong" と codex exec --skip-git-repo-check "Reply with exactly: pong"。今回はどちらも pong を返し、Claude Code は約 4.3 秒、Codex は約 4.8 秒でした。

2 種類の認証情報を混同しないでください。AICodeWith の Key はエージェントがモデルを呼ぶためだけのものです。AWS 側では、エミュレーターが起動のたびに生成する EMULATOR... で始まる一時キーを使い、モデルの Key とは無関係です。

Create API Key →

CI に組み込む

公式ドキュメントによると、エミュレーターの状態はメモリ上にだけあり、/__admin/health はスクリプトやコンテナが準備完了を待つためのものです。以下は GitHub Actions の例で、インストールと起動のコマンドは上で Debian 上で実行したものと同じです。

yaml
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install and start AWS Emulator
        run: |
          curl -fsSLo aws-emulator.deb https://downloads.aws.com/aws-emulator/packages/aws-emulator/LTS/latest/aws-emulator_amd64.deb
          sudo apt-get install -y ./aws-emulator.deb
          aws-emulator -t off &
          until curl -sf --cacert ~/.aws/emulator/9297/ca.pem https://127.0.0.1:9297/__admin/health; do sleep 0.2; done
      - name: Run tests against the emulator
        run: |
          export AWS_ENDPOINT_URL=https://127.0.0.1:9297
          export AWS_SHARED_CREDENTIALS_FILE=~/.aws/emulator/9297/emulator_credentials
          export AWS_CONFIG_FILE=~/.aws/emulator/9297/config
          export AWS_EC2_METADATA_DISABLED=true AWS_DISABLE_HOST_PREFIX_INJECTION=true
          export AWS_REGION=us-east-1 AWS_DEFAULT_REGION=us-east-1
          pytest -q

CI ジョブの環境変数に本物の AWS 認証情報を入れないでください。これは AWS の推奨でもあります。

制限:できないこと

AWS News Blog と Fidelity ドキュメントによると:

  • IAM ポリシーを評価しません。 AWS では拒否されるリクエストがエミュレーターでは成功することがあります。セキュリティのテストには使わないでください。
  • 単一アカウント・単一リージョンのみ。 クロスアカウントやクロスリージョンの挙動はありません。
  • 未実装の操作は HTTP 501(`NotImplemented`)を返します。 テストは黙って通るのではなく、すぐに失敗します。
  • フィデリティはサービスごとに異なります。 コントロールプレーン API(リソースの作成・参照・削除)が最も AWS に近く、データプレーン API や CloudFormation、Terraform、CDK などの IaC ツールのサポートはサービスによって差があります。各リリースのサービス別フィデリティスコアは GitHub Releases に公開され、テスト一式は aws-emulator-evaluation-suite リポジトリで公開されています。
  • 再起動するとすべて消えます。 停止して再起動すると、作成済みのバケットやテーブルはなくなり、emulator_credentials の Access Key も EMULATORC3... から EMULATOR1D... に変わりました。再起動のたびに認証情報ファイルを読み直してください。

よくあるエラーと対処

エラー / 症状原因対処
AccessDenied: Sign the request with the emulator credentials別のキーで署名している。例:環境変数に残った本物の AWS キー(今回はダミーのキーで発生)unset AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_SESSION_TOKEN AWS_PROFILE し、AWS_SHARED_CREDENTIALS_FILE を今回の起動の emulator_credentials に向ける
DynamoDB テーブル作成直後の ResourceNotFoundExceptionテーブルがまだ CREATING(今回発生)aws dynamodb wait table-exists、またはコードで waiter を使う
UnknownService: could not resolve a target serviceエミュレーター宛てではないリクエストが送られた。例:AWS_ENDPOINT_URL を設定したターミナルで skill をインストール(今回発生)AWS_ENDPOINT_URL を設定していないターミナルで実行
SSL: CERTIFICATE_VERIFY_FAILEDクライアントが今回の ca.pem を信頼していないAWS_CONFIG_FILE を設定。Node は NODE_EXTRA_CA_CERTS、Java は truststore.p12。証明書検証は無効にしない
sts get-caller-identity に本物のアカウントが出るそのコマンドに AWS_ENDPOINT_URL が効いておらず、AWS に送られた環境変数を設定したターミナルやスクリプトで実行
Address already in useポートが使用中別ポートにする(例:aws-emulator -p 9300)。環境変数のポートも合わせて変更
NotImplemented / HTTP 501インストール済みのバージョンでその操作が未実装最新版に更新し、Releases でそのサービスのフィデリティスコアを確認

FAQ

AWS Emulator の API は本物の AWS と同じですか?

AWS によると、AWS SDK と同じ Smithy API モデルから作られているため、リクエストとエラーの形式は AWS と同じです。挙動が一致するかどうかはサービスごとのフィデリティスコア次第です。今回遭遇した DynamoDB の CREATING 状態や Lambda の信頼ポリシーチェックは、どちらも AWS と同じでした。

macOS に直接インストールできますか?

直接はできず、Docker を使います。公式が出しているのは Linux パッケージだけで、macOS と Windows では公式 Dockerfile からイメージをビルドします。

本番環境やセキュリティテストに使えますか?

使えません。公式は開発とテスト専用だと明言しており、IAM ポリシーを評価せず、本番ワークロードにも向きません。

エージェントが誤って本物の AWS リソースを変更しませんか?

エージェントを起動するターミナルで AWS_ENDPOINT_URL を設定し、本物の認証情報を unset していれば、リクエストは自分のマシンにしか送られません。エミュレーターも自分が生成した EMULATOR... キーで署名されたリクエストしか受け付けません。始める前に一度 aws sts get-caller-identity を実行し、アカウントが 000000000000 であることを確認しましょう。

Claude Code、Codex、Cursor のどれが向いていますか?

3 つとも使えます。どれも公式 skill をインストールでき、ターミナルの環境変数をそのまま引き継ぎます。今回の同じタスクでは、Claude Code も Codex も一発で通りました。普段使っているものを選べば十分です。

Create API Key →

参考資料

相关文章

UI SDK とは何か、どう使うか?Vercel と shadcn が Agent 向けに出した振る舞いライブラリを、Claude Code / Codex / Cursor でインストールして実測する(0.1.0-beta.1)

UI SDK とは何か、どう使うか?Vercel と shadcn が Agent 向けに出した振る舞いライブラリを、Claude Code / Codex / Cursor でインストールして実測する(0.1.0-beta.1)

UI SDK は、Vercel が 2026 年 11 月 12 日に公開した Agent 向けの振る舞い(behaviors)ライブラリで、バージョンは 0.1.0-beta.1 です。振る舞いはフレームワーク非依存の @ui-sdk/core にあり、React、Vue、Svelte、Solid、Web Components のアダプターが描画します。公式ドキュメントに沿って「何か」「どう入れるか」「Claude Code / Codex / Cursor に skill をどう渡すか」を整理し、テスト機で実際に走ったコマンド、所要時間、出力を記録します。

T3 Code とは?インストール方法、Claude Code・Codex との接続、サードパーティ API Key の設定とよくあるエラー(0.1.9 で検証)

T3 Code とは?インストール方法、Claude Code・Codex との接続、サードパーティ API Key の設定とよくあるエラー(0.1.9 で検証)

T3 Code は pingdotgg が公開しているオープンソースのコーディングエージェント用コンソールです。モデルは内蔵しておらず、マシンにインストール済みの Claude Code、Codex、Cursor などの CLI を操作します。Linux 上で T3 Code 0.1.9 を検証し、インストールコマンド、Claude Code と Codex を AICodeWith API Key につないで T3 Code から操作する設定、t3 thread コマンドで両方を動かした結果、実際に出たエラーと対処法をまとめました。

Claude Code / Codex / Cursor Agent Hooks の設定方法:PreToolUse 比較、最小スクリプトと fail-open の実測

Claude Code / Codex / Cursor Agent Hooks の設定方法:PreToolUse 比較、最小スクリプトと fail-open の実測

Instructions、AGENTS.md、skills はモデルが無視できる提案にすぎない。hooks は harness が固定タイミングで実行する決定論的スクリプトだ。本記事では Claude Code、Codex、Cursor の PreToolUse(または同等イベント)について、設定パス・イベント名・exit 2 / deny・fail-open と fail-closed を比較し、Claude Code で実測済みの最小インターセプトスクリプトを示す。