Claude CodeでKimi K3接続｜2026設定手順

Claude CodeでKimi K3接続は可能です。2026年8月1日時点では、Kimi Code公式がAnthropic互換インターフェースを案内しているため、専用のBase URL、API Key、利用権限のあるモデルIDを環境変数へ設定し、認証・ツール呼び出し・長文脈の動作を順番に確認してください。通常のKimi公開プラットフォーム用APIをそのまま流用する方法ではありません。

最初に結論を確認したい開発者、Claude Codeの利用環境を遠隔チームで統一したい管理者、401やモデル未検出、長文脈の切り替えエラーで止まっている利用者が対象です。単なるチャット応答ではなく、ファイル読み取りやコード変更まで使える状態を確認することが本稿の目的です。

注意：以下のAPI KeyはすべてYOUR_KIMI_CODE_API_KEYというプレースホルダーです。実際のキーをシェル履歴、設定ファイル、チャットログへ貼り付けないでください。

接続前に「Kimi Code」と公開プラットフォームを分ける

最も多い失敗は、接続方式ではなく、異なるサービスの認証情報を混ぜることです。Kimi Codeは端末やIDEのAgent利用を想定したサービスで、Claude Code向けにはAnthropic互換の接続先が用意されています。一方、Kimi公開プラットフォームは製品組み込みや従量課金型のAPI利用を想定した別系統です。

Kimi Code用のキーと公開プラットフォーム用のキー、Base URLは相互交換できません。401が出た場合、キーの文字列だけでなく、キーを発行したコンソールと接続先の組み合わせを先に確認する必要があります。詳細はKimi Code公式のエラーリファレンスで確認できます。

確認項目	Claude CodeでKimi K3を使う場合	混同しやすい設定
サービス	Kimi Code	Kimi公開プラットフォーム
プロトコル	Anthropic互換	OpenAI互換
Base URL	`https://api.kimi.com/coding/`	`https://api.moonshot.cn/v1`
API Key	Kimi Codeコンソールで発行	公開プラットフォームで発行
主な用途	端末Agent、ファイル編集、コード作業	自社アプリ、一般API呼び出し

Claude Code自体は、公式ドキュメント上でも環境変数によるBase URL、認証情報、モデルの上書きに対応しています。インストール済みか不明な場合は、Claude Code公式のセットアップ手順で導入状態を確認し、作業対象とは別の検証用ディレクトリを用意してください。

最初の10分で環境変数を設定する

1. Claude Codeと権限を確認する

claude --version
claude doctor

Claude Codeの導入後は、検証用の空ディレクトリ、または機密情報を含まない小規模なリポジトリへ移動します。いきなり本番リポジトリで権限確認やファイル編集を行うと、接続テストとAgent操作の失敗原因を分けにくくなります。

2. Kimi Code用の資格情報を準備する

Kimi Code公式案内では、Kimi CodeコンソールでAPI Keyを作成し、作成時に表示されたキーを安全に保存する流れになっています。キーの再表示可否や利用モデルはアカウント状態に依存するため、チーム共用のキーを個人端末からコピーする運用は避けてください。詳細な接続例はKimi CodeのClaude Code設定手順に掲載されています。

3. macOSまたはLinuxで設定する

export ANTHROPIC_BASE_URL="https://api.kimi.com/coding/"
export ANTHROPIC_API_KEY="YOUR_KIMI_CODE_API_KEY"

export ANTHROPIC_MODEL="k3-256k"
export ANTHROPIC_DEFAULT_FABLE_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
export CLAUDE_CODE_SUBAGENT_MODEL="$ANTHROPIC_MODEL"

export CLAUDE_CODE_EFFORT_LEVEL="high"
export CLAUDE_CODE_AUTO_COMPACT_WINDOW="262144"
export CLAUDE_CODE_MAX_CONTEXT_TOKENS="262144"

claude

