Claude Code と Codex を HiAPI に接続：1 つの Key でタスクごとにモデルを選ぶ

ここ数日、Karpathy が年初に言った一言がまた話題になっている：the new default is that you are not writing the code directly 99% of the time, you are orchestrating agents who do and acting as oversight。訳すとこうだ：新しいデフォルトは、99% の時間は自分でコードを書かず、自分に代わって働く agent を編成し、自分は監督に徹するというものだ。この言葉は彼が agentic engineering という概念を提唱したときの投稿から来ており、No Prior ポッドキャストでもこう補足している：I don't think I've typed a line of code probably since December。

話題になっているとはいえ、これが単なるスローガンではないことはデータが示している。Claude Code の年換算運用収益はすでに $2.5B を超えており（2026 年 2 月の Series G 公式発表ベース、監査済み ARR ではない）、GitHub Copilot が当時 $1B に到達するのに約 3 年かかった。JetBrains の 2026 開発者エコシステム調査（1.5 万人以上の回答者）では、約 90% のプロフェッショナル開発者が毎週 AI プログラミング agent を使っている。Claude Code の業務シーンでの採用率は 18% から 39%（米国では 47%）に、Codex は 3% から 16% に上昇した。

そこに問題もついてくる：agent は増えたのに、設定と請求は依然としてバラバラだ。多くの人は Claude Code と Codex を同時に使っているが、2 つのツールでそれぞれ key を申請し、それぞれにチャージし、それぞれの使用量を見ている。モデルを変えたいだけでも申請フローをもう一度通さなければならない。この記事では、1 つの HiAPI Key で 2 つのツールを接続する方法と、接続後にモデルをどう選び、どう切り替えるかを説明する。

まず結論から

• 1 つの Key で 2 つのツールを管理：HiAPI の API Key は Claude Code と Codex の両方で使え、残高・使用量・請求はすべて 1 つの管理画面に集約される
• それぞれが得意な最強モデルを使う：Claude Code は Anthropic Messages プロトコル（/v1/messages）で HiAPI 上の Claude モデルを使い、Codex は Responses API（/v1/responses）で GPT-6.1 系モデルを使う
• 2 つのレッドライン内での自由：Claude Code は公式に、いかなるゲートウェイ経由でも非 Claude モデルへルーティングすることをサポートしていない。だから正しいやり方は、1 つのツールで何でも使うのではなく、2 つのツールがそれぞれのモデルファミリーに接続することだ
• 最短 5 分で接続完了：/connect/agents ページを開き、ツール・モデル・OS を選んで生成された設定をコピーする。Claude Code と Codex は CC Switch のワンクリックインポートに対応
• モデル変更は 1 か所だけ：Claude Code は settings.json のモデルフィールドを、Codex は hiapi.config.toml の model 行を変更する。Key は変更不要

HiAPI の解決策：1 つの Key、2 つのツール

HiAPI は複数のモデルファミリーを集約する API プラットフォームで、外部にはいくつかの標準プロトコルを統一的に公開している。プログラミング agent に関しては、公式が 4 つのツールのワンクリック接続ページを用意している：/zh/connect/agents（英語版は /en/connect/agents）で、Claude Code、Codex CLI、OpenCode、Hermes Agent に対応している。

プロトコルのマッピングが正しく接続する鍵だ：

ツール	プロトコル	エンドポイントパス	HiAPI 側で選択可能なモデル
Claude Code	Anthropic Messages	/v1/messages	claude-opus-5-5、claude-sonnet-4-6、claude-opus-4-8、claude-opus-4-8@aws（計 4 個）
Codex CLI	Responses API	/v1/responses	gpt-6.1-sol、gpt-6.1-terra、gpt-6-astra、gpt-5.6 系、deepseek-v4 系（計 9 個）
OpenCode / Hermes Agent	Chat Completions	/v1/chat/completions	各ファミリーのテキストモデル、対応範囲が最も広い

