Kode：Claude Code 开源优化版

Kode是一个强大的AI助手，它直接在你的电脑终端里运行。你可以把它看作一个和你一起工作的程序员，它能理解你的代码库，帮你编辑文件，还能执行命令行指令来处理整个开发流程。和其他工具不同的是，Kode可以同时使用多种不同的大模型，比如DeepSeek、Kimi、GLM、Qwen Coder等。这让它可以根据不同的任务，选择最合适的模型来解决问题。例如，在设计系统架构时调用一个擅长抽象思维的模型，在具体写代码时切换到另一个精通代码生成的模型。Kode通过一个智能的@提及系统和模糊匹配的自动补全功能，让你能方便地调用这些模型、代理（agents）或者项目文件，大幅提升开发效率。它还支持通过Docker部署，并提供了一个安全模式，以便在处理重要项目时增加一道手动确认的保险。

已经失效的相关项目：analysis_claude_code: uma biblioteca para análise de engenharia reversa do código ClaudeeAnon-Kode: assistente de código de IA de linha de comando (decompilação de código do Claude Code)

学习：Claude Code 何以如此出色？解构其 Agent 设计的内在魔力eGuia prático completo do Claude Code: da configuração introdutória aos fluxos de trabalho de automação avançados

Lista de funções

• 多模型协作: 支持同时配置和使用多个大语言模型，能根据任务需求灵活切换，发挥不同模型的特长。
• 智能代理系统: 可以使用@run-agent-name格式的指令，把特定任务交给专门的子代理去处理。
• 专家模型咨询: 在对话中随时使用@ask-model-name来请求特定的AI模型，针对疑难问题给出专业分析。
• 代码理解和编辑: 能够分析整个项目的代码结构和文件关系，并根据指令直接对代码文件进行修改。
• execução de comandos: 可以直接在终端环境中执行shell命令，并实时返回结果。
• 智能自动补全: 强大的补全系统，通过模糊匹配、缩写支持等多种算法，让你能快速输入命令、文件路径和模型名称。
• Geração automática de documentos: SuporteAGENTS.md标准，可以使用#开头的自然语言请求，自动生成和维护项目文档。
• Suporte a várias plataformas: 提供多种安装方式，包括Bunresponder cantandonpm，并支持通过Docker容器化部署。

Usando a Ajuda

Kode作为一个功能强大的终端AI助手，提供了灵活的安装和使用方式。下面是详细的操作指南，帮助你快速上手。

Processo de instalação

RecomendadoBun进行安装，因为它速度最快。如果你的系统中没有安装Bun，可以先通过以下命令安装：

curl -fsSL https://bun.sh/install | bash

configurarBun之后，再执行以下命令来全局安装Kode：

bun add -g @shareai-lab/kode

如果你更习惯使用npm，也可以通过下面的命令安装：

npm install -g @shareai-lab/kode

安装成功后，你可以使用三个命令中的任意一个来启动Kode：kode（主命令）、kwa（Kode With Agent的缩写）或kd（超短别名）。

Uso básico

Kode支持两种主要的操作模式：交互模式和非交互模式。

1. modo interativo
   直接在终端输入主命令即可进入一个持续对话的交互会话：

   kode
   

   在这个模式下，你可以和AI进行连续的对话，它会记住上下文，适合处理复杂的、需要多步操作的任务。

2. 非交互模式
   如果你只是想快速得到一个问题的答案或执行一个简单的指令，可以使用-p参数，这种模式执行完后会立刻退出：

   kode -p "解释一下这个函数的作用" src/main.js
   

Operação da função principal

1. 使用@提及系统

@提及系统是Kode的核心特色，它极大地简化了与模型、代理和文件的交互。

• 咨询专家模型: 当你遇到难题时，可以指定一个特定的模型来回答。Kode的智能补全会提示可用的模型。

  @ask-gpt-5 这个身份验证方法的安全隐患是什么？
  @ask-o1-preview 分析一下这个算法的复杂度。
  

• 调用专业代理: 将复杂的任务交给预设的专业代理来执行。

  @run-agent-architect 为这个系统设计一个微服务架构。
  @run-agent-test-writer 为这些模块创建全面的测试。
  

• 引用项目文件: 方便地在对话中引用项目文件或目录，Kode会自动补全路径。

  @src/components/Button.tsx
  @docs/api-reference.md
  

2. geração automática de documentos

Kode遵循AGENTS.md规范，可以帮你自动化生成项目文档。只需在交互模式下，使用#作为开头来提问或发出指令。

