TTechSpecs

Kimi Code 安裝指南

Kimi Code 是月之暗面（Moonshot AI）推出的 AI 程式碼編輯器，專為中文開發者設計，內建強大的中文程式碼理解和生成能力，並完整支援 Superpowers 技能系統。

平台特色

Kimi Code 作為本土化的 AI 程式碼編輯器，提供：

  • 🇨🇳 中文優化：專為中文程式碼和註解優化
  • 🤖 Kimi 模型：使用月之暗面最強大的語言模型
  • 🌐 本土支援：完整的中文文件和支援
  • 🛠️ 實用功能：程式碼補全、重構、解釋
  • 📚 Superpowers 支援：完整技能生態系統整合

系統需求

硬體需求

  • 處理器：x64_64 或 ARM64 架構
  • 記憶體：至少 8 GB RAM（建議 16 GB 以上）
  • 硬碟空間：至少 1 GB 可用空間

軟體需求

  • 作業系統：
    • Windows 10/11（x64）
    • macOS 11+ (Big Sur 或更高版本)
    • Ubuntu 20.04+、Debian 11+、Fedora 35+
  • 瀏覽器：Chrome 90+、Edge 90+、Safari 14+
  • 網路：穩定的網際網路連線（中國大陸優化）

安裝步驟

Windows 安裝

# 第 1 步：下載 Kimi Code
# 訪問 https://kimi.moonshot.cn/code
# 下載 Windows 版本安裝程式

# 第 2 步：執行安裝程式
# 下載完成後執行安裝程式
# 按照安裝嚴導完成安裝
# 建議安裝到 D:\KimiCode 目錄

# 第 3 步：啟動 Kimi Code
# 從開始選單啟動 Kimi Code

# 第 4 步：登入帳號
# 使用手機號碼或月之暗面帳號登入

macOS 安裝

# 第 1 步：下載 macOS 版本
# 訪問 https://kimi.moonshot.cn/code
# 下載 .dmg 檔案

# 第 2 步：開啟安裝程式
# 開啟下載的 .dmg 檔案
# 將 Kimi Code 拖曳到 Applications 資料夾

# 第 3 步：完成安裝
# 按照安裝嚴導完成安裝
# 可能需要輸入系統密碼

# 第 4 步：啟動應用程式
# 從 Applications 資料夾啟動 Kimi Code

Linux 安裝

# 第 1 步：下載 AppImage
# 訪問 https://kimi.moonshot.cn/code
# 下載 Linux AppImage 版本

# 第 2 步：設定執行權限
chmod +x kimi-code-*.AppImage

# 第 3 步：移動到系統路徑
sudo mv kimi-code-*.AppImage /usr/local/bin/kimi-code

# 第 4 步：建立桌面捷徑
cat > ~/.local/share/applications/kimi-code.desktop << 'EOF'
[Desktop Entry]
Name=Kimi Code
Exec=/usr/local/bin/kimi-code
Type=Application
Categories=Development;IDE;
EOF

# 第 5 步：啟動 Kimi Code
# 從應用程式選單啟動

配置設定

基礎配置

# 在 Kimi Code 中
# 1. 點擊左下角設定圖標
# 2. 選擇 "設定"
# 3. 配置基本設定

# 語言設定：選擇 "繁體中文"
# 字體設定：選擇 "等寬字體"（Consolas、Fira Code 等）
# 主題設定：選擇 "深色主題"

API 金鑰設定

# 獲取 Moonshot API Key
# 1. 訪問 https://platform.moonshot.cn/
# 2. 建立或登入帳號
# 3. 在 API 金鑰頁面建立金鑰

# 在 Kimi Code 中設定
# Settings -> API Keys
# 輸入 API Key
# 點擊 "驗證"

專案配置

# 在專案根目錄建立 .kimi 目錄
mkdir -p .kimi

# 建立專案配置
cat > .kimi/config.json << 'EOF'
{
  "project": {
    "name": "我的專案",
    "language": "typescript",
    "framework": "react"
  },
  "ai": {
    "model": "kimi-latest",
    "maxTokens": 100000,
    "temperature": 0.7
  },
  "superpowers": {
    "enabled": true,
    "language": "zh-TW",
    "skillsPath": "~/.superpowers/skills"
  }
}
EOF

使用方式

AI 助手使用

# 開啟 AI 助手
# 快捷鍵：Ctrl+Shift+A (Windows/Linux)
#          Cmd+Shift+A (macOS)

# 使用 Superpowers 技能
"使用 brainstorming skill 探索使用者認證的實作方式"

# Kimi Code 會使用繁體中文回應

程式碼補全

