Cursor 日本人開発者完全ガイド：Pro 枠の使い切り方と BYOK で広げる選択肢

TL;DR：Cursor は 2026 年現在 Hobby / Pro / Pro+ / Ultra / Teams の 5 段階構成で、Pro $20/月の中身は「Tab 補完無制限」+「premium モデル用に 20 ドル分のクレジット」+「Auto モード無制限」という構造になっている。月の途中でクレジットが枯れたら Auto モードへ落ちるか、Override OpenAI Base URL から BYOK で外部プロバイダに切り替える。日本人開発者にとって BYOK の本命用途は、ofox.ai のような中継を挟んで日本円課金 / 適格請求書発行に対応させること、そして Claude Opus / Sonnet / GPT-5.4 / Gemini 3.1 Pro を 1 つのキーで横断することの 2 点だ。本記事ではプラン構造、BYOK 設定、ofox 連携の実手順、法人運用のチェックポイントまで通しで書く。

Cursor は 2026 年に何を提供するエディタになったか

Cursor は VSCode をフォークして AI 機能を一級市民にしたエディタだ。中核は 3 つに分かれている。

• Tab（補完）：カーソル位置の周辺コンテキストを読んで次のトークン以降を予測する高速補完。Cursor 内製の専用 Tab モデル（Composer とは別系統の補完特化モデル）で動いていて、外部 API へは切り替えられない。
• Composer（チャット / 多ファイル編集）：右ペインのチャットで自然言語で指示を出すと、複数ファイルを横断して編集差分を提案してくる。BYOK で自分の API キーを刺せるのはここ。
• Agent：Composer の延長で、ターミナル実行・ファイル作成・テスト走査まで自律的にやらせるモード。長尺の自動化タスクに向く。Background Agents を使えばリポジトリをクラウドに clone して、エディタを閉じていてもタスクを走らせられる。さらに Cursor 2.0 で追加された Multi-Agent 機能なら、1 つのプロンプトに対して最大 8 体のエージェントを並列で走らせて結果を比較できる。

2026 年 5 月時点で押さえておくべき新機能は、Composer（Cursor 2.0 で投入されたフロンティア級コーディングモデルの内製版）、Build Plan in Parallel（async サブエージェントで Plan の独立ステップを並走）、PR Review、Skills のクイックアクセスピン、Context Usage Breakdown（コンテキストを何に食われているか可視化）あたり。Tab → Composer → Agent → Background Agent と縦深を伸ばし続けているのが、ここ 1 年の方向だ。

2026 年プラン構造を整理する

公式が出している 5 プランを、日本人開発者の用途別に整理した。

注意点が 2 つある。

1 つめ：年契約で 20% 引きになるが、ドル建て課金なので為替リスクはこちら持ち。$20/月でも 1 ドル = 160 円換算なら月 3,200 円、年契約割引込みでも年 3 万円超になる。経理処理上は外貨建ての都度仕訳が要る。

2 つめ：Pro の「$20 クレジット」は premium モデル消費分で、内訳は使うモデルで大きく変わる。Claude Opus 4.6 や GPT-5.4 Pro のような最上位を多用すると 1 週間も持たないが、Auto モード（Cursor がモデルを自動選択するモード）は枠外で無制限なので、クレジットが切れた後は Auto に落として乗り切る運用が現実的。

BYOK は何を解決し、何を解決しないか

Cursor の Settings → Models には Override OpenAI Base URL というトグルがあって、ここを ON にすると任意の OpenAI 互換エンドポイントを Composer / Agent から呼べるようになる。Anthropic / Google / Azure OpenAI / AWS Bedrock も別タブで個別に API キーを刺せる。

BYOK でできること：

• Composer / Agent のチャット部分を、自分が契約したプロバイダのキーで動かす
• 課金が Cursor のクレジット枠ではなく、プロバイダ側のアカウントに直接乗る
• Cursor が標準採用していないモデル（後述の ofox 経由なら DeepSeek / Qwen / Grok など）を呼ぶ

BYOK でできないこと：

• Tab 補完を BYOK にする — 補完は Cursor 内製モデル固定。これは仕様で、変えられない
• Zero Data Retention を保ったまま外部キーを使う — ZDR 契約は Cursor の標準モデル経路に紐づくので、BYOK にすると ZDR 適用外。プロバイダ側のポリシーが効く
• オフライン化 — エディタ⇔Cursor バックエンド⇔プロバイダの 3 段経路は変わらない。ローカル完結ではない

