AI支援開発の波の中で、開発者は一流の言語モデルをローカルのワークフローにシームレスに統合するベストプラクティスを常に探している。 アンソロピック 導入済み Claude Code
強力なエンドツーエンドのネイティブAIアシスタントとして、コードベース全体を直接理解して操作できるため、開発効率が大幅に向上する。一方、Amazon AWSのAI IDE Kiro
無料プレビュー版では、人間工学に特化したモデルにアクセスできる。 claude-sonnet-4-20250514
アクセスのこのモデルは、コーディング能力、推論速度、費用対効果において大きなブレークスルーを達成している。
本稿では、コミュニティを通じて開発された2つの軽量ツールという、解決策の賢い組み合わせを紹介する。 Ki2API
歌で応える Claude Code Router
を接続する。このソリューションの目的は、開発者がほとんど手を加えることなく Claude Code
ネイティブ・エクスペリエンスを提供すれば、バックエンドモデルをよりパフォーマンスの高いものに置き換えることも自由だ。 claude-sonnet-4-20250514
.
アーキテクチャの説明:ワークフローはどのように実装されるのか?
ワークフロー全体は、以下のようなローカルリクエストの明確な連鎖を形成する。 Claude Code
フロントエンドと Kiro
モデルのバックエンドは接続されている。
リクエストパス: Claude Code
-> Claude Code Router
-> Ki2API
-> Kiro (claude-sonnet-4-20250514)
- なぜそのような構造が必要なのか?
- 標準化されたOpenAIのインターフェース:
Ki2API
は重要なアダプターの役割を果たしている。ローカルな8989
ポートでサービスを開始する。Kiro
モデルの呼び出しは、OpenAI APIと完全に互換性のある形式でカプセル化されています。/v1/models
歌で応える/v1/chat/completions
パスとストリーミング応答をサポートしています。これにより、OpenAIインターフェイスをサポートするあらゆるクライアントに簡単にアクセスできる。 - 柔軟なリクエスト・ルーティング:
Claude Code Router (CCR)
のスペシャリティだ。Claude Code
設計されたプロキシツールです。これはローカルのコンフィギュレーション・ファイルを読み込んでClaude Code
発行されたさまざまなタイプのリクエスト(通常のコーディング、バックグラウンドタスク、長いコンテキスト処理など)を、それぞれ指定されたバックエンドモデルに転送する。 - モデルの高い可用性:: 採用
Kiro
プラットフォームの使用を安定させることができる。claude-sonnet-4-20250514
モデルこのモデルは、複雑なコーディングタスクや長いプロセス推論を扱う場合に、より優れたパフォーマンスと応答性を発揮する。
- 標準化されたOpenAIのインターフェース:
ローカル設定への3つのステップ
ステップ1: Ki2APIサービスを開始する。
まず Ki2API
コネクションとして使用される Kiro
プラットフォームへのローカルゲートウェイ。
git clone https://github.com/zhalice2011/ki2api
cd ki2api
docker-compose up -d
サービス・デフォルト・リスニング http://localhost:8989
. Ki2API
は自動的にローカルのAWS SSOキャッシュ認証情報(通常は ~/.aws/sso/cache/
ディレクトリ)の自動更新ロジックを内蔵しています。必要であれば KIRO_ACCESS_TOKEN
歌で応える KIRO_REFRESH_TOKEN
環境変数で認証情報を手動で指定する。
ステップ2:クロード・コードとクロード・コード・ルーターをインストールする
を持っていることを確認してください。 Node.js
そして npm
グローバル・インスタレーション Claude Code
歌で応える Claude Code Router
.
# 如果已安装 Claude Code,可跳过此步
npm install -g @anthropic-ai/claude-code
# 安装路由工具
npm install -g @musistudio/claude-code-router
ステップ3:コンフィギュレーション・ファイルの書き込みと開始
確立 Claude Code Router
コンフィギュレーション・ファイルを作成します。以下のJSONコンテンツ全体を ~/.claude-code-router/config.json
パス
{
"LOG": false,
"OPENAI_API_KEY": "",
"OPENAI_BASE_URL": "",
"OPENAI_MODEL": "",
"Providers": [
{
"name": "openai",
"api_base_url": "http://localhost:8989/v1/chat/completions",
"api_key": "ki2api-key-2024",
"models": [
"claude-sonnet-4-20250514"
]
}
],
"Router": {
"default": "openai,claude-sonnet-4-20250514",
"background": "openai,claude-sonnet-4-20250514",
"think": "openai,claude-sonnet-4-20250514",
"longContext": "openai,claude-sonnet-4-20250514",
"webSearch": "openai,claude-sonnet-4-20250514"
}
}
構成:
Providers
フィールドは利用可能なバックエンドサービスを定義します。ここではname
というのもopenai
このサービスは、ローカルのKi2API
のアドレス。Router
フィールドはClaude Code
すべてのタスクパネル (default
,think
など)にルーティングされる。openai
サービスとclaude-sonnet-4-20250514
モデル
設定が完了したら、以下のコマンドを実行して起動する。 Claude Code
::
ccr code
この時点ではね。CCR
管財 Claude Code
ウェブ・リクエストの Router
このルールは、それをローカルの Ki2API
サービスを呼び出す。 claude-sonnet-4-20250514
モデル
よくある質問と解決策
- 401 未承認エラー
- 原因分析APIキーが間違っているか
Kiro
アクセス認証情報の有効期限が切れています。 - 処方::コンフィギュレーション・ファイルが
api_key
とともにKi2API
設定済みki2api-key-2024
一貫性がある。またKi2API
のDockerコンテナ・ログを正常にフェッチまたはフラッシュしたことを確認する。Kiro
のアクセストークンです。
- 原因分析APIキーが間違っているか
- ポートの競合または接続障害
- 原因分析地元
8989
ポートがすでに他のプログラムによって占有されている。Ki2API
サービスが正しく開始できませんでした。 - 処方使用
docker-compose logs -f
コマンドで表示できる。Ki2API
リアルタイム・ログから問題を特定する。ポートの競合がある場合はdocker-compose.yml
ファイルを作成する。8989
他の利用可能なポートへのマッピングと更新の同期CCR
設定ファイルをapi_base_url
.
- 原因分析地元
- 設定の変更が反映されない
- 原因分析:
Claude Code Router
起動時に設定をロードし、実行時に変更されたファイルは自動的に再ロードされない。 - 処方:: 変更
config.json
ファイルを再実行する必要があります。ccr code
コマンドを使用してサービスを再起動し、新しいコンフィギュレーションを有効にします。
- 原因分析: