モデルガイド上級者向け更新日

Kimi Code 設定ガイド:API Key、K3.1 Pro と Claude Code

Kimi Code CLI で I Code Easy API Key を使うには、~/.kimi-code/config.toml にキーと /v1 付きの URL を設定し、k3.1-pro を選びます。Claude Code では ANTHROPIC_* 環境変数を使い、URL はドメインのみです。クライアントごとに設定方法が異なります。

クライアント別の設定早見表

クライアント / 目的設定方法URL
Kimi Code CLI:継続利用下記の TOML 設定https://api.icodeeasy.cc/v1
Kimi Code CLI:現在のターミナルで試す下記の KIMI_MODEL_* 変数https://api.icodeeasy.cc/v1
Claude Code で Kimi を利用下記の ANTHROPIC_* 設定https://api.icodeeasy.cc

アカウント登録後、API Keysでサイトのキーをコピーし、接続先の選択で Kimi の接続先を保存してください。I Code Easy API Key と Kimi 公式アカウントは別の認証情報です。/login は公式アカウント用で、サイトのキーを入力する手順ではありません。

1. Kimi Code をインストール

macOS / Linux:

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

Windows PowerShell:

irm https://code.kimi.com/kimi-code/install.ps1 | iex

Windows の Kimi Code には Git for Windows も必要です。要件は公式インストール手順を確認してください。

インストール後はターミナルを開き直し、バージョンを確認します。kimi が見つからない場合は、API 設定より先にインストールと PATH を確認してください。

kimi --version

インストールと更新方法は Kimi Code 公式ページを参照してください。設定が認識されない場合は、キーを何度も交換する前に、使用バージョンと公式ドキュメントを照合してください。

2. I Code Easy API を設定

必要なら ~/.kimi-code/config.toml を作成します。Windows では現在のユーザーホーム内の .kimi-code/config.toml です。既存ファイルには設定をマージし、他の Provider、MCP、権限設定を残してください。トップレベルの default_model は TOML の各テーブルより前に一つだけ置き、同名の Provider やモデルテーブルも重複させないでください。

KIMI_CODE_HOME を設定している場合は設定ディレクトリが変わります。default_model には単独の送信モデル名ではなく、icodeeasy/k3.1-pro のようなモデルテーブルの別名を指定します。

default_model = "icodeeasy/k3.1-pro"

[providers.icodeeasy]
type = "kimi"
base_url = "https://api.icodeeasy.cc/v1"
api_key = "あなたの I Code Easy API Key"

[models."icodeeasy/k3.1-pro"]
provider = "icodeeasy"
model = "k3.1-pro"
max_context_size = 1048576
capabilities = ["thinking", "always_thinking", "image_in", "video_in", "tool_use"]
display_name = "Kimi K3.1 Pro (I Code Easy)"
support_efforts = ["low", "high", "max"]
default_effort = "high"

[models."icodeeasy/k3.1-pro-highspeed"]
provider = "icodeeasy"
model = "k3.1-pro-highspeed"
max_context_size = 1048576
capabilities = ["thinking", "always_thinking", "image_in", "video_in", "tool_use"]
display_name = "Kimi K3.1 Pro Highspeed (I Code Easy)"
support_efforts = ["low", "high", "max"]
default_effort = "high"

[models."icodeeasy/k3"]
provider = "icodeeasy"
model = "k3"
max_context_size = 1048576
capabilities = ["thinking", "tool_use"]
display_name = "Kimi K3 (I Code Easy)"

[models."icodeeasy/k3-256k"]
provider = "icodeeasy"
model = "k3-256k"
max_context_size = 262144
capabilities = ["thinking", "tool_use"]
display_name = "Kimi K3 256K (I Code Easy)"

macOS / Linux ではファイル権限を制限できます:

chmod 600 ~/.kimi-code/config.toml

メインドメインが遅い場合、base_url を https://jp.icodeeasy.cc/v1 または https://sg.icodeeasy.cc/v1 に変更できます。/v1 を二重に追加しないでください。

四つのモデルの選び方

公開モデルコンテキスト選択の目安
k3.1-pro1,048,576標準枠、思考必須
k3.1-pro-highspeed1,048,576高速枠、思考必須
k31,048,576独立した K3、思考を無効化可能
k3-256k262,144独立した 256K 枠、思考を無効化可能

最新価格、残高、使用量は料金と使用量ガイド、対応範囲はモデル一覧を参照してください。K3 と K3-256K の画像・動画入力は公開仕様として保証されていません。

旧名はすべて同じモデルを指すわけではありません。K2 系の旧名、kimi、kimi-for-coding は K3.1 Pro に接続し、kimi-for-coding-highspeed などの高速版の旧名は高速版に対応します。kimi-k3 と k3[1m] は K3、kimi-k3-256k は K3-256K のままです。四つの公開モデルに対応する kimi- 付きの名前も、それぞれのモデルを選択します。

K3-256K がコンテキスト上限を超えると、既存の仕組みで K3 に切り替わり、そのリクエストは K3 の料金で課金されます。モデル切り替え後は新しいセッションを開始し、以前に圧縮されたコンテキストを引き継がないようにしてください。

一時的なテスト設定

現在の Kimi Code は通常の KIMI_API_KEY を自動で読み取りません。一時的に試す場合は専用の KIMI_MODEL_* を使います。設定ファイルとは別の経路なので、まずどちらを検証しているかを確認してください。

