Nanocode-CLI：一款輕量級終端AI編碼助手

Nanocode-CLI 是一款基於終端的輕量級AI編碼助手，完全用 Python 編寫，旨在為開發者提供高效、直觀的輔助編程體驗。項目的 GitHub 倉庫由 hit9 維護，目前處於 1.0 版本前的開發階段，命令、配置和工具行為可能隨時變化。

核心特性

Nanocode-CLI 提供了多項創新功能。實時控制允許用户在工作流進行中追加輸入，而不會中斷當前的工具流。文件狀態大腦功能通過讀取和編輯操作構建帶有行號的當前文件視圖，讓開發者清晰瞭解文件最新狀態。陳舊編輯保護機制利用行和哈希錨點，拒絕針對已變更代碼的編輯請求，避免造成混亂。

項目感知導航藉助符號索引，用户可以快速跳轉到大綱、引用和變更文件。可恢復上下文確保工具輸出在提示中保持邊界，同時原始結果仍可回溯。緩存感知上下文將穩定部分前置，嘈雜工作狀態後置，以優化提示緩存複用。聚焦工作記憶通過筆記區分目標、計劃和已知事實，避免被執行日誌干擾。

安裝與使用

安裝 Nanocode-CLI 非常簡便，只需執行 uv tool install nanocode-cli，升級則使用 uv tool upgrade nanocode-cli。對於本地開發，可通過 uv sync --extra dev 和 uv run nanocode 啓動。

啓動後，CLI 會呈現交互界面，常用參數包括 --config 指定 TOML 配置文件、--init-config 創建默認配置、--yolo 跳過工具確認，以及 -v 顯示版本。在運行過程中，+> 提示符允許用户輸入後續指令。

命令與工具

內置命令涵蓋幫助、狀態查看、配置顯示、API 設置、調試開關、上下文壓縮、符號索引重建、提供商和模型選擇等。工具集則包括文件讀寫、行計數、搜索、代碼索引檢查、編輯、Shell 執行、Git 操作、結果回溯和筆記管理。其中，編輯工具使用行哈希錨點確保編輯有效性。

配置與提供商

首次運行 nanocode --init-config 可生成默認配置，通常位於 ~/.nanocode/config.toml。配置支持設置提供商（如 DeepSeek、OpenCode、阿里雲通義千問、本地 llama.cpp 等）、API 密鑰、模型、推理參數等。api 參數設為 auto 時，可根據提供商自動選擇合適的 API 格式。

上下文設計

每次模型請求由顯式消息構建，穩定上下文優先，對話作為消息保留，工作記憶緊隨其後，最新文件狀態附加在末尾。這種設計有效控制了提示長度，並提升了緩存利用率。

安全提示

Nanocode-CLI 可以編輯文件和執行 Shell 命令，不提供沙箱保護。開發者應在隔離環境（如容器、虛擬機）中運行，以確保系統安全。

總之，Nanocode-CLI 為終端愛好者提供了一款輕量但功能強大的 AI 編碼助手，特別適合偏好命令行工作流的開發者。