この設定はシェルを閉じると消える一時設定です。個人端末で継続利用する場合は、シェルの設定ファイルへ直接キーを書き込むより、macOSの安全な資格情報管理や、チーム側のシークレット注入機構を使うほうが管理しやすくなります。

Claude Code公式のLLMゲートウェイ設定でも、APIキーを環境変数やキー取得ヘルパーから注入する構成が示されています。固定値をスクリプトやGit管理対象へ残さないという点は、Kimi Code接続でも同じです。詳細はClaude CodeのLLMゲートウェイ設定を参照してください。

4. モデルIDは権限と用途で選ぶ

2026年8月1日時点のKimi Code公式ドキュメントでは、K3系としてk3とk3-256kが案内されています。k3はClaude Codeの環境変数でk3[1m]と指定することで、1Mコンテキストを明示できます。一般的なAPIリクエストや他のツールのモデル欄では、通常のk3表記を使う点に注意が必要です。

選択肢	公式に示されたコンテキスト上限	向いている作業	設定上の注意
`k3-256k`	262144トークン	日常のコード補完、単一ファイル、少数ファイルの変更	自動圧縮の設定を262144に合わせる
`k3[1m]`	1048576トークン	大規模リポジトリ、複数資料の同時参照	Claude Codeの環境変数でのみ`[1m]`表記を使う
`kimi-for-coding`	262144トークン	Kimi Codeの標準コーディング用途	K3の長文脈を前提にした設定とは分ける

Kimi Codeの公式案内では、K3の1M版はアカウントの会員権限により利用可否が変わり、k3-256kは日常的な開発向けとして説明されています。上限値だけを見て1M版を常用するのではなく、長い会話を維持する必要がある作業だけで切り替えるのが安全です。

最初のリクエストを低リスクで検証する

起動できたら、いきなり「このリポジトリを全面改修して」と依頼せず、読み取りだけの短い指示を送ります。

現在の作業ディレクトリにあるファイルを一覧し、変更は行わず、主要な設定ファイルを3つだけ説明してください。

その後、Claude Code内で次を実行します。

/status

公式の接続手順では、/statusに表示されるBase URLがhttps://api.kimi.com/coding/であることを接続確認の材料にしています。画面上のモデル名がClaude系の表示に見える場合でも、実際の接続先とAPI応答を確認することが優先です。

表示または状態	可能性が高い原因	最初に確認する項目
401、Invalid Authentication	キーが無効、期限切れ、別サービスのキー	API Keyの発行元、余分な空白、環境変数の上書き
402、membership unavailable	会員権限の確認失敗	Kimi Codeの契約状態、対象モデルの権限
404、model not found	モデルIDまたは接続先が不一致	`k3-256k`、`k3[1m]`の表記、Base URL
404、method not found	パスの組み立てが不正	Anthropic互換URLの末尾スラッシュ
500	サービス側の一時的な障害	連続再試行を避け、時間を置いて再確認

エラーリファレンスでは、第三者クライアントがステータスコードやエラー文を変換することがあるため、コード番号だけでなく、表示された本文のキーワードも確認するよう案内されています。401を繰り返し送信しても資格情報は直らないため、まずキーとURLを固定し、1回ずつ再検証してください。

1時間以内にAgent機能まで確認する

通常の応答が返っただけでは、Claude CodeをKimi K3へ接続できたとは判断しきれません。次の順番で、ファイル読み取り、複数ファイルの理解、変更案の提示、実行前のコマンド確認を試します。

READMEや設定ファイルを読み取らせます。
依存関係を変更せず、関連ファイルを列挙させます。
小さなテストファイルの変更案だけを作らせます。
実行予定コマンドを表示させ、承認前に止めます。
変更後に差分を確認し、テストを1つだけ実行します。

Claude CodeはCLIオプションでモデル指定、最大ターン数、権限モード、詳細ログなどを扱えます。特に検証時は、実行内容を追えるように--verboseを使い、書き込みが不要な作業では権限モードを慎重に選んでください。必要なCLI項目はClaude Code公式CLIリファレンスで確認できます。