3 つめは特に誤解が多い。BYOK にしてもリクエストは Cursor のバックエンドを必ず通る（Cursor 公式ドキュメントに「API キーは暗号化通信でバックエンドに送られ、リクエスト終了後は永続化されない」と明記）。完全な自前ホスト構成にしたければ、Cursor ではなく VSCode + Continue.dev のような別系統を選ぶ判断になる。

ofox.ai を Cursor の BYOK 先にする

ここからが本題。Override OpenAI Base URL 経由で ofox を刺すと、1 本の API キーで Claude / GPT / Gemini / DeepSeek / Grok / Qwen を横断できる構成になる。日本円プリペイドで支払えるので、ドル建て与信枠の取れない法人カードでも通る。

セットアップ手順

1. ofox.ai の API キーを発行

app.ofox.ai にログインして API キーを発行、sk-xxx 形式の文字列をコピーする。日本円プリペイドの場合は最初に残高をチャージしておく。

2. Cursor の設定を開く

Cmd + ,（macOS）または Ctrl + ,（Windows / Linux）で Settings、サイドバーの Models を選択。

3. Override OpenAI Base URL を有効化

OpenAI セクションで Override OpenAI Base URL のトグルを ON にして、ベース URL に以下を入力する。

https://api.ofox.ai/v1

API Key 欄には先ほど発行した sk-xxx を貼る。

4. 使いたいモデル ID を Add Model する

ofox のモデル ID は provider/model-name 形式で、例えば以下のような並びになる（実際の最新ラインアップは https://ofox.ai/ja/models で確認してほしい）：

• openai/gpt-5.4-pro — OpenAI のフラグシップ
• anthropic/claude-opus-4.6 — Anthropic の最上位コーディング
• anthropic/claude-sonnet-4.6 — コスパ重視の主力
• google/gemini-3.1-pro-preview — Google の長文コンテキスト型
• deepseek/deepseek-v4-flash — オープンソース系で価格を絞りたい用途

Cursor の Models 画面の Add Model から、上の文字列をそのままモデル名として登録する。

5. Verify を押して接続確認

Verify ボタンで疎通確認。緑のチェックが出れば Composer / Agent から呼べる状態になっている。

6. 接続テスト

Composer ペインを開き、登録したモデルを選んで print("hello") 程度の小さなプロンプトを投げる。応答が返ってくれば完了。

curl で先に疎通だけ確認したい場合

Cursor の UI に貼る前に、シェルから直接叩いて API キーが生きているか確認したいときの最小コマンドはこれ。

curl https://api.ofox.ai/v1/chat/completions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4.6",
    "messages": [{"role":"user","content":"Hello in 5 words"}]
  }'

JSON が返ってくれば OK。401 が返るときは API キーの綴りミスかチャージ残高ゼロ、404 はモデル ID の typo を疑う。

なぜ日本人開発者にとって ofox 経由が嬉しいか

整理しておくと、こうなる。

1. 日本円で経理処理が完結する

Cursor 公式・OpenAI 公式・Anthropic 公式すべてドル建て課金で、領収書も英語 PDF。日本の経理は適格請求書（インボイス制度）対応のため日本語請求書を要求するケースが増えていて、ofox は日本語インボイスを発行できる。「インボイス番号がない英文領収書では仕入税額控除が取れない」という指摘が経理から飛んでくる前に、最初から ofox 経由にしておくほうが手戻りが少ない。

2. 為替リスクを期末で確定できない事情がある法人にフィット

ドル建てで毎月従量課金されると、月末の経費精算でレートを毎回参照する必要がある。プリペイド型なら買った時点でレートが固定され、JPY 建ての経費として処理できる。

3. 1 つのキーでマルチプロバイダ

Cursor のネイティブ BYOK は OpenAI / Anthropic / Google / Azure / Bedrock のタブが別々で、それぞれにキーを刺す必要がある。ofox 1 本で済ませると、新しいモデル（DeepSeek、Grok、Qwen など）が出てきても Cursor 設定はいじらず、Add Model で文字列を追加するだけで済む。

4. 監査ログ

法人で「誰がいつどのモデルにいくら使ったか」を追跡したい場合、Cursor + ofox の組み合わせなら ofox の管理画面でキー単位の利用ログを見られる。Cursor 公式プランの Teams は組織レベルの集計を出すが、API キー単位の詳細は ofox 側のほうが粒度が細かい。

逆に、ofox を挟むことの代償もある。

