---
title: "Cursor連携"
description: "カスタムのOpenAI APIキーとBase URLを使って、Cursorから1折AIのClaudeモデルを呼び出す方法と、カスタムAPIキーが使用されない機能について。"
headingIds: {"設定":"section-1","既知の問題":"section-2","よくある質問":"section-3"}
---

<aside className="docs-publication" data-pagefind-ignore>

ドキュメントは [1ZheAI](https://1zheai.com/en/editorial/#publisher) が管理しています。[出典と訂正](https://1zheai.com/en/editorial/)。

エラーを見つけましたか？ページのアドレスと説明を添えて[サポートに連絡](mailto:support@1zheai.com)してください。API キーやアカウント情報は送信しないでください。

</aside>
Cursorでは設定画面から独自のAPIキーを入力でき、チャットモデルはこのAPIキーを使ってリクエストを送信します。以下は1折AIへの接続方法と、事前に知っておくべきいくつかの制限事項です。

<Warning>

始める前に、次の3点を理解してください。

- Cursorの公式ドキュメントによると、**カスタムAPIキーはチャットモデルにのみ適用され、Tab補完は常にCursor独自のモデルを使用します**。
- リクエストはCursorのサーバーを経由してから、入力したアドレスに送信されるため、Base URLは公開アクセス可能でなければなりません（`https://1zheai.com/v1`は問題ありませんが、ローカルの`localhost`プロキシは使用できません）。
- 「Override OpenAI Base URL」トグルはCursorの公式ドキュメントには記載されていません。以下のインターフェースの説明はCursorフォーラムやコミュニティのチュートリアルに基づいており、Cursorのアップデート後に変更される可能性があります。

</Warning>

## 設定

<Steps>
<Step title="モデル設定を開く">

Cursor → **Cursor Settings** → **Models** と進み、Keysセクションを見つけます。

</Step>
<Step title="OpenAI API Key と Base URL を入力">

```text
OpenAI API Key              sk-你的Key（1折AI 的 Key）
Override OpenAI Base URL    https://1zheai.com/v1
```

Base URLには`/v1`を含める必要があります。

</Step>
<Step title="モデルを追加する">

モデル一覧の**Add model**をクリックし、モデルIDを入力します（例：`claude-sonnet-5-5`）。その後、トグルをオンにします。モデルIDについては[対応モデル ](/ja/docs/models/)を参照してください。

</Step>
<Step title="チャットで一度試す">

チャットパネルで新しく追加したモデルを選択し、メッセージを送信します。返信が正常に戻ってきたら、コンソールの[呼び出しログ ](/ja/docs/usage-logs/)でこの呼び出しを確認してください。

</Step>
</Steps>

## 既知の問題

<Warning>

Cursorフォーラムには次のフィードバックがあります。Override OpenAI Base URLを設定した後、名前が`claude-`で始まるモデルはCursorによってAnthropicモデルとして扱われ、Anthropic APIキーで処理されるか、エラーが直接発生することがあります。Claudeを選択する場合、モデルIDは`claude-`で始まります。この問題に遭遇した場合は、まずCursorに入力済みのAnthropic APIキーをすべてクリアしてから再試行してください。

参考：[フォーラム投稿144899 ](https://forum.cursor.com/t/anthropic-models-break-when-override-openai-baseurl-is-set/144899)、[フォーラム投稿146998 ](https://forum.cursor.com/t/override-anthropic-base-url-automatically-switches-on-when-using-anthropic-byok/146998)。

</Warning>

## よくある質問

<AccordionGroup>
<Accordion title="Tab 補完は 1折AI を使いますか？">

いいえ。Cursorの公式ドキュメントによると、Tab補完は常にCursorの組み込みモデルを使用し、あなたのAPIキーを経由しません。

</Accordion>
<Accordion title="Verify をクリックしても失敗する？">

まず、Base URLに`/v1`が含まれていることを確認してください。コミュニティのフィードバックによると、VerifyボタンはOpenAI以外のモデル名では必ずしも通過するとは限りません。チャットで直接メッセージを送信してテストできます。判定基準は呼び出しログに記録があるかどうかです。

</Accordion>
<Accordion title="Agent / Composer は使えますか？">

コミュニティのチュートリアルでは、一般的にカスタムAPIキーを使用するのはChatのみで、Agent、Apply、Inline Editなどの機能は依然としてCursor独自のバックエンドを経由する可能性があると報告されています。実際に呼び出しログに表示される記録を頼りにしてください。

</Accordion>
<Accordion title="エディタで Claude を完全に使いたい？">

主にClaudeでコードを書きたい場合は、[Claude Code ](/ja/docs/quickstart-claude-code/)（コマンドラインまたはVS Code拡張機能）や[Cline ](/ja/docs/quickstart-cline/)の方が、カスタムアドレスのサポートがより完全です。

</Accordion>
</AccordionGroup>