つまり、Claude Code の強みは長距離のコーディング agent タスクにあり、Claude ファミリーのフラッグシップを割り当てる。Codex の強みは大量処理にあり、GPT-6.1 系を割り当てる。1 つの Key で両方を認証でき、請求も一本化される。

はっきり言っておくべきことがある：Anthropic は公式に、Claude Code をいかなるゲートウェイ経由でも非 Claude モデルへルーティングすることを明確にサポートしていない。GPT モデルを無理に Claude Code に入れると、ツール呼び出しや agent の挙動が不安定になり、問題が起きても公式のサポートはない。したがって「1 つの Key でいつでもモデルを切り替えられる」の正確な意味は、2 つのツール間でタスクに応じて割り当て、各ツールが自分にとって最強のモデルを使うことであり、1 つのツール内でファミリーを混用することではない。

Claude Code だけを使う場合は、以前書いた単一ツール設定ガイド《HiAPI で Claude Code に接続：月 $100 のサブスク費を節約する完全設定ガイド》も参照してほしい。この記事では 2 つのツールで 1 つの Key を共用する方法と切り替え戦略に焦点を当てる。

接続方法 1（推奨）：/connect/agents ページで設定を生成

最も手間のかからない接続方法で、全程クリック選択だけで、設定を手書きする必要はない：

1. hiapi.ai/zh/connect/agents を開き、「HiAPI をあなたの Agent に接続」をクリック
2. ツールを選択：Claude Code または Codex CLI
3. モデルを選択：例えば Claude Code 側は claude-opus-5-5、Codex 側は gpt-6.1-sol
4. OS を選択：macOS / Windows / Linux。設定内のパスもそれに応じて変わる
5. 生成された設定をコピーし、案内に従って対応するファイルに貼り付ける

Claude Code と Codex は CC Switch のワンクリックインポートに対応：HiAPI の API Keys ページでインポートをクリックすると、ブラウザが CC Switch を起動して設定の書き込みを完了する。インポートリンク自体はあなたのキーを含まず、Key はローカル環境変数に保存されるので安心してよい。

バージョン要件は先に自己確認しておこう：Codex CLI は 0.134 以上が必要で、codex --version で確認する。Claude Code は claude --version で正常にバージョン番号が出力されることを確認する。

接続方法 2：設定ファイルを手動で書く

手動設定も複雑ではない。2 つのファイルがそれぞれ 1 つのツールを担当する。

Claude Code：~/.claude/settings.json

~/.claude/settings.json（Windows は %USERPROFILE%\.claude\settings.json）の env ブロックに記述する：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.hiapi.ai",
    "ANTHROPIC_AUTH_TOKEN": "あなたの HiAPI API Key",
    "ANTHROPIC_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

各フィールドの説明：

• ANTHROPIC_BASE_URL は https://api.hiapi.ai を指す。/v1 は付けない。クライアントが自分で /v1/messages を組み立てる
• ANTHROPIC_AUTH_TOKEN にはあなたの HiAPI API Key を入れる。Bearer 認証で通す
• ANTHROPIC_MODEL と OPUS / SONNET の 2 つのエイリアスはすべて、HiAPI で選んだモデルを指す（HiAPI は公式の Claude モデル ID を提供しないため、エイリアスをまとめてそちらに向ける）
• ANTHROPIC_DEFAULT_HAIKU_MODEL は claude-sonnet-4-6 に固定する。これは Claude Code がバックグラウンドの雑務（コンテキスト圧縮、コミットメッセージ生成など）に使うスロットだ
• CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 は、新しいテキストパイプラインが experimental beta リクエストフィールドを拒否するためで、オフにしておけばトラブルを避けられる

Codex：~/.codex/hiapi.config.toml

~/.codex/hiapi.config.toml（Windows は %USERPROFILE%\.codex\hiapi.config.toml）を新規作成する：

