Use Kimi K2.5 Model in ClaudeCode/Cline/RooCode

Documentation Index

Fetch the complete documentation index at: https://platform.kimi.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

Usage Notes

• Budget Control
  • Set Daily Spending Limit: Before use, please go to Kimi Open Platform Project Settings to configure the “Project Daily Spending Budget”. Once the budget limit is reached, the system will automatically reject all API requests under this project (Note: Due to billing delays, the limit may take about 10 minutes to take effect). For setup instructions, please see Organization Management Best Practices
  • Balance Alert Reminder: It is recommended to enable the account balance reminder function. When the account balance falls below the preset amount (default ¥20), the system will notify you via SMS to recharge in a timely manner.
• Usage Recommendations
  • Continuous Monitoring: It is recommended to keep monitoring while the programming software is running, and handle abnormal situations promptly to avoid unnecessary resource consumption due to infinite loops or excessive retries.
  • Model Selection: If response speed is not a high priority, you can choose to use the kimi-k2.5 model.

​

K2 Vendor Verifier

​

Obtaining API Key

• Visit the Open Platform at https://platform.kimi.ai/console/api-keys to create and obtain an API Key, selecting the default project.

​

Using kimi k2.5 model in Claude Code

​

Install Claude Code

​

MacOS and Linux

# Install nodejs on MacOS and Linux
curl -fsSL https://fnm.vercel.app/install | bash

# Open a new terminal to make fnm take effect
fnm install 24.3.0
fnm default 24.3.0
fnm use 24.3.0

# Install claude-code
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# Initialize configuration
node --eval "
    const homeDir = os.homedir(); 
    const filePath = path.join(homeDir, '.claude.json');
    if (fs.existsSync(filePath)) {
        const content = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
        fs.writeFileSync(filePath,JSON.stringify({ ...content, hasCompletedOnboarding: true }, 2), 'utf-8');
    } else {
        fs.writeFileSync(filePath,JSON.stringify({ hasCompletedOnboarding: true }), null, 'utf-8');
    }"

​

Windows

# Open the PowerShell terminal in Windows Terminal
# Install nodejs on Windows
# Right-click the Windows button and select "Terminal"

# Then execute the following commands in sequence
winget install OpenJS.NodeJS
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

# Then close the terminal window and open a new one

# Install claude-code
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# Initialize configuration
node --eval "
    const homeDir = os.homedir(); 
    const filePath = path.join(homeDir, '.claude.json');
    if (fs.existsSync(filePath)) {
        const content = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
        fs.writeFileSync(filePath,JSON.stringify({ ...content, hasCompletedOnboarding: true }, 2), 'utf-8');
    } else {
        fs.writeFileSync(filePath,JSON.stringify({ hasCompletedOnboarding: true }), null, 'utf-8');
    }"

​

Configure Environment Variables

​

MacOS and Linux

# Start the high-speed kimi-k2.5 model on Linux/macOS
export ANTHROPIC_BASE_URL=https://api.moonshot.ai/anthropic
export ANTHROPIC_AUTH_TOKEN=${YOUR_MOONSHOT_API_KEY}
export ANTHROPIC_MODEL=kimi-k2.5
export ANTHROPIC_DEFAULT_OPUS_MODEL=kimi-k2.5
export ANTHROPIC_DEFAULT_SONNET_MODEL=kimi-k2.5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=kimi-k2.5
export CLAUDE_CODE_SUBAGENT_MODEL=kimi-k2.5
export ENABLE_TOOL_SEARCH=false
claude

​

Windows

# Start the high-speed kimi-k2.5 model on Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic";
$env:ANTHROPIC_AUTH_TOKEN="YOUR_MOONSHOT_API_KEY"
$env:ANTHROPIC_MODEL="kimi-k2.5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="kimi-k2.5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="kimi-k2.5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k2.5"
$env:CLAUDE_CODE_SUBAGENT_MODEL="kimi-k2.5"
$env:ENABLE_TOOL_SEARCH=false
claude

​

Verify Environment Variables

• How to experience the thinking capabilities of kimi-k2.5 in Claude Code
  • After configuring the model, click the Tab button to switch after entering the Claude Code page. A “Thinking on” indicator will appear when the switch is successful.

​

Using kimi k2.5 model in Cline

​

Install Cline

1. Open VS Code
2. Click the Extensions icon in the left activity bar (or use the shortcut Ctrl+Shift+X / Cmd+Shift+X)
3. Enter cline in the search box
4. Find the Cline extension (usually published by Cline Team)
5. Click the Install button to install it
6. After installation, you may need to restart VS Code

​

Verify Installation