# 如何设置开发环境？
# 这个项目的测试流程是怎样的？

Kode会将回答自动格式化，并追加到项目根目录下的AGENTS.mdDocumentação.

3. 安全模式

默认情况下，Kode运行在YOLO模式，它会自动执行文件修改和命令，以实现最高效率。但在处理关键项目时，建议启用安全模式。在安全模式下，所有危险操作都需要你手动批准。

kode --safe

4. 内部命令

在交互模式中，你可以使用/开头的命令来控制Kode的行为：

• /help: 显示所有可用的内部命令。
• /model: 切换或配置当前使用的AI模型。你可以在这里为主要任务、子代理任务等设置不同的默认模型。
• /config: 打开全局配置文件进行更详细的设置。
• /cost: 查看当前会话中各个模型消耗的token数量和费用。
• /clear: 清除当前的对话历史，开始一个新的会话。

5. Docker部署

如果你希望在隔离的环境中使用Kode，或者方便地在不同机器上部署，可以使用Docker。

首先，克隆Kode的源码仓库并进入目录：

git clone https://github.com/shareAI-lab/Kode.git
cd Kode

然后，构建Docker镜像：

docker build --no-cache -t kode .

构建完成后，在你自己的项目录下，执行以下命令来启动Kode容器。这个命令会将你的项目目录、Kode的配置目录和配置文件都挂载到容器中，确保数据持久化。

cd your-project
docker run -it --rm \
-v $(pwd):/workspace \
-v ~/.kode:/root/.kode \
-v ~/.kode.json:/root/.kode.json \
-w /workspace \
kode

Kode 与 Claude 对比

cenário do aplicativo

1. 自动化代码重构
   当需要对旧代码库进行现代化改造或重构时，开发者可以指令Kode：“使用@run-agent-refactor将项目中所有的class组件重构为React Hooks फंक्शन组件”，Kode会扫描整个代码库，定位目标文件并逐一进行修改。
2. 快速生成单元测试
   为已有功能补全测试用例。开发者可以指向一个复杂的函数文件，然后指令Kode：“使用@run-agent-test-writerpor causa de@src/utils/calculation.js里的所有函数生成单元测试”，Kode会自动分析函数逻辑并创建对应的测试文件。
3. 系统架构设计
   在新项目启动阶段，产品经理或架构师可以使用Kode进行头脑风暴。例如，输入：“使用@ask-o3-preview为我们的电商系统设计一个高并发的秒杀活动技术方案”，Kode可以提供一个初步但全面的架构设计文档。
4. 跨语言项目开发
   在一个包含多种编程语言的项目中，开发者可能不熟悉其中某一种。他可以指令Kode：“使用Qwen Coder模型，帮我用Python写一个脚本，用于解析这个Java项目生成的日志文件”。Kode可以利用特定模型的代码能力完成任务。

QA

1. Kode与GitHub Copilot这类工具有什么不同？
   GitHub Copilot主要作为代码编辑器内的插件，提供代码自动补全和建议。而Kode是一个在终端里运行的、更加独立的AI助手，它的能力不止于写代码，还能执行shell命令、管理文件、自动化整个工作流，并且可以协同多个不同的AI模型并行处理任务，更像一个可以与你对话和执行复杂指令的AI开发者。
2. 默认的“YOLO模式”是否安全？我应该何时使用--safe模式？
   “YOLO模式”为了提升效率，会跳过所有权限检查直接执行操作。这在受信任的开发环境和非关键项目上是高效的。但是，如果你正在处理包含重要数据或敏感信息的生产项目，或者使用的模型来源不够可靠，强烈建议使用kode --safe命令启动，这样所有危险操作（如修改文件、执行命令）都需要你手动确认后才能执行，提供了额外的安全保障。
3. Kode支持哪些AI模型？我可以添加自己的模型吗？
   Kode原生支持与多种主流AI模型协作，如DeepSeek V3.1、Kimi2、GLM-4.5、Qwen Coder等。它的架构设计是开放的，只要模型提供了与OpenAI兼容的API接口，你就可以通过修改配置文件（使用/config命令或直接编辑~/.kode.json文件）将自己的模型接入到Kode中使用。
4. 为什么Kode推荐使用Bun而不是npm来安装？
   Bun是一个现代化的JavaScript运行时，它的包管理器在安装依赖时通常比npm快很多。为了让用户能更快地完成安装和设置，Kode官方推荐使用Bun。当然，如果你已经习惯了npm生态，使用npm install同样可以完成安装，功能上没有任何区别。