model_provider = "hiapi"
model = "gpt-6.1-sol"

[model_providers.hiapi]
name = "HiAPI"
base_url = "https://api.hiapi.ai/v1"
env_key = "HIAPI_API_KEY"
wire_api = "responses"

次にシェルで環境変数を設定して起動する：

export HIAPI_API_KEY="あなたの HiAPI API Key"
codex --profile hiapi

Windows PowerShell では $env:HIAPI_API_KEY = "..." に対応する。ここでの base_url は /v1 を付ける点に注意。Claude Code 側とは異なるので、両者をコピーして混用しないこと。wire_api = "responses" は Responses プロトコルを使うことを宣言するもので、これは Codex の必須要件だ。

モデルの選び方：複雑なタスクは Opus、大量処理は GPT-6.1

2 つのツールを接続した後は、モデル選択がタスクごとのルーティング問題になる。私たちの提案はシンプルだ：

• 高難度・長距離タスクには claude-opus-5-5：ファイルをまたぐリファクタリング、マラソン的なデバッグ、コードベース全体の理解が必要なタスク。Claude Code 側のフラッグシップで、コンテキストウィンドウは 1M に達する
• 日常的な高頻度の大量処理には gpt-6.1-sol / gpt-6.1-terra：一括書き換え、単一ファイルの機能、スクリプト生成など、タスク量が多く単一タスクは複雑でないもの。安い方のモデルを使えば請求の差は明らかだ
• gpt-6-astra は品質により敏感な Responses シーン向け：価格は一段上がるので、必要に応じて有効化する

主要モデルのプラットフォーム価格（$/M token、2026-10 時点、ベーシック枠）：

モデル	入力	出力	キャッシュ読み取り	コンテキスト
claude-opus-5-5	$2.02	$10.08	$0.10	1M
claude-sonnet-4-6	$3.00	$15.00	$0.30	—
gpt-6.1-sol	$0.50	$2.50	$0.025	1.05M
gpt-6.1-terra	$0.25	$1.25	$0.0125	1.05M
gpt-6-astra	$2.50	$12.50	$0.25	1.05M（272K 超で長文割増枠が適用）

キャッシュ読み取り価格の列に注目してほしい。agent セッションでは大量の token がキャッシュヒットによるもので、gpt-6.1-terra のキャッシュ読み取りはわずか $0.0125/M だ。長いセッションで同じリポジトリを繰り返し変更する場合、実際の請求は入力価格から見積もるよりかなり低くなる。大量処理とコスト削減は二者択一ではない。

Opus 5.5 と GPT-6.1 Sol の能力の方向性を深く比較したい場合は《Claude Opus 5.5 対 GPT-6.1 Sol》を、Terra の最近の値下げ幅と背景については《GPT-6.1 Terra 値下げ分析》に完全な分解がある。2 つのモデルのリアルタイム価格とパラメータはモデル詳細ページを基準とする。

モデル切り替えはどれだけ簡単か

これはこの方案で最も過小評価されている利点だ。モデルの変更は 2 つの動作だけ：

• Claude Code：~/.claude/settings.json の ANTHROPIC_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL の 3 か所の値を変更する（HiAPI では opus/sonnet のエイリアスはすべてそちらを指すので、同じ新しいモデル ID に変えるだけでよい）。セッションを開き直せば反映される
• Codex：~/.codex/hiapi.config.toml の model = "..." の 1 行を変更し、次回の codex --profile hiapi で反映される

Key は最初から最後まで変更不要だ。「各ツールごとに公式 key を個別申請する」という旧来のやり方と比べると、モデル変更のたびに再申請し、承認を待ち、キー管理を変える必要があったが、今は 1 行の設定で済む。CC Switch インポートを使っている場合も、/connect/agents ページでモデルを選び直し、もう一度インポートをクリックすればよい。全程グラフィカル操作だ。

