FAQ — 常见问题

niuma_code 最常见问题的解答。

基本介绍

niuma_code 是什么？

niuma_code 是 Claude Code 的配套命令行工具。它提供持久记忆、并行上下文、多供应商路由和代码知识图谱等功能，扩展 Claude Code 的能力。

核心差异： niuma_code 通过记忆系统跨会话积累经验，AI 会随时间学习你的代码库。

niuma_code 和 Claude Code 有什么区别？

方面 niuma_code Claude Code
记忆 持久化跨会话记忆（SQLite） 无持久记忆
多上下文 N 个并行上下文 + LRU 淘汰 单一上下文
供应商 多个 API 端点 + 模型路由 单一供应商
知识图谱 内置 tree-sitter 代码图谱 仅外部工具
TUI 全屏终端界面 + 鼠标支持 标准 CLI
费用 自带 API Key（同一 Anthropic 账单） 需订阅

niuma_code 专为希望掌控 AI 编程工作流的开发者设计。

niuma_code 是免费的吗？

是的。niuma_code 基于 MIT 许可证开源。你只需为自己使用的 API（Anthropic 或兼容供应商）付费。

支持哪些编程语言？

niuma_code 本身用 Python 编写。代码知识图谱支持 Python、JavaScript、TypeScript、Go、Java、Rust、Ruby 和 PHP 的符号索引。

该工具支持任何语言的代码库——可读取、写入和搜索所有文件类型。

配置相关

需要安装 Python 吗？

不需要。niuma_code 以单个便携式可执行文件（niuma.exe）分发，无需安装 Python、Node.js 或 npm。

如何配置 API 密钥？

在 ~/.niuma/settings.json 中创建配置文件：

{
    "factories": [
        {
            "base_url": "https://api.anthropic.com",
            "api_key": "sk-ant-你的密钥",
            "options": ["claude-sonnet-4-6"]
        }
    ]
}

详细步骤请参阅快速开始教程。

如何切换模型？

输入 /model 打开模型选择浮层。模型来自所有配置的供应商，可以即时切换。

数据存储在哪里？

所有数据本地存储在 ~/.niuma/projects/niuma_code/：

目录 内容
session/ 对话历史、任务状态、执行追踪
memory/ SQLite 记忆数据库
ide/ IDE 草稿文件

除了你配置的 LLM 供应商的 API 调用外，不会向外部服务器发送任何数据。

使用技巧

/loop 和 harness 模式如何选择？

使用 harness 模式当... 使用 /loop 模式当...
任务探索性或模糊 任务有清晰、可验证的步骤
你希望 AI 自己想办法 你希望结构化执行 + 检查点
快速编辑或修复 复杂多步骤工作流
单一目标工作 并行独立任务

harness 提示词示例： "修复 auth.py 中 email 缺失时的 KeyError"

/loop 提示词示例： "为 UserService 类添加单元测试：1) 创建测试文件，2) 测试 CRUD 操作，3) 运行 pytest 验证"

如何管理权限？

输入 /permission auto（默认，自动允许工具）或 /permission manual（每次工具使用前询问）。

永久允许某个工具：/permission allow execute_bash

设置持久化到 rules/permissions.json。

如何使用 IDE 编排模式？

  1. 输入 /ide new <脚本名> 创建新的编排脚本
  2. 编写包含 llm_call() / llm_confirm() / llm_judge() 函数的 Python 代码
  3. 按 F5 预览（静态分析），F6 执行

IDE 模式以原生 Python 运行，注入 LLM 桥接函数，允许你编排复杂的多步骤工作流并支持人工确认。

如何取消正在运行的操作？

随时按 Esc 或 Ctrl+C 取消：

Related Tutorials