Claude / Claude Code 設定

Claude Code は Anthropic 公式のターミナルコマンドライン AI コーディングアシスタントです。4AICode API 経由で接続すると、キー、チームのクォータ、利用状況を一つのコンソールで管理でき、実際のトークン使用量に基づいて課金されます。

💡 初心者向け：まず [方法 1：クイックスクリプトのインストールと設定] から始めることをおすすめします。コマンド 1 つですべてを自動処理でき、時間と手間を省けます。

経路の選択について： 4AICode はアカウントとトークンを共有する 2 つの切り替え可能なネットワーク経路を提供します。

• 国際経路（海外ユーザー推奨）：https://relay.4aicode.com を使用。
• 中国本土直結経路：https://relay.4aicode.net を使用（中国本土からの直結でより安定）。

前提条件：トークンの取得

どの設定方法でも、まず 4AICode トークンが必要です。

1. 4AICode にサインインし、ダッシュボード → トークン管理（中国本土では 4aicode.net/tokens）へ移動。
2. 「新規トークン」 をクリック。
3. 生成された文字列（sk-4ai-<your-token> 形式）をコピー。

⚠️ 重要なセキュリティ注意：

• トークンは作成時に一度だけ表示されます。パスワードマネージャーまたはメモアプリに保存してください。
• 本ガイド内の sk-4ai-<your-token> はすべてプレースホルダーです。実際のトークンに置き換えてください。
• トークンはパスワードと同様に扱い、共有したり GitHub にコミットしたりしないでください。シェルコマンドに直接入力したトークンはターミナル履歴に残ります。必要に応じて履歴をクリアしてください（例：history -c またはターミナル履歴ファイルの削除）。

方法 1：クイックスクリプトのインストールと設定（初心者向け）

お使いの OS に合ったタブを選択してください。

# Official installer command
curl -fsSL https://claude.ai/install.sh | bash

# International route (recommended for overseas/global network)
cat <<'EOF' >> ~/.zshrc
export ANTHROPIC_BASE_URL=https://relay.4aicode.com
export ANTHROPIC_AUTH_TOKEN=sk-4ai-<your-token>
export ANTHROPIC_API_KEY=sk-4ai-<your-token>
EOF
source ~/.zshrc

# Note: If you use bash instead of zsh (e.g., on some Linux distros), replace ~/.zshrc with ~/.bashrc

claude

方法 2：グローバル設定ファイル（すっきりした方法）

環境変数に加え、Claude Code は settings.json によるグローバル設定をサポートします。シェル環境をきれいに保ち、確実に永続化できます。

設定ファイルのパス：

• macOS / Linux：~/.claude/settings.json
• Windows：%USERPROFILE%\.claude\settings.json

このファイルを開くか作成し、env キー下に設定を挿入します（既存設定がある場合は保持し、env オブジェクトをマージ）。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://relay.4aicode.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-4ai-<your-token>",
    "ANTHROPIC_API_KEY": "sk-4ai-<your-token>"
  }
}

保存後、ターミナルまたは Claude Code を再起動して反映させてください。

上級：Claude Code で他のトップモデルを使う

4AICode バックエンドゲートウェイはインテリジェントなモデルルーティングを提供します。Claude Code の洗練されたターミナル UI のまま、裏側で ChatGPT（GPT-5.6 / GPT-6）や Kimi K3 を動かせます。

0. Claude Code で Claude Opus 5.5 Kiro を使う（最高コスパ）

Claude Opus 5.5 Kiro は 4AICode 独占の Claude Code 最適化版で、割引料金により優れたコスパを提供します。

# Using Claude Opus 5.5 Kiro (Recommended)
export ANTHROPIC_BASE_URL=https://relay.4aicode.com
export ANTHROPIC_AUTH_TOKEN=sk-4ai-<your-token>
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5-kiro
export ANTHROPIC_MODEL=opus
claude

用途：

• 複雑なコード生成とアーキテクチャ設計
• 多段推論と問題解決
• 大規模コンテキスト処理（200K tokens）
• 技術ドキュメント作成とコードレビュー

1. Claude Code で ChatGPT モデルを使う

モデル環境変数を設定するだけです。/v1/messages リクエスト受信時、ゲートウェイは要求された gpt-* モデルに対応する上流サービスを選択します。