• Cursor 公式の Zero Data Retention 保証は外れる — ofox 側のログ保持ポリシーに従う
• 障害時の切り分けが 1 段増える — Cursor 側 / ofox 側 / プロバイダ側のどこで止まったかの判別が必要になる
• Cursor の課金枠は別途残る — Tab 補完は Cursor 側のクレジットを消費する（補完は内製モデル固定なので避けようがない）

法人導入時のチェックポイント

会社のリポジトリで Cursor + BYOK 構成を回す前に、最低限確認しておくべき項目を並べる。

1. 個人情報保護法上の取り扱い

API に送られるコードは、社内データの「越境データ移転」に該当しうる。とくに個人情報（顧客情報、従業員情報、取引先連絡先）を含むテストデータをそのまま IDE で開くと、補完やチャットのコンテキストとして送信される可能性がある。.cursorignore でセンシティブなパスを除外する設定はリポジトリ単位で必須。

# .cursorignore
.env*
config/secrets/
data/customers/
data/personal_*.csv

2. 社内ネットワークとプロキシ

社内 PC に HTTP プロキシが必須の環境では、Cursor 起動時に HTTPS_PROXY を読み込ませる必要がある。社内 CA 証明書を信頼させたい場合は OS の証明書ストアに入れた上で動作確認すれば、Cursor 内蔵の Node.js が拾う。

3. プラン選定の指針

4. ZDR / 機密データの扱い

機密度が極めて高いリポジトリ（金融系、医療系、未公開 M&A 案件など）は、Cursor BYOK 構成より、Claude Code を .gitignore + /permissions 厳格設定で運用するか、社内に閉じた Continue.dev + ローカルモデルにする判断のほうが安全になる場合がある。Cursor を使うなら ZDR が適用される標準プラン経路に留め、機密リポジトリでは BYOK にしない、という線引きも現実的。

トラブルシューティング

実際にハマる順に並べる。

Failed to verify API key（Verify ボタンが赤くなる）

ベース URL の末尾スラッシュ、キーの先頭・末尾空白、Override OpenAI Base URL の ON 忘れの 3 つが多い。https://api.ofox.ai/v1（末尾スラッシュなし）が正解。ブラウザの開発者ツールで Cursor が裏で叩いている URL を覗くと、何に弾かれているかすぐわかる。

model not found が返る

モデル ID の typo か、ofox 側で当該モデルが上架されていないかのどちらか。https://ofox.ai/ja/models に当日の上架リストが出るので、一致しているか確認する。provider/model-name の形式（プロバイダ名のスラッシュ前に注意）。

Composer は動くが Tab 補完が遅い / 効かない

Tab 補完は Cursor 内製モデル固定なので、BYOK 設定とは無関係。Cursor の cursor-server が日本リージョンに到達できているかどうかの問題なので、社内プロキシや VPN を切り分ける。Cursor の Settings → Network から疎通テストできる。

月初なのに Pro クレジットが残り少ない

Composer で Opus 系を 2 セッション回すだけで $5 程度溶けることがある。Settings → Usage から消費の内訳を確認して、ヘビーな探索系は Auto モードか BYOK 経由に逃がす運用に切り替える。

429 Too Many Requests が ofox から返る

プリペイド残高が不足している、またはアカウント単位の流量制限に当たっている。app.ofox.ai のダッシュボードで残高と直近のリクエスト数を確認する。

次のステップ

セットアップが終わったら、最初の 1 週間で以下を試すと使い分けの感覚が掴める。

• Pro 枠を使い切る前提で、まず Auto モードと Composer をどの作業で使い分けるかの線引きを自分の中に作る
• BYOK で ofox を刺し、Composer の中で claude-sonnet-4.6 と gpt-5.4-pro を同じプロンプトに対して比較する（モデルごとの差は意外と大きい）
• .cursorignore をリポジトリにコミットして、チームで除外パスを共有する
• Background Agents（Pro 以上で利用可能）を使う案件があるか棚卸しして、回せそうなタスクを 1 つ流してみる

Cursor は VSCode 互換の使い心地と、Composer / Agent / Tab の縦深がうまく機能するエディタで、Pro $20 の枠だけでも個人開発はかなり戦える。法人運用に持っていくときに「インボイスが出ない」「キー集中管理がしたい」「マルチモデルを 1 本のキーで横断したい」という壁にぶつかったら、その時点で BYOK + ofox を足す、という順番で十分間に合うと思う。最初から全部まとめて構成しようとしないほうが、運用負債を作らずに済む。

---

関連リンク

• Cursor 公式ドキュメント — BYOK / API Keys
• Cursor 公式 — Models & Pricing
• ofox.ai モデル一覧
• ofox.ai API ドキュメント