コンテンツにスキップ

Codex

Codex は OpenAI の Responses API と通信します。ai& は OpenAI 互換の /v1/responses エンドポイントを公開しているため、カタログ 内の tool_calling 対応モデルであればエージェントループを駆動できます。

前提: Node.js 18 以降。

Terminal window
npm install -g @openai/codex

インストールを確認 — codex --version がバージョン番号を表示するはずです:

Terminal window
codex --version

以下の設定はキーを環境変数 AIAND_API_KEY から読み取るため、Codex がキーをディスクに保存することはありません。

Terminal window
export AIAND_API_KEY="sk-your-aiand-api-key"

ターミナルをまたいで有効にするには、この行を ~/.zshrc または ~/.bashrc に追記してください。

Codex 0.141 以降は、各プロファイルを専用ファイル ~/.codex/<name>.config.toml に保存します。~/.codex/aiand.config.toml を作成してください:

model = "moonshotai/kimi-k3"
model_reasoning_effort = "high"
model_provider = "aiand"
web_search = "disabled"
[model_providers.aiand]
name = "ai&"
base_url = "https://api.aiand.com/v1"
wire_api = "responses"
[model_providers.aiand.auth]
command = "sh"
args = ["-c", "echo $AIAND_API_KEY"]
[tools]
view_image = false
[features]
unified_exec = false
apps = false
browser_use = false
browser_use_external = false
computer_use = false
image_generation = false
multi_agent = false
in_app_browser = false

model_reasoning_effort の行は重要です。Codex の組み込みデフォルトは medium ですが、サポートされる推論レベルはモデルごとに異なり、モデルの reasoning_efforts にないレベルはエラーになります。moonshotai/kimi-k3 は high を受け付けるため、ここでは high を明示的に指定するのが安全な選択です。モデルを切り替える前に GET /v1/models の reasoning_efforts を確認してください。

[model_providers.aiand.auth] ブロックは、Codex に ai& のモデルカタログを取得させるためのものです。Codex 0.157 以降は、コマンドで認証するプロバイダーに対してのみカスタムプロバイダーのモデル一覧を取得します。単に env_key = "AIAND_API_KEY" とした場合もリクエスト自体は動作しますが、Codex は同梱のメタデータにフォールバックし、/model に「Unknown model」の警告が表示され、各 ai& モデルがサポートする推論レベルも提示されません。このコマンドは、手順 2 で設定した環境変数からキーを出力するだけです。

[features] ブロックも重要です。ai& は標準的な 関数ツール(function tools) を提供しており、コーディングのエージェントループに必要なのはこれだけです。一方で Codex のホスト型・組み込みツール(ウェブ検索、画像生成、ブラウザ・コンピューター操作)やツールをまとめるラッパーには対応していません。有効のままだと Codex は API に拒否されうるツール種別を送信し(tool type … not supported)てしまうため、プロファイルでこれらを無効化します。

1 ステップで保存できます:

Terminal window
mkdir -p ~/.codex && cat > ~/.codex/aiand.config.toml <<'EOF'
model = "moonshotai/kimi-k3"
model_reasoning_effort = "high"
model_provider = "aiand"
web_search = "disabled"
[model_providers.aiand]
name = "ai&"
base_url = "https://api.aiand.com/v1"
wire_api = "responses"
[model_providers.aiand.auth]
command = "sh"
args = ["-c", "echo $AIAND_API_KEY"]
[tools]
view_image = false
[features]
unified_exec = false
apps = false
browser_use = false
browser_use_external = false
computer_use = false
image_generation = false
multi_agent = false
in_app_browser = false
EOF
Terminal window
codex --profile aiand

または非対話モードで実行 — --full-auto を付けるとエージェントがワークスペース内のファイルを編集できます:

Terminal window
codex exec --profile aiand --full-auto "src/math.js の失敗しているテストを修正して"

シェルからワイヤレベルの経路を確認します — 一致すればキーが認証され、そのモデルが組織で利用可能なことを意味します:

Terminal window
curl -sS https://api.aiand.com/v1/models \
-H "Authorization: Bearer $AIAND_API_KEY" \
| grep -o 'moonshotai/kimi-k3'