Kimi K3の思考強度は、公式案内上ではlow、high、maxに対応し、Claude Code側のmediumやhighはK3のhighへ対応します。初期設定をhighにして、単純な補完で待ち時間が気になる場合だけ下げるほうが、Agentの挙動を確認しやすくなります。

長文脈へ切り替える前に会話を整理する

k3-256kからk3[1m]へ切り替える場合、以前の会話をそのまま再開するのではなく、先にコンテキストを圧縮してください。会話履歴がすでに目標上限を超えている場合、対応していない入力形式や古いツール情報が含まれている場合は、圧縮後も不安定になる可能性があります。

推奨される処理順は次のとおりです。

現在の作業状態、変更ファイル、未完了タスクを要約します。
/compactなど、利用中のClaude Codeバージョンで提供される圧縮操作を実行します。
モデルとコンテキスト設定を変更します。
重要な前提だけを新しいプロンプトで再提示します。
それでもエラーが出る場合は、新規セッションで再開します。

反対に、1M版から256K版へ戻すときも、長い履歴を無理に維持しないほうが安全です。コンテキスト上限は単なる保存容量ではなく、Agentが参照できる履歴、ツール結果、指示の優先順位に影響するためです。

利用状況	推奨設定	会話の扱い
単一ファイルや小規模修正	`k3-256k`	既存セッションを継続しやすい
複数ディレクトリの横断修正	`k3-256k`で開始	不要なツール出力を圧縮する
大規模リポジトリ分析	`k3[1m]`	変更前に要約を作成する
モデル変更後に形式エラー	低い上限へ戻さない	圧縮後も失敗するなら新規セッション

チーム環境へ展開する前の採点基準

個人端末で動作しても、チーム利用では別の確認が必要です。設定ファイルをそのまま配布すると、個人のAPI Key、権限、会員枠、作業ディレクトリが混ざり、誰がどの費用や利用枠を消費したのか追跡しにくくなります。

評価項目	合格条件	不合格時の対応
鍵の分離	利用者または環境ごとに撤回可能な資格情報を使用	個人キーの共有を停止
モデル固定	利用モデルIDとコンテキスト設定を文書化	自動更新による挙動差を確認
料金・利用枠	会員制の利用枠、頻度制限、対象権限を確認	本番投入せず管理者が再確認
ログ	ステータスコード、エラー本文、実行時刻を記録	端末の画面だけに依存しない
回退策	既存のモデルや作業手順へ戻せる	長時間作業の前に小規模案件で確認

Kimi Code公式は、会員向けサービスを対話的な利用向けと説明しており、企業製品への組み込みや大規模な用量管理を同じ考え方で扱うべきとはしていません。長期運用するチームでは、利用規約、権限範囲、費用の帰属、監査ログを確認し、個人の設定をそのまま本番環境へコピーしないことが重要です。

個人のMacだけで短期検証する場合は、クラウドMacレンタルの利用方法を確認し、端末の初期化、利用者ごとの環境分離、キーの注入方法を先に決めておくと運用設計が崩れにくくなります。長時間のAgent作業や複数人の再現環境が必要なら、Mac VPSの料金と構成も比較対象になります。

接続方式を選ぶときの判断

Claude CodeでKimi K3を試す目的なら、Kimi CodeのAnthropic互換APIを選ぶのが自然です。Kimi公開プラットフォームの従量課金APIは、独自アプリケーションやバックエンド組み込みなど、別の要件で検討する方式です。両者を価格だけで比較すると、会員枠、頻度制限、ログ管理、モデル権限の違いを見落とします。

