海鲸AI

Appearance

登录/注册

Kilo CLI 接入教程 ​

开发者工具命令行工具更新时间：2026-04-17

产品简介 ​

Kilo CLI 是一款开源的终端 AI 编程工具，通过对话方式在命令行中辅助代码编写、调试与重构。通过配置海鲸AI的 API 接口，您可以在 Kilo CLI 中使用 Claude、GPT-5、通义千问等强大模型，无需科学上网即可享受高质量的 AI 编程体验。

核心功能 ​

  • 💻 智能代码生成 - 根据自然语言描述自动生成代码
  • 🐛 代码调试分析 - 快速定位和修复 Bug
  • ♻️ 代码重构优化 - 改进代码结构和性能
  • 🧪 单元测试生成 - 自动为函数生成测试用例
  • 🔍 代码理解解释 - 解释复杂代码逻辑
  • 🚀 多语言支持 - 支持 Python、JavaScript、Java、Go 等主流语言

为什么选择海鲸AI？ ​

优势说明
🌐 无需翻墙国内直连，稳定访问
💰 灵活计费按需付费，无需订阅
⚡ 高性能低延迟，响应迅速
🔒 数据安全代码数据不存储，保护隐私
🤖 多模型支持 Claude、GPT-5、通义千问等
🆓 新人福利新用户可获得免费额度

支持的模型 ​

海鲸AI支持多种主流 AI 模型，可在 Kilo CLI 中灵活切换：

模型系列推荐模型特点适用场景
Claude Sonnetclaude-sonnet-4-6代码能力强、推理准确、200K上下文复杂项目、代码重构
Claude Opusclaude-opus-4-7最强性能、深度推理架构设计、复杂算法
Claude Haikuclaude-haiku-4-5-20251001高性价比、低延迟日常开发、代码补全
GPT-5gpt-5.4多模态能力强、全面均衡日常开发、多场景
DeepSeekdeepseek-v3国产旗舰、代码能力突出编码任务、中文理解
通义千问qwen-max中文能力强、响应快中文项目开发

模型选择建议

  • 深度研发与架构设计：推荐 claude-opus-4-7 或 claude-sonnet-4-6，适用于复杂算法实现、系统架构设计
  • 日常辅助编码：推荐 claude-sonnet-4-6 或 deepseek-v3，性价比高
  • 轻量任务：推荐 claude-haiku-4-5-20251001，响应速度快，成本低

前置准备 ​

1. 获取海鲸AI API Key ​

  1. 访问 海鲸AI控制台
  2. 注册并登录账户
  3. 在 API 管理页面生成 API Key
  4. 确保账户有足够余额或免费额度
新用户福利

首次注册海鲸AI，可获得新人免费额度，可用于所有模型推理服务。

2. 系统要求 ​

系统要求
操作系统macOS 10.15+、Windows 10+、Linux
Node.jsv18.0 及以上版本
npmv7.0+
终端支持彩色输出的现代终端

验证 Node.js 版本

bash
node -v

输出版本号 v18.x.x 或以上即满足要求。若未安装，请前往 Node.js 官网 下载安装。

安装 Kilo CLI ​

全局安装 ​

bash
npm install -g @kilocode/cli

验证安装 ​

bash
kilo --version

若输出版本号，表示安装成功。

安装提示

  • 若安装失败，请检查 Node.js 版本是否为 18 及以上
  • 国内用户可使用 npm 镜像加速：npm config set registry https://registry.npmmirror.com
  • macOS/Linux 遇到权限问题可使用 sudo npm install -g @kilocode/cli

配置海鲸AI ​

Kilo CLI 通过编辑配置文件 ~/.config/kilo/config.json 来连接模型服务。

步骤 1：打开配置文件 ​

bash
vim ~/.config/kilo/config.json
powershell
notepad %APPDATA%\kilo\config.json

步骤 2：填入海鲸AI配置 ​

将以下内容复制粘贴到配置文件中，并将 sk-xxxxxxxxxxxxxxxx 替换为您的海鲸AI API Key：

json
{
  "$schema": "https://kilo.ai/config.json",
  "provider": {
    "haijing": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "海鲸AI",
      "options": {
        "baseURL": "https://api.atalk-ai.com/v1",
        "apiKey": "sk-xxxxxxxxxxxxxxxx"
      },
      "models": {
        "claude-sonnet-4-6": {
          "name": "claude-sonnet-4-6"
        },
        "claude-opus-4-7": {
          "name": "claude-opus-4-7"
        },
        "claude-haiku-4-5-20251001": {
          "name": "claude-haiku-4-5-20251001"
        }
      }
    }
  }
}
json
{
  "$schema": "https://kilo.ai/config.json",
  "provider": {
    "haijing": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "海鲸AI",
      "options": {
        "baseURL": "https://api.atalk-ai.com/v1",
        "apiKey": "sk-xxxxxxxxxxxxxxxx"
      },
      "models": {
        "claude-sonnet-4-6": {
          "name": "claude-sonnet-4-6"
        },
        "claude-opus-4-7": {
          "name": "claude-opus-4-7"
        },
        "claude-haiku-4-5-20251001": {
          "name": "claude-haiku-4-5-20251001"
        },
        "gpt-5.4": {
          "name": "gpt-5.4"
        },
        "deepseek-v3": {
          "name": "deepseek-v3"
        }
      }
    }
  }
}

