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 編碼助手，特別適合偏好命令列工作流的開發者。