方式	向いている利用	強み	注意点
Kimi CodeをClaude Codeへ接続	端末Agent、個人開発、既存CLIの継続利用	Anthropic互換で設定をまとめやすい	会員権限と利用枠に依存
Kimi公開プラットフォームをアプリへ接続	自社サービス、バックエンド、API組み込み	API設計や用量管理を組み込みやすい	Claude Code用の接続先とは別
Claude Codeを標準接続	Claude系モデルをそのまま利用	公式経路で機能差を把握しやすい	Kimi K3は利用できない
共有クラウドMac上で運用	遠隔チーム、再現可能な開発環境	端末、シェル、鍵注入を統一しやすい	権限分離とセッション管理が必要

長期的に同じClaude Code環境を使う場合、ローカル端末だけでは、端末のスリープ、OS更新、個人キーの残存、チームごとの設定差が運用上の負担になります。逆に、物理USB機器へのアクセスや常時高負荷のローカル処理が必要なら、レンタル環境が適さない場合もあります。

そのため、短期のモデル検証は手元のMac、夜間も継続するAgent作業や複数人の再現環境はZilmacのクラウドMac、という分け方が現実的です。ZilmacのMac仮想デスクトップ環境を確認する際も、単にCPU性能を見るのではなく、Claude Codeのインストール手順、環境変数の注入、利用者ごとの権限、作業終了後のキー撤回まで確認してください。

本稿の接続手順は、2026年8月1日にKimi Code公式のClaude Code接続手順、モデル設定、エラーリファレンス、Anthropic公式のClaude Code設定資料を照合した内容です。Kimi Codeのモデル一覧、Claude Codeの環境変数、コンテキスト設定は更新される可能性があるため、実際の導入日には必ず公式ページの値を再確認してください。

Claude CodeでKimi K3を使う場合、単にAPI Keyを貼り付けて起動するだけでは不十分です。Kimi Code専用の接続先を選び、k3-256kまたは権限に応じたk3[1m]を指定し、/status、読み取り、ファイル変更、ツール呼び出し、長文脈の圧縮まで順番に通して初めて、実用環境として判断できます。

よくある確認事項

Claude CodeでKimi K3を使うには、何から始めればよいですか？

Kimi CodeのAPI Key、Anthropic互換のBase URL、利用権限のあるモデルIDを準備します。通常のKimi公開プラットフォーム用キーは使わず、検証用ディレクトリで環境変数を設定してください。起動後は/statusで接続先を確認し、読み取り専用の依頼から始めると、認証問題とAgent操作の問題を分けられます。

Kimi K3のAnthropic Base URLには何を設定しますか？

Claude Codeでは、Kimi Code公式が案内するhttps://api.kimi.com/coding/をAnthropic互換のBase URLとして設定します。OpenAI互換の/v1エンドポイントや公開プラットフォームのURLとは用途が異なります。末尾のスラッシュを含めた形で設定し、起動後の/status表示でも確認してください。

Claude Codeで「Kimi K3モデルが存在しない」と表示されます

ANTHROPIC_MODELの値、Kimi Codeの利用権限、Base URLの3点を同時に確認します。256K版ならk3-256k、1M版をClaude Codeで明示する場合は公式手順にあるk3[1m]を使います。別サービスのキーを正しいモデルIDと組み合わせても、404や権限エラーになるため、まず接続元を揃えてください。

Kimi K3の長文脈をClaude Codeで設定する方法は？

長文脈が必要ない作業ではk3-256kを使い、巨大なリポジトリや長い資料を横断する場合だけk3[1m]を検討します。1M版へ切り替える前に会話を圧縮し、入力履歴に古いツール形式や不要な出力が残っている場合は新規セッションを開始します。上限値だけを大きくしても、作業品質が自動的に安定するわけではありません。

ローカル環境では端末ごとの設定差やキー管理が残り、共有環境では権限分離とログ設計が必要になります。短期間の検証は既存のMacで十分ですが、Claude Codeを長時間動かす、遠隔チームで同じ環境を再利用する、作業終了後に資格情報を確実に回収する、といった要件がある場合は、ZilmacのクラウドMac環境と密閉されたキー注入手順を比較するほうが、運用上の抜けを減らせます。