GPT-AGI/Clawd-Code

📚 什么是 Clawd-Code？

Clawd-Code 是 Anthropic Claude Code 代理的 Python 重新实现版本。原始的 Claude Code 是用 TypeScript 编写的；本项目将相同的架构移植到惯用的 Python (3.10+) 中，并添加了类型提示、测试以及可直接运行的命令行界面。

它不仅仅是一个代码转储，它还提供了一个功能完整的 CLI REPL，可以：

逐个 token 流式传输 LLM 响应，
在循环中调用工具（文件读写、网页抓取、bash 等），以及
使用基于 Markdown 的“技能”（斜杠命令）进行扩展，这些技能可以限制它们所能使用的工具。

目标是为开发者提供一个生产就绪、可定制的 Claude 风格编码助手，并可在本地与任何支持的 LLM 提供商搭配使用。

✨ 核心功能（如 README 所述）

功能	说明
流式代理体验	实时 token 流式传输、`/stream` 切换、`/render-last` 可将上一个答案重新渲染为 Markdown。
可编程技能运行时	技能定义在 `SKILL.md` 文件中（Markdown 前言）。它们可以声明参数、允许的工具以及描述。
多提供商支持	开箱即用支持 Anthropic Claude、OpenAI GPT 和 Zhipu GLM；提供商易于添加。
交互式 REPL	丰富的终端 UI，包含历史记录、Tab 键自动补全、多行模式、会话保存/加载以及内置命令 (`/help`, `/save`, `/load` 等)。
完整 CLI	`clawd` 启动 REPL，`clawd login` 配置 API 密钥，`clawd config` 显示设置，`clawd --version` 显示版本。
工具系统	30 多种内置工具（文件操作、Bash、网页抓取/搜索、任务管理、代理层级工具、配置等），具备验证与沙盒功能。
会话持久化	会话可保存在本地并稍后重新加载。
测试与文档	涵盖技能、提供商、REPL、工具与上下文的核心测试套件；超过 10 份 Markdown 文档与变更日志。

🚀 开始使用

# Clone the repo
git clone https://github.com/GPT-AGI/Clawd-Code.git
cd Clawd-Code

# Create a virtual environment (uv is recommended)
uv venv --python 3.11
source .venv/bin/activate

# Install dependencies
uv pip install -r requirements.txt

配置您的 LLM 提供商

python -m src.cli login   # interactive wizard

向导会要求您选择提供商（Anthropic、OpenAI 或 GLM）、输入 API 密钥、可选的基础 URL 以及默认模型。配置会保存至 ~/.clawd/config.json。

运行代理

python -m src.cli          # start the REPL
python -m src.cli --help   # show CLI options

现在您可以输入自然语言、使用 /stream on 进行实时输出，或调用技能，例如：

>>> /explain-code qsort.py

🛠️ 使用技能进行扩展

在项目下（或 ~/.clawd）创建目录，例如：
```
.clawd/skills/explain-code/SKILL.md
```

写入 Markdown 前言区块：

---
description: Explain code with analogies and diagrams
allowed-tools:
  - Read
  - Grep
  - Glob
arguments: [path]
---

Explain the code in $path. Start with an analogy, then draw a diagram.

在 REPL 中使用 /explain-code <file> 调用它。

技能系统会强制执行列出的 allowed-tools，将 $path 替换为参数，并在相同的沙盒工具循环中执行。

📦 项目结构

Clawd-Code/
├─ src/
│  ├─ cli.py            # entry point
│  ├─ providers/        # Anthropic, OpenAI, GLM adapters
│  ├─ repl/             # interactive REPL implementation
│  ├─ skills/           # loader for SKILL.md files
│  └─ tool_system/      # registry, validation, loop logic
├─ tests/                # unit & integration tests
├─ .clawd/skills/        # example project-level skills
└─ FEATURE_LIST.md      # detailed feature status

🤝 贡献

本仓库遵循典型的 Python 开源工作流程：

pip install -e .[dev]          # install in editable mode with dev extras
pytest -v tests/                # run the test suite

准则位于 CONTRIBUTING.md；欢迎提交 Pull Request。

⚡ 性能与安全性

启动 < 1 秒，内存 < 50 MiB。
API 密钥以 base64 编码存储在用户配置中，且 .env 文件会被忽略。
没有机密数据会被提交到仓库中。

📄 许可

MIT – 请参阅 LICENSE。

Clawd-Code 为您提供了一个 Claude 风格的编码助手，它可以在本地运行、完全可脚本化，并可通过您自己的 Markdown 技能进行扩展——全部使用纯 Python 实现。