さらに多くのモデルに接続したい場合は、OpenCode と Hermes Agent が Chat Completions プロトコルを使い、選択可能なモデルの対応範囲が最も広く、同じページフローで済む。マルチモーダルやワールドモデル系の新モデルに興味があれば、《Genie 4 ワールドモデル実測》もついでに参照してほしい。

よくある質問

Claude Code は HiAPI 経由で GPT モデルを使えますか？

使えないし、必要もない。Anthropic は公式に、Claude Code をいかなるゲートウェイ経由でも非 Claude モデルへルーティングすることをサポートしていない。無理に接続するとツール呼び出しや agent の挙動が不安定になり、公式のサポートもない。HiAPI 上の Claude Code で選択可能なモデルは claude-opus-5-5、claude-sonnet-4-6、claude-opus-4-8、claude-opus-4-8@aws の 4 つだ。GPT-6.1 系モデルを使いたい場合は Codex 側を使う。Responses プロトコルがネイティブにサポートしている。

1 つの HiAPI Key を Claude Code と Codex で同時に使えますか？

使える。これこそがこの方案の核心だ。2 つのツールは同じ Key を共用し、認証方法は異なる（Claude Code は ANTHROPIC_AUTH_TOKEN、Codex は HIAPI_API_KEY 環境変数）が、どちらも同じ Key だ。残高・使用量・請求は同じ管理画面で確認でき、ツール別にグループ化して集計される。

CC Switch のワンクリックインポートは安全ですか？

安全だ。インポートリンク自体はキーを含まず、Key はあなたのローカル環境変数に保存される。流れは：HiAPI で Key を生成した後、API Keys ページで CC Switch インポートをクリックすると、ブラウザが CC Switch を起動して設定を書き込む。グラフィカルな流れが不安なら、settings.json と hiapi.config.toml を手動で書いても完全に等価だ。

2 つのツールを設定した後、接続できたかどう確認しますか？

Claude Code 側は claude --version を実行してクライアントが正常であることを確認し、その後適当にセッションを開いて一言送り、HiAPI 管理画面で使用量が増えているか見る。Codex 側は CLI 0.134+ が必要で、codex --profile hiapi で起動した後、同様にタスクを 1 つ送って管理画面の計量を確認する。最初はそれぞれ小さなタスクを 1 つずつ実行し、課金とモデル ID が正しいことを確認してから本格的に使うとよい。

OpenCode と Hermes Agent は接続する価値がありますか？

チームの習慣次第だ。この 2 つのツールは Chat Completions プロトコルを使い、選択可能なモデルファミリーが最も多い。1 つのクライアントで複数のモデルファミリーを横断したいシーンに適している。設定フローは Claude Code / Codex と完全に同じで、やはり /connect/agents のページだ。

モデルを変えると進行中のセッションに影響しますか？

変更するのは新しいセッションに反映される設定だ。すでに開いているセッションは起動時に読み込んだモデルを使っているので、設定を変えた後はセッションを開き直せばよい。過去のセッション記録には影響しない。

重要な結論

Karpathy の 99% という言葉がまた話題になっているのは、agentic engineering がもはや先端プレイヤーの遊びではなく、デフォルトの働き方になったことを示している。デフォルトの働き方の下では、Claude Code と Codex を同時に使う人がますます増え、設定と請求の断片化は現実の摩擦だ。HiAPI の方案は 1 つの Key で 2 つのツールに接続する：Claude Code は Messages プロトコルで Claude ファミリーのフラッグシップを、Codex は Responses プロトコルで GPT-6.1 系を使い、それぞれが得意な最強モデルを使い、請求は一本化される。接続は /connect/agents ページで設定を生成し CC Switch でインポートすれば 5 分で動く。モデル変更は設定 1 行で、Key は動かない。タスクに応じたルーティング（難しい問題は Opus 5.5、大量処理は GPT-6.1 Sol/Terra）が、今、品質と請求を同時に抑える最適解だ。