Claude Code

Codzen で Claude Code を使用して、プロバイダーのフェイルオーバー、予算管理、使用状況の可視化を実現します。

Codzen で Claude Code を使用する理由

Codzen は Claude Code と Anthropic の API の間に信頼性と管理レイヤーを追加し、あなたと組織にいくつかの主要な利点をもたらします。

クイックスタート

このガイドでは、Claude Code を Codzen で実行するための準備をわずか数分で完了できます。

ステップ 1: Claude Code をインストール

macOS、Linux、WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

npm install -g @anthropic-ai/claude-code

ステップ 2: Claude を Codzen に接続

Anthropic に直接ログインする代わりに、Claude Code を Codzen に接続します。これにはいくつかの環境変数を設定する必要があります。

要件:

ベース URL として https://codzen.ai を使用
Codzen API キーを認証トークンとして提供
重要: Anthropic API キーを明示的に空白にして競合を防止

シェルプロファイルに以下の環境変数を追加します:

# nano でシェルプロファ��ルを開く
nano ~/.zshrc # または Bash ユーザーの場合は ~/.bashrc

# ファイルに以下の行を追加:
export CODZEN_API_KEY="<your-codzen-api-key>"
export ANTHROPIC_BASE_URL="https://codzen.ai"
export ANTHROPIC_AUTH_TOKEN="$CODZEN_API_KEY"
export ANTHROPIC_API_KEY="" # 重要: 明示的に空にする必要があります

# 保存後、ターミナルを再起動して変更を反映させます

永続性: これらの行をシェルプロファイル (~/.bashrc、~/.zshrc、または ~/.config/fish/config.fish) に追加することをお勧めします。

プロジェクトディレクトリに .claude/settings.json ファイルを作成します:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://codzen.ai",
    "ANTHROPIC_AUTH_TOKEN": "<your-codzen-api-key>",
    "ANTHROPIC_API_KEY": ""
  }
}

変数の場所: これらをプロジェクトレベルの .env ファイルに入れないでください。ネイティブ Claude Code インストーラーは標準の .env ファイルを読み込みません。

以前のログイン: 以前 Anthropic で Claude Code にログインしていた場合、Codzen 設定が有効になる前に Claude Code セッション内で /logout を実行してキャッシュされた認証情報をクリアしてください。

ステップ 3: セッションを開始

プロジェクトディレクトリに移動して Claude Code を開始します:

cd /path/to/your/project
claude

接続完了です！送信するすべてのプロンプトは Codzen を通じてルーティングされます。

ステップ 4: 確認

Claude Code 内で /status コマンドを実行して接続を確認できます。

> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://codzen.ai

Codzen ダッシュボードでリアルタイムにリクエストが表示されるのを確認することもできます。

仕組み

Codzen は Anthropic Messages API と互換性のあるエンドポイントを公開しています。

直接接続: ANTHROPIC_BASE_URL を https://codzen.ai に設定すると、Claude Code はネイティブプロト��ルで直接 Codzen と通信します。ローカルプロキシサーバーは不要です。
Anthropic 互換性: Codzen の Anthropic 互換エンドポイントは Anthropic API とまったく同じように動作します。モデルマッピングを処理し、「Thinking」ブロックやネイティブツール使用などの高度な機能をパススルーします。
課金: Codzen クレジットを使用して課金されます。使用状況 (推論トークンを含む) は Codzen ダッシュボードに表示されます。

Agent SDK

Anthropic Agent SDK を使用すると、Python または TypeScript を使用してプログラムで AI エージェントを構築できます。Agent SDK は Claude Code をランタイムとして使用するため、上記と同じ環境変数を使用して Codzen に接続できます。

GitHub Action

Codzen は公式の Claude Code GitHub Action で使用できます。サンプルワークフローを Codzen に適応させるには、アクションステップに 2 つの変更を加えます:

anthropic_api_key 経由で Codzen API キーを渡す (GitHub シークレット CODZEN_API_KEY として保存)
ANTHROPIC_BASE_URL 環境変数を https://codzen.ai に設定

- name: Run Claude Code
  uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.CODZEN_API_KEY }}
  env:
    ANTHROPIC_BASE_URL: https://codzen.ai

トラブルシューティング

認証エラー: ANTHROPIC_API_KEY が空の文字列 ("") に設定されていることを確認してください。設定されていない (null) 場合、Claude Code はデフォルトの動作にフォールバックし、Anthropic サーバーで認証を試みる可能性があります。
コンテキスト長エラー: コンテキスト制限に達した場合は、タスクをより小さなチャンクに分割するか、新しいセッションを開始することを検討してください。
プライバシー: Codzen はアカウント設定でプロンプトログを明示的にオプトインしない限り、ソースコードプロンプトをログに記録しません。詳細はプライバシーポリシーを参照してください。

Claude Code

On this page