---
title: "APIキーの取得と管理"
description: "1折AIコンソールでsk-で始まるAPIキーを作成し、保管・ローテーション・漏洩時の被害を最小化する方法。"
headingIds: {"APIキーの作成":"section-1","ツールごとに1つのAPIキー":"section-2","保管場所":"section-3","漏洩した場合の対処":"section-4","よくある質問":"section-5"}
---

<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>
APIキー（API key）は1つの呼び出し権限に対応し、アカウントの残高から課金されます。このページでは、作成方法、保管方法、問題発生時の対処を説明します。

## APIキーの作成

<Steps>
<Step title="コンソールにログインする">

[1zheai.com/console](https://1zheai.com/console?lng=ja)を開きます。

</Step>
<Step title="新規作成">

左側メニューの「APIキー」をクリックし、右上の「APIキーを作成」をクリックします。用途がわかる名前を入力します（例：`claude-code-macbook`、`ci-staging`）。他の項目は変更しなくても使用でき、「変更を保存」をクリックします。

フォームで設定できる項目：

| フォーム項目 | デフォルト | 説明 |
|---|---|---|
| 名前 | 空 | 呼び出しログでこの名前によりAPIキーを区別します |
| 有効期限 | 無期限 | 1時間、1日、1ヶ月、または特定の日付と時刻を指定できます |
| 数量 | 1 | 複数を一度に作成すると、名前にランダムなサフィックスが自動的に追加されます |
| 「無制限クォータ」スイッチ | オン | オフにすると「クォータ (USD)」が表示され、このAPIキーはこの金額（米ドル）までしか使用できません |
| モデル制限（「詳細設定」内） | 空（すべてのモデルが使用可能） | モデルを選択すると、このAPIキーはこれらのモデルのみ呼び出せます |
| IPホワイトリスト（「詳細設定」内） | 空（制限なし） | 記載されたIPまたはCIDRネットワークからのみ呼び出しを許可します |

</Step>
<Step title="コピーして保存">

APIキーは`sk-`で始まります。コピー後、パスワードマネージャーまたは環境変数に保存し、チャット、スクリーンショット、コードリポジトリに貼り付けないでください。

</Step>
</Steps>

## ツールごとに1つのAPIキー

ツールごと、マシンごとにAPIキーを作成することを推奨します。利点は3つあります：

- 呼び出しログがAPIキーごとに区別されるため、どのツールがいくら使ったか一目でわかります。
- 1つのAPIキーが漏洩した場合、それだけを削除すれば他のツールに影響しません。
- チーム内で誰のAPIキーか責任が明確で、退職やマシン変更時に該当するAPIキーを削除できます。

## 保管場所

<CodeGroup>
```bash title="Shell 配置（macOS / Linux）"
# 写进 ~/.zshrc 或 ~/.bashrc，只在本机生效
export ONEZHE_API_KEY="sk-你的Key"
```
```powershell title="Windows（当前用户，持久）"
[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-你的Key", "User")
# 重新打开终端后生效
```
```bash title=".env（项目本地）"
# .env 要写进 .gitignore
ONEZHE_API_KEY=sk-你的Key
```
</CodeGroup>

<Warning>

Claude Codeのプロジェクトレベルの`.claude/settings.json`は通常リポジトリにコミットされ、Claude Codeの公式ドキュメントもここに認証情報を書かないことを明確に推奨しています。APIキーはユーザーレベルの`~/.claude/settings.json`、またはリポジトリにコミットされない`.claude/settings.local.json`に保管してください。

</Warning>

## 漏洩した場合の対処

1. 「APIキー」一覧で該当のキーを見つけ、「操作」列の「無効化」アイコンをクリックするか、「⋯」メニューから「削除」を選択します。無効化後は即座に失効し、再度使用すると401 `Invalid token`が返されます。
2. 新しいAPIキーを作成し、使用箇所を差し替えます。
3. 呼び出しログ（コンソールメニューの「呼び出しログ」）を開き、「展開」をクリックし、「トークン名」にこのAPIキーの名前を入力してフィルタリングし、最近の呼び出しにあなたが発起していないものがないか確認します。

## よくある質問

<AccordionGroup>
<Accordion title="API キーは Claude Code と Cursor で同時に使えますか？">

はい、APIキーはツールに紐づいていません。ただし混用するとログで誰の支出か区別できないため、分けて作成することを推奨します。

</Accordion>
<Accordion title="Invalid token / 401 と表示されたら、API キーの問題ですか？">

ほとんどの場合、はい。一般的な原因：コピー時に空白や改行が含まれた、APIキーが削除済み、ツールの間違ったフィールドに入力した。項目ごとの切り分けは[エラーコードとトラブルシューティング](/ja/docs/troubleshooting/)を参照してください。

</Accordion>
<Accordion title="API キーは期限切れになりますか？">

デフォルトは無期限です。作成時または編集時に「有効期限」で時刻を設定でき、期限切れ後に呼び出すと401 `Invalid token`が返され、APIキーを間違えた場合のレスポンスと同じです。一覧の「期限」列に各APIキーの有効期限が表示されます。

</Accordion>
</AccordionGroup>