# Recommended daily driver: GPT-5.6 Terra
export ANTHROPIC_BASE_URL=https://relay.4aicode.com
export ANTHROPIC_AUTH_TOKEN=sk-4ai-<your-token>
export ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-5.6-terra
export ANTHROPIC_MODEL=opus
claude

# Top-tier flagship: GPT-6 Astra
export ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-6-astra
export ANTHROPIC_MODEL=opus
claude

# Complex architecture & deep reasoning: GPT-5.6 Sol with ultra-high reasoning
export ANTHROPIC_BASE_URL=https://relay.4aicode.com
export ANTHROPIC_AUTH_TOKEN=sk-4ai-<your-token>
export ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-5.6-sol
export ANTHROPIC_DEFAULT_OPUS_MODEL_NAME="4AICode GPT 5.6 Sol"
export ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES=effort,xhigh_effort,thinking,adaptive_thinking,interleaved_thinking
export ANTHROPIC_MODEL=opus
export ANTHROPIC_DEFAULT_HAIKU_MODEL=gpt-5.4-mini
export CLAUDE_CODE_EFFORT_LEVEL=xhigh
claude

2. Claude Code で Kimi K3 を使う（超長 1M コンテキスト）

大規模コードベースや大量ドキュメントの分析が必要な場合は Kimi K3 を接続。専用ガイドを参照： 👉 詳細ガイド：Claude Code で Kimi K3 を使う

その他のツールと SDK 連携

4AICode は公式 Anthropic API 仕様と完全互換のため、Anthropic 対応 SDK やツールとシームレスに連携できます。

1. 統一接続パラメータ

• Base URL：https://relay.4aicode.com（中国本土では https://relay.4aicode.net）
• API Key / トークン：4AICode トークン（sk-4ai-<your-token>）

2. Node.js / TypeScript SDK

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://relay.4aicode.com",
  apiKey: "sk-4ai-<your-token>",
});

const msg = await client.messages.create({
  model: "claude-sonnet-4-6",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Hello!" }],
});

console.log(msg.content);

3. Python SDK

import anthropic

client = anthropic.Anthropic(
    base_url="https://relay.4aicode.com",
    api_key="sk-4ai-<your-token>",
)

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, please write a quicksort algorithm."}
    ]
)

print(message.content[0].text)

4. cURL リクエスト例

4AICode は Anthropic 公式の x-api-key ヘッダーと標準の Authorization: Bearer ヘッダーの両方をサポートします。

# Option A: Using x-api-key (Anthropic standard)
curl https://relay.4aicode.com/v1/messages \
  -H "x-api-key: sk-4ai-<your-token>" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 128,
    "messages": [{"role": "user", "content": "ping"}]
  }'

# Option B: Using Authorization: Bearer
curl https://relay.4aicode.com/v1/messages \
  -H "Authorization: Bearer sk-4ai-<your-token>" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 128,
    "messages": [{"role": "user", "content": "ping"}]
  }'

よくある質問（FAQ）

Q1: claude: command not found またはコマンドが認識されない？

• 原因：Claude Code が未インストール、またはターミナルの PATH が更新されていない。
• 対処：ターミナルを完全に閉じて開き直す。続く場合：
  • macOS/Linux：公式インストーラー curl -fsSL https://claude.ai/install.sh | bash を再実行し、~/.local/bin が PATH に含まれることを確認。
  • Windows：PowerShell で irm https://4aicode.com/claude-install.ps1 | iex を実行（PATH を自動設定）。

Q2: 401 Unauthorized または無効なトークン？

• 原因：トークン文字列が誤り、コピー時に欠落、またはプレースホルダーの置換漏れ。
• 対処：ダッシュボード → トークン管理 でトークンを確認または再作成。sk-4ai- で始まることを確認。

Q3: 環境変数や settings.json の変更が反映されないのはなぜ？

• 原因：現在のターミナルプロセスが以前の変数をキャッシュしている、または settings.json が環境変数より優先される。
• 対処：実行中の Claude セッションを完全終了し、ターミナルを再起動。settings.json の値はターミナル環境変数を上書きすることに注意。

Q4: 一般的な HTTP エラーコード