注意事项

  • 将 sk-xxxxxxxxxxxxxxxx 替换为您真实的海鲸AI API Key
  • 配置文件保存后重启 Kilo CLI 即可生效
  • API Key 请妥善保管，不要提交到代码仓库
  • 可在 models 字段中按需添加更多模型，完整模型列表请参见模型列表

步骤 3：启动并选择模型 ​

保存配置文件后，重新启动 Kilo CLI，在对话框中输入 /models，搜索 海鲸AI，选择您需要的模型即可开始使用。

Kilo CLI 模型选择界面

启动与使用 ​

启动 Kilo CLI ​

bash
cd your-project    # 进入项目目录
kilo               # 启动 Kilo CLI

Kilo CLI 对话界面

TIP

Kilo CLI 会以当前目录作为项目上下文，请确保在正确的项目目录中启动。

常用命令 ​

命令功能
/models查看并切换模型
/clear清空对话历史
/help查看帮助信息

实战示例 ​

示例 1：代码生成 ​

👤 用户：
写一个 TypeScript 函数，对数组去重并按升序排序

🤖 Kilo CLI：
function deduplicateAndSort(arr: number[]): number[] {
  return [...new Set(arr)].sort((a, b) => a - b);
}

// 示例
console.log(deduplicateAndSort([3, 1, 4, 1, 5, 9, 2, 6, 5]));
// 输出: [1, 2, 3, 4, 5, 6, 9]

示例 2：代码调试 ​

👤 用户：
为什么这段代码的 Promise 结果总是 undefined？
async function fetchData() {
  fetch('https://api.example.com/data').then(res => res.json());
}

🤖 Kilo CLI：
问题在于 async 函数没有 return fetch() 的结果。修复如下：
async function fetchData() {
  return fetch('https://api.example.com/data').then(res => res.json());
}
// 或使用 await：
async function fetchData() {
  const res = await fetch('https://api.example.com/data');
  return res.json();
}

示例 3：单元测试生成 ​

👤 用户：
为以下函数生成单元测试：
function add(a: number, b: number): number {
  return a + b;
}

Kilo CLI 将自动生成使用 Jest 或 Vitest 的完整测试用例，覆盖正常值、边界值、负数等场景。

常见问题 ​

Q1：连接模型后报错或无法获得响应怎么办？ ​

可能的原因及解决方案：

  1. API Key 不正确 - 登录 海鲸AI控制台 重新生成并复制 API Key
  2. baseURL 填写有误 - 确认填写的是 https://api.atalk-ai.com/v1（注意末尾有 /v1）
  3. 模型名称不正确 - 参考模型列表确认模型 ID 拼写无误
  4. 账户余额不足 - 登录控制台检查余额，充值后重试

Q2：如何切换模型？ ​

在对话框中输入 /models，在搜索框中输入模型名称（如 claude 或 gpt-5）进行模糊搜索，选择对应模型即可切换。

若未找到目标模型，请在配置文件的 models 字段中添加该模型后重启 Kilo CLI。

Q3：如何添加更多模型？ ​

在配置文件的 models 字段中添加新的模型条目：

json
"models": {
  "claude-sonnet-4-6": {
    "name": "claude-sonnet-4-6"
  },
  "gpt-5-mini": {
    "name": "gpt-5-mini"
  }
}

保存后重启 Kilo CLI 即可在 /models 中看到新增的模型。

Q4：如何更新 Kilo CLI？ ​

bash
npm install -g @kilocode/cli@latest

Q5：支持哪些编程语言？ ​

Kilo CLI 支持所有主流编程语言：

支持的语言列表

Web 开发：JavaScript、TypeScript、HTML、CSS、Vue、React

后端开发：Python、Java、Go、Rust、C/C++、C#、PHP、Ruby

移动开发：Swift、Kotlin、Dart (Flutter)

数据科学：Python (NumPy/Pandas)、R、SQL

其他：Shell、YAML、JSON、Markdown

错误码说明 ​

HTTP 状态码含义解决方案
401API Key 认证失败检查 API Key 是否正确；确认 baseURL 为 https://api.atalk-ai.com/v1
403权限不足检查 API Key 权限；确认模型访问权限
429请求频率限制稍等片刻后重试；或升级账户配额
500服务器错误稍后重试；联系技术支持

其他 AI 编程工具 ​

工具平台特点
Kilo CLI命令行开源、配置灵活、终端交互
Claude Code命令行Anthropic 官方、深度代码理解
OpenCode命令行轻量开源、快速上手
ClineVSCodeIDE 插件、自主规划多步骤任务

技术支持 ​

渠道响应时间适用场景
📖 文档中心即时查阅常见问题
💬 在线客服工作日 9:00-18:00实时技术咨询
📧 邮件支持24小时内详细问题描述和反馈

© 2024 海鲸AI. 保留所有权利。

本文档最后更新于 2026-04-17