// 在編輯器中輸入
function calculateTotalPrice(items: CartItem[]) {
  // Kimi Code 會根據中文註解提供補全
  // 按下 Tab 接受建議

/**
 * 計算購物車總價
 * @param items 購物車項目陣列
 * @returns 總價格
 */

程式碼解釋

// 選擇程式碼片段
// 按下 Ctrl+Shift+E (Windows/Linux)
//      Cmd+Shift+E (macOS)

// Kimi Code 會用中文解釋程式碼
/**
 * 此函式計算購物車中所有項目的總價格
 * 先對每個項目的價格和數量相乘，然後加總
 * 最後返回總金額
 */

進階功能

專案分析

# 分析整個專案
# Ctrl+Shift+P -> "Kimi: 分析專案"

# Kimi Code 會：
# 1. 分析專案結構
# 2. 識別潛在問題
# 3. 提供改進建議
# 4. 使用 Superpowers 技能深入分析

重構建議

# 選擇需要重構的程式碼
# 按下 Ctrl+Shift+R (Windows/Linux)
#      Cmd+Shift+R (macOS)

# Kimi Code 會：
# 1. 分析程式碼結構
# 2. 提供重構建議
# 3. 使用相關 Superpowers 技能
# 4. 給出重構步驟

測試生成

// 自動生成測試
/**
 * SUPERPOWERS: test-driven-development
 * 為此函式生成 TDD 測試
 */

// Kimi Code 會：
// 1. 分析函式功能
// 2. 生成測試案例
// 3. 考慮邊界條件
// 4. 使用繁體中文註解

開發流程整合

Git 整合

# 建立 git hooks
cat > .git/hooks/pre-commit << 'EOF'
#!/bin/bash
# Kimi Code 自動執行驗證
kimi-code --skill verification-before-completion --staged

if [ $? -ne 0 ]; then
  echo "驗證失敗，提交中止"
  exit 1
fi
EOF

chmod +x .git/hooks/pre-commit

CI/CD 整合

# GitHub Actions 整合
# .github/workflows/kimi-review.yml

name: Kimi Code Review
on: [pull_request]

jobs:
  superpowers-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      
      - name: Setup Kimi Code
        run: |
          wget https://kimi.moonshot.cn/linux/deb/install.sh
          sudo bash install.sh
          
      - name: Run Superpowers Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
          KIMI_API_KEY: ${{ secrets.KIMI_API_KEY }}
        run: |
          kimi-code --skill requesting-code-review \
            --diff origin/main...HEAD \
            --output review-report.md
            
      - name: Upload Review
        uses: actions/upload-artifact@v2
        with:
          name: review-report
          path: review-report.md

常見問題

安裝問題

Q1: 下載速度慢

A:

# 使用中國大陸鏡像站
# 訪問 https://kimi.moonshot.cn/code
# 選擇 "中國大陸下載"

# 或使用下載工具
# 使用迅雷、IDM 等下載工具加速

Q2: macOS 無法開啟

A:

# 檢查安全性設定
# 系統偏好設定 -> 安全性 -> App Store
# 允許來自 "已識別的開發者"

# 或使用終端機開啟
sudo xattr -cr /Applications/Kimi\ Code.app
open /Applications/Kimi\ Code.app

Q3: Linux AppImage 無法執行

A:

# 確保執行權限
chmod +x kimi-code-*.AppImage

# 檢查 FUSE 安裝
sudo apt install fuse

# 直接執行
./kimi-code-*.AppImage

配置問題

Q4: 無法連接到 AI 服務

A:

# 檢查網路連線
ping api.moonshot.cn

# 檢查代理設定
# Settings -> Network -> Proxy
# 確保代理設定正確

# 測試 API 金鑰
# 在設定中測試 API 金鑰是否有效

Q5: 中文輸入異常

A:

// 設定中文輸入法
{
  "editor.inputMethod": "ime",
  "editor.fontFamily": "Microsoft YaHei, Consolas",
  "editor.fontSize": 14
}

// 或使用拼音輸入法

使用問題

Q6: AI 回應不準確

A:

// 調整模型參數
{
  "ai.temperature": 0.3,
  "ai.topP": 0.9,
  "ai.frequencyPenalty": 0.3
}

// 增加上下文
{
  "ai.contextLines": 15,
  "superpowers.contextFiles": ["*.{ts,tsx,md}"]
}

Q7: Superpowers 技能無法使用

A:

# 檢查擴展是否正確安裝
# 在擴展面板查看 Superpowers 狀態

# 重新載入技能
# Settings -> Superpowers -> Reload Skills

# 檢查技能路徑
ls -la ~/.superpowers/skills/

效能優化

網路優化

# 設定中國大陸伺服器
{
  "api.endpoint": "https://api.moonshot.cn",
  "cdn.endpoint": "https://cdn.moonshot.cn"
}

// 啟用本地快取
{
  "cache.enabled": true,
  "cache.location": "~/.kimi/cache",
  "cache.maxSize": 1000
}

記憶體優化

// 調整記憶體使用
{
  "ai.maxTokens": 50000,
  "ai.maxContextFiles": 10,
  "ai.maxFileSize": 50000
}

// 定期清理快取
kimi-code cache clear

並行處理

// 啟用並行處理
{
  "parallel.enabled": true,
  "parallel.maxWorkers": 4
}

資源連結

官方資源

學習資源

社群資源

下一步

安裝完成後，建議：

  1. 完成初始設定：設定 API 金鑰和語言偏好
  2. 探索功能：嘗試程式碼補全和 AI 助手
  3. 安裝 Superpowers：安裝並配置技能系統
  4. 建立專案：建立新專案並配置 Kimi Code
  5. 學習技能：探索 brainstorming 和其他技能

開始使用 Kimi Code 和 Superpowers，體驗本土化 AI 程式碼編輯器的強大能力！