---
title: "Claude Code の接続"
description: "ANTHROPIC_BASE_URL と ANTHROPIC_AUTH_TOKEN で Claude Code を 1折AI に接続します。環境変数、settings.json、Windows、モデル指定、VS Code 拡張の設定を説明します。"
headingIds: {"最短手順":"section-1","完全な手順":"section-2","ANTHROPIC_AUTH_TOKEN を使う理由":"section-3","モデルマッピング":"section-4","VS Code 拡張":"section-5","オプション設定":"section-6","よくある問題":"section-7"}
---

<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>
Claude Code には 2 つの変数だけが必要です。`ANTHROPIC_BASE_URL` を当方に向け、`ANTHROPIC_AUTH_TOKEN` に API キーを設定します。Anthropic アカウントへのログインは不要です。

## 最短手順

Claude Code をインストール済みで API キーをお持ちの場合、以下の 2 行を `~/.claude/settings.json` に書き込み、`claude` を実行します。

```json title="~/.claude/settings.json"
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}
```

ファイルが既に存在する場合は、この 2 項目を既存の `env` に統合し、他の設定を上書きしないでください。

## 完全な手順

<Steps>
<Step title="Claude Code をインストールする">

インストール済みの場合はスキップできます。以下のコマンドは [Claude Code 公式インストールドキュメント](https://code.claude.com/docs/en/setup) より引用しています。

<CodeGroup>
```bash title="macOS / Linux"
curl -fsSL https://claude.ai/install.sh | bash
```
```powershell title="Windows PowerShell"
irm https://claude.ai/install.ps1 | iex
```
```bash title="Homebrew"
brew install --cask claude-code
```
```bash title="npm（需要 Node.js 22+）"
npm install -g @anthropic-ai/claude-code
```
</CodeGroup>

npm でインストールする場合は `sudo` を付けないでください。

</Step>
<Step title="API キーを取得する">

[コンソール](https://1zheai.com/console?lng=ja) で新しい API キーを作成します。このマシンの Claude Code 専用にすることを推奨します。詳細は [API キーの取得と管理](/ja/docs/api-keys/) を参照してください。

</Step>
<Step title="設定（3つの選択肢）">

settings.json の場所：macOS / Linux は `~/.claude/settings.json`、Windows は `%USERPROFILE%\.claude\settings.json`。

<CodeGroup>
```json title="settings.json（推荐）"
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}
```
```bash title="macOS / Linux 环境变量"
# 写进 ~/.zshrc 或 ~/.bashrc，然后重开终端
export ANTHROPIC_BASE_URL="https://1zheai.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"
```
```powershell title="Windows PowerShell"
# 持久写入当前用户，重开终端后生效
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://1zheai.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的Key", "User")

# 只在当前窗口生效
$env:ANTHROPIC_BASE_URL = "https://1zheai.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的Key"
```
```bat title="Windows CMD"
setx ANTHROPIC_BASE_URL "https://1zheai.com"
setx ANTHROPIC_AUTH_TOKEN "sk-你的Key"
```
</CodeGroup>

`ANTHROPIC_BASE_URL` にはルートアドレスを設定し、`/v1` を追加しないでください。Claude Code が自動的に `/v1/messages` を組み立てます。

</Step>
<Step title="起動して確認する">

プロジェクトディレクトリで `claude` を実行し、起動後に `/status` と入力します。次の 2 行を確認してください。

- base URL の行に `https://1zheai.com` と表示される
- 認証情報の行に、出所が `ANTHROPIC_AUTH_TOKEN` と表示される

その後、質問を 1 つ投げ、[呼び出しログ](/ja/docs/usage-logs/) に新しい記録があるか確認してください。あれば接続成功です。

対話インターフェースに入りたくない場合は、非対話モードで一度試すこともできます（2026-10-15 実測で `ok` が返りました）。

```bash
claude -p "say ok" --model claude-sonnet-4-6
```

</Step>
</Steps>

## ANTHROPIC_AUTH_TOKEN を使う理由

Claude Code には API キーを格納できる変数が 2 つあり、違いは次のとおりです（[公式の説明](https://code.claude.com/docs/en/authentication)）。

| 変数 | 送信方式 | 動作 |
|---|---|---|
| `ANTHROPIC_AUTH_TOKEN` | `Authorization: Bearer <值>` | 設定後すぐに有効になり、確認ダイアログは表示されない |
| `ANTHROPIC_API_KEY` | `x-api-key: <值>` | 対話モードでは初回に、この API キーを使用するか確認するダイアログが表示される |

どちらも当社はサポートしており、`ANTHROPIC_AUTH_TOKEN` を推奨します。**どちらか一方だけを設定してください**。システムに以前の公式の `ANTHROPIC_API_KEY` が残っている場合は削除し、混在による 401 を避けてください。

また、注意すべきルールが 2 つあります。

- `env` の `settings.json` と、ターミナルの export で同じ変数を設定した場合、**settings.json が優先されます**。ターミナルの変更が反映されない場合は、まず settings.json を確認してください。
- プロジェクトの `.claude/settings.json` に API キーを書かないでください。このファイルは通常リポジトリにコミットされます。プロジェクトごとに区別したい場合は、コミットされない `.claude/settings.local.json` を使用してください。

## モデルマッピング

Claude Code 内の `opus`、`sonnet`、`haiku`、`fable` はエイリアスであり、環境変数でそれぞれに対応する具体的なモデルを指定できます。Haiku の階層は Claude Code が一部のバックグラウンドの小タスクを実行するためにも使われます。

| 変数 | 役割 | 例の値 |
|---|---|---|
| `ANTHROPIC_MODEL` | 起動時に使用するモデル | `claude-sonnet-5-5` |
| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `opus` エイリアスの指す先 | `claude-opus-5-5` |
| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `sonnet` エイリアスの指す先 | `claude-sonnet-5-5` |
| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `haiku` エイリアスおよびバックグラウンドタスクで使うモデル | `claude-haiku-5-5` |
| `ANTHROPIC_DEFAULT_FABLE_MODEL` | `fable` エイリアスの指す先 | `claude-fable-5-1` |

```json title="~/.claude/settings.json（带模型映射）"
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
  }
}
```

モデル ID は[サポートされているモデル](/ja/docs/models/) のいずれかである必要があります。実行中でも `/model claude-opus-5-5` で一時的に切り替えられます。

## VS Code 拡張

Claude Code の VS Code 拡張は起動前に認証情報をチェックします。公式では、変数を VS Code 自身のユーザー設定（コマンドパレット → Preferences: Open User Settings (JSON)）に書くことを推奨しています。

```json title="VS Code settings.json"
{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://1zheai.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的Key" }
  ]
}
```

`~/.claude/settings.json` にのみ書いた場合、拡張自体のログインチェックが読み取れない可能性があります。

## オプション設定

| 変数 | 役割 |
|---|---|
| `API_TIMEOUT_MS` | リクエストのタイムアウト。デフォルトは 600000（10 分）。長時間のタスクでタイムアウトしやすい場合は値を大きくしてください |
| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` | 自動更新、テレメトリ、エラー報告などの不要な通信を無効化します。`0` や `false` を設定しても有効とみなされるため、無効化するにはこの変数を削除してください |
| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` | "Extra inputs are not permitted" のような 400 エラーが発生した際に使用します |
| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` | `/model` の一覧を `/v1/models` から取得して利用可能なモデルを表示します |

`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` は動作確認済みです（Claude Code 2.1.296、2026-10-15）：起動後に debug ログに `[gatewayDiscovery] cached 14 models` が表示され、14 個のモデルが[サポートされているモデル](/ja/docs/models/) と一致しました。

`DISABLE_PROMPT_CACHING` は設定しないでください。キャッシュが無効になり、請求額が明確に増加します。詳細は [Prompt Caching](/ja/docs/prompt-caching/) を参照してください。

## よくある問題

<AccordionGroup>
<Accordion title="起動するとすぐにログイン画面が表示される / Please run /login と表示される">

Claude Code が API キーを読み取っていません。変数名のスペルを確認してください。環境変数を使う場合は新しく開いたターミナルで起動したか確認し、settings.json を使う場合は JSON 形式が正しいか確認してください（カンマが 1 つ多いだけで全体が無効になります）。

</Accordion>
<Accordion title="401 / Invalid API key">

API キーのコピーが不完全か、`ANTHROPIC_API_KEY` と `ANTHROPIC_AUTH_TOKEN` が同時に存在し、どちらかが古い値です。どちらか一方だけ残してください。詳細は[エラーコードとトラブルシューティング](/ja/docs/troubleshooting/) を参照してください。

</Accordion>
<Accordion title="404">

`ANTHROPIC_BASE_URL` に `/v1` が余分に付いています。`https://1zheai.com` に修正してください。

</Accordion>
<Accordion title="Opus を選択したのに、ログに Haiku の呼び出しがある">

これは Claude Code が Haiku 階層でバックグラウンドの小タスクを実行しているものです。別のモデルに変更したい場合は `ANTHROPIC_DEFAULT_HAIKU_MODEL` を設定してください。

</Accordion>
<Accordion title="公式アカウントと 1折AI の切り替えは？">

上記の 2 つの変数を削除（またはコメントアウト）すれば公式ログインに戻ります。頻繁に切り替える場合は [CC Switch](/ja/docs/quickstart-cc-switch/) を使い、クリック 1 つで切り替えられます。

</Accordion>
<Accordion title="1折AI を使うと Anthropic アカウントに影響はありますか？">

関連付けは発生しません。1折AI に接続する際、Claude Code は当方の API キーを使用し、お客様の Anthropic アカウントにはログインしません。

</Accordion>
</AccordionGroup>