1. See the Cline icon in the left activity bar of VS Code
2. Or search for “Cline” related commands through the command palette (Ctrl+Shift+P / Cmd+Shift+P) to verify the installation was successful

​

Official Recommendation: Configure Moonshot Provider to use Kimi K2.5 model

• Select ‘Moonshot’ as the API Provider
• Select ‘api.moonshot.ai’ as the Moonshot Entrypoint
• Configure the Moonshot API Key with the Key obtained from the Kimi Open Platform
• Select ‘kimi-k2.5’ as the Model
• Check ‘Disable browser tool usage’ under Browser
• Click ‘Done’ to save the configuration

​

Experience the effects of Kimi K2.5 model in cline

• We asked the Kimi K2.5 model to write a Snake game

• Game effects

​

Using Kimi K2.5 model in RooCode

​

Install RooCode

1. Open VS Code
2. Click the Extensions icon in the left activity bar (or use the shortcut Ctrl+Shift+X / Cmd+Shift+X)
3. Enter roo code in the search box
4. Find the Roo Code extension (usually published by RooCode Team)
5. Click the “Install” button to install it
6. After installation, you may need to restart VS Code

​

Verify Installation

1. See the RooCode icon in the left activity bar of VS Code
2. Or search for “RooCode” related commands through the command palette (Ctrl+Shift+P / Cmd+Shift+P) to verify the installation was successful

​

Official Recommendation: Configure Moonshot Provider to use Kimi K2.5 model

• Select ‘Moonshot’ as the API Provider
• Select ‘api.moonshot.ai’ as the Moonshot Entrypoint
• Configure the Moonshot API Key with the Key obtained from the Kimi Open Platform
• Select ‘kimi-k2.5’ as the Model
• Check ‘Disable browser tool usage’ under Browser

​

Using kimi k2.5 Model in OpenCode

​

Install OpenCode

curl -fsSL https://opencode.ai/install | bash

npm install -g opencode-ai

​

Configure API key

1. Run opencode auth login and select Moonshot AI.
   $ opencode auth login
   ┌  Add credential
   │
   ◆  Select provider
   │  ● Moonshot AI
   │  ...
   └
   
2. Enter your Moonshot AI API key.
   $ opencode auth login
   ┌  Add credential
   │
   ◇  Select provider
   │  Moonshot AI
   │
   ◇  Enter your API key
   │  _
   └
   
3. Run opencode to launch OpenCode.
   $ opencode
   
   Use the /models command to select the Kimi K2.5 model.
   /models
   

​

Direct API Calls to Kimi K2.5 model

from openai import OpenAI

client = OpenAI(
    api_key = "$MOONSHOT_API_KEY",
    base_url = "https://api.moonshot.ai/v1",
)

completion = client.chat.completions.create(
    model = "kimi-k2.5",
    messages = [
        {"role": "system", "content": "You are Kimi, an artificial intelligence assistant provided by Moonshot AI. You are more proficient in Chinese and English conversations. You will provide users with safe, helpful, and accurate answers. At the same time, you will refuse to answer any questions involving terrorism, racial discrimination, pornography, or violence. Moonshot AI is a proper noun and cannot be translated into other languages."},
        {"role": "user", "content": "Hello, my name is Li Lei, what is 1+1?"}
    ]
)

print(completion.choices[0].message.content)

curl https://api.moonshot.ai/v1/chat/completions \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $MOONSHOT_API_KEY" \
    -d '{
        "model": "kimi-k2.5",
        "messages": [
            {"role": "system", "content": "You are Kimi, an artificial intelligence assistant provided by Moonshot AI. You are more proficient in Chinese and English conversations. You will provide users with safe, helpful, and accurate answers. At the same time, you will refuse to answer any questions involving terrorism, racial discrimination, pornography, or violence. Moonshot AI is a proper noun and cannot be translated into other languages."},
            {"role": "user", "content": "Hello, my name is Li Lei, what is 1+1?"}
        ]
   }'

const OpenAI = require("openai");

const client = new OpenAI({
    apiKey: "$MOONSHOT_API_KEY",    
    baseURL: "https://api.moonshot.ai/v1",
});

async function main() {
    const completion = await client.chat.completions.create({
        model = "kimi-k2.5",         
        messages: [ 
            {"role": "system", "content": "You are Kimi, an artificial intelligence assistant provided by Moonshot AI. You are more proficient in Chinese and English conversations. You will provide users with safe, helpful, and accurate answers. At the same time, you will refuse to answer any questions involving terrorism, racial discrimination, pornography, or violence. Moonshot AI is a proper noun and cannot be translated into other languages."},
            {"role": "user", "content": "Hello, my name is Li Lei, what is 1+1?"}
        ]
    });
    console.log(completion.choices[0].message.content);
}

main();