KIMI_MODEL_NAME を設定すると環境変数モデルが有効になり、KIMI_MODEL_API_KEY が必須になります。これらはファイルに書き戻されず、ファイルの default_model より優先されます。コマンドラインの -m は環境変数モデルよりも優先されます。

macOS / Linux:

export KIMI_MODEL_NAME="k3.1-pro"
export KIMI_MODEL_API_KEY="あなたの I Code Easy API Key"
export KIMI_MODEL_PROVIDER_TYPE="kimi"
export KIMI_MODEL_BASE_URL="https://api.icodeeasy.cc/v1"
export KIMI_MODEL_MAX_CONTEXT_SIZE="1048576"
export KIMI_MODEL_CAPABILITIES="thinking,always_thinking,image_in,video_in,tool_use"
kimi

Windows PowerShell(現在のセッションのみ):

$env:KIMI_MODEL_NAME="k3.1-pro"
$env:KIMI_MODEL_API_KEY="あなたの I Code Easy API Key"
$env:KIMI_MODEL_PROVIDER_TYPE="kimi"
$env:KIMI_MODEL_BASE_URL="https://api.icodeeasy.cc/v1"
$env:KIMI_MODEL_MAX_CONTEXT_SIZE="1048576"
$env:KIMI_MODEL_CAPABILITIES="thinking,always_thinking,image_in,video_in,tool_use"
kimi

高速版を試す場合は KIMI_MODEL_NAME を k3.1-pro-highspeed に変更します。このウィンドウを閉じると、ここで設定した変数は残りません。ユーザー環境変数や起動スクリプトに保存済みの値は別途削除が必要です。TOML を検証するときは、一時変数のない新しいターミナルを使ってください。

3. 起動と確認

プロジェクトのディレクトリで実行します:

cd your-project-directory
kimi

画面内で /model を実行し、Kimi K3.1 Pro (I Code Easy) または目的のモデルを確認します。バージョン番号やモデル一覧が表示されただけでは、API 呼び出しの成功は確認できません。

最初は「接続成功、とだけ返信してください」などの短いメッセージを送り、応答後にプロジェクトの読み書きを依頼してください。リクエストログで状態と実際のモデル、使用量明細で使用量と料金を確認します。相談用のスクリーンショットではキーを隠してください。

Claude Code で Kimi K3.1 Pro を使用

一般的なインストールと設定は Claude Code ガイドを参照してください。macOS / Linux では、使用中のシェルの ~/.bashrc または ~/.zshrc に次を追加できます:

export ANTHROPIC_AUTH_TOKEN="あなたの I Code Easy API Key"
export ANTHROPIC_BASE_URL="https://api.icodeeasy.cc"
export ANTHROPIC_MODEL="k3.1-pro"
export ANTHROPIC_SMALL_FAST_MODEL="k3.1-pro"
export ANTHROPIC_DEFAULT_SONNET_MODEL="k3.1-pro"
export ANTHROPIC_DEFAULT_OPUS_MODEL="k3.1-pro"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="k3.1-pro"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

保存後に source ~/.bashrc または source ~/.zshrc を実行し、claude を起動します。ANTHROPIC_BASE_URL はドメインのみで、代替は https://jp.icodeeasy.cc と https://sg.icodeeasy.cc です。モデル変更後は新しいセッションを開始してください。

Windows では PowerShell で同じ変数を $env:変数名="値" として設定し、そのウィンドウから claude を起動します。ユーザーレベルの永続変数を変更した場合は PowerShell を開き直してください。実行中のクライアントには自動反映されません。Bash の export をそのまま PowerShell に貼り付けないでください。

$env:ANTHROPIC_AUTH_TOKEN="あなたの I Code Easy API Key"
$env:ANTHROPIC_BASE_URL="https://api.icodeeasy.cc"
$env:ANTHROPIC_MODEL="k3.1-pro"
$env:ANTHROPIC_SMALL_FAST_MODEL="k3.1-pro"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="k3.1-pro"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="k3.1-pro"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="k3.1-pro"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
claude

401、モデル未反映、URL エラーの対処

症状確認と対処
401 / 認証失敗Kimi 公式アカウントではなく、このサイトの API Key を使います。使用中の Provider のキーやセッション変数を確認します。漏えいしたキーは API Keys で交換し、クライアントも更新してください。
モデルが切り替わらないトップレベルの default_model とモデルテーブル ID を一致させ、/model で確認します。残った KIMI_MODEL_* を削除し、クライアントを再起動して新しいセッションを開始します。
接続失敗 / パスの誤りKimi CLI の base_url は /v1 付き、Claude Code の ANTHROPIC_BASE_URL はドメインのみです。パスの重複を確認し、必要なら同じ形式の JP / SG URL を使います。
TOML のキーやテーブルが重複既存ファイルにマージし、設定全体を重ねて貼らないでください。トップレベルの default_model は一つ、各 Provider / モデル ID のテーブルも一つにします。
旧名で想定と異なるモデルになる上記の対応を確認し、四つの公開モデル名を優先します。特に kimi-k3 は K3.1 Pro ではありません。
Windows で新設定が反映されない変数を設定したウィンドウから起動してください。ユーザー変数変更後はターミナルを開き直し、現在のセッション変数はウィンドウを閉じると消える点を確認します。

他のクライアントも設定する

Claude Code · GLM 設定 · 料金・残高・使用量 · モデル能力一覧

公式参考資料