Claude Code Python Feature List & PR Roadmap

Claude Code Python Feature List & PR Roadmap

面向社区贡献者的能力清单、路线图与 PR 指南。

项目定位：**基于真实 Claude Code 源码结构的 Python 重构版**。当前已经具备可用的多 Provider 聊天 CLI、完整工具系统框架与 Agent Loop，正在分阶段完善原生 Claude Code 的关键能力。

---

状态说明

状态	含义
✅ 已实现	当前仓库中已有可验证实现
🟡 部分完成	已有骨架、镜像层或部分能力，但未形成完整闭环
⏳ 规划中	已明确方向，欢迎提交 PR
🚫 未开始	当前尚无实现

---

项目亮点

• Python 重构版：不是单纯 UI 模仿，而是按 Claude Code 的架构思路重建。
• 多模型先行：当前已支持 Anthropic、OpenAI、GLM 三类 Provider。
• CLI / REPL 可用：已经具备基础交互能力，适合持续迭代。
• 工具系统框架完整：已实现 30+ 工具模块、Agent Loop、权限系统框架。
• 更适合社区共建：Python 生态更易二开，适合工具、自动化、数据工程场景扩展。
• 强调真实性：优先补齐真正可运行的核心链路，而不是只扩大命令/工具名录。

---

核心系统

能力	状态	当前情况
CLI 启动入口	✅	已支持 clawd、login、config、--version
交互式 REPL	✅	支持交互式输出、历史记录、Tab 补全、多行输入
Slash Commands	✅	已支持 /help、/clear、/save、/load、/multiline、/exit
多 Provider 抽象	✅	已支持 Anthropic / OpenAI / GLM
Provider 配置管理	✅	支持默认 Provider、Base URL、默认模型配置
会话持久化	✅	支持保存/加载本地会话
会话消息管理	✅	支持会话历史维护与序列化
错误恢复 / 重新登录	🟡	已有基础认证错误处理与重新配置流程
Token / Cost 跟踪	🚫	当前聊天 CLI 尚未形成完整统计视图
上下文构建	🟡	已有 context_system 基础版，支持 workspace / git / CLAUDE.md 注入，仍缺 README 摘要、memory、compact
Claude Code Agent Loop	✅	已实现 agent_loop.py，支持工具调用循环
/resume 会话恢复体验	🚫	暂无独立恢复流程与 UI
/compact 对话压缩	🚫	暂无自动/手动压缩能力
/doctor 诊断系统	🚫	暂无环境、配置、权限、依赖诊断命令
Hook 系统	🚫	暂无 pre/post tool use hooks
权限系统	🟡	已有 permissions.py 框架，尚未完全集成

---

工具系统

**重大进展**：当前仓库已实现完整的工具系统框架，包括 30+ 工具模块、Agent Loop、Schema 验证、权限框架等。

工具框架

能力	状态	当前情况
Tool Registry	✅	已实现工具注册与发现机制
Tool Protocol	✅	已定义工具协议与基类
Schema Validation	✅	已实现参数校验系统
Agent Loop	✅	已实现完整的工具调用循环
Tool Context	✅	已实现工具上下文管理
Permission Framework	🟡	已有权限检查框架，待完善集成
Error Handling	✅	已定义工具错误类型与处理
Task Manager	✅	已实现任务管理器

已实现工具模块

工具类别	工具名称	文件	状态
文件操作	FileReadTool	read.py	✅ 已实现
文件操作	FileWriteTool	write.py	✅ 已实现
文件操作	FileEditTool	edit.py	✅ 已实现
文件操作	GlobTool	glob.py	✅ 已实现
文件操作	GrepTool	grep.py	✅ 已实现
系统操作	BashTool	bash.py	✅ 已实现
网络工具	WebFetchTool	web_fetch.py	✅ 已实现
网络工具	WebSearchTool	web_search.py	✅ 已实现
交互工具	AskUserQuestionTool	ask_user_question.py	✅ 已实现
交互工具	SendUserMessageTool	send_user_message.py	✅ 已实现
任务管理	TodoWriteTool	todo_write.py	✅ 已实现
任务管理	TaskStopTool	task_stop.py	✅ 已实现
任务管理	TasksV2Tool	tasks_v2.py	✅ 已实现
任务管理	TaskManager	task_manager.py	✅ 已实现
Agent 工具	AgentTool	agent.py	✅ 已实现
Agent 工具	BriefTool	brief.py	✅ 已实现
Agent 工具	TeamTool	team.py	✅ 已实现
配置工具	ConfigTool	config.py	✅ 已实现
计划模式	PlanModeTool	plan_mode.py	✅ 已实现
定时任务	CronTool	cron.py	✅ 已实现
MCP 工具	MCPT