项目简介

Claw Code 是一个功能强大的代码助手工具，提供 Python 和 Rust 两个版本的实现，支持代码生成、分析和代理开发工作流。

环境要求

• Python 3.13+
• Rust 1.94+
• Anthropic API 密钥（用于使用 Claude 模型）

安装步骤

1. 安装 Python

1. 下载 Python 3.13+ 安装程序
2. 运行安装程序，确保勾选 “Add Python to PATH”
3. 验证安装：

   python --version
   

2. 安装 Rust

1. 下载并运行 Rust 安装程序：

   Invoke-WebRequest -Uri "https://static.rust-lang.org/rustup/dist/x86_64-pc-windows-msvc/rustup-init.exe" -OutFile "rustup-init.exe"
   & .\rustup-init.exe -y
   

2. 添加 Rust 到系统路径：

   $env:PATH += ";$env:USERPROFILE\.cargo\bin"
   

3. 验证安装：

   rustc --version
   cargo --version
   

3. 构建项目

1. 克隆项目仓库：

   git clone https://github.com/ultraworkers/claw-code.git
   cd claw-code
   

2. 构建 Rust 部分：

   cd rust
   cargo build --release
   cd ..
   

环境配置

1. 设置系统路径

# 添加 Python 和 Rust 到系统路径
$env:PATH += ";C:\Program Files\Python313;C:\Program Files\Python313\Scripts;$env:USERPROFILE\.cargo\bin"

# 设置 HOME 环境变量
$env:HOME = $env:USERPROFILE

# 设置 Anthropic API 密钥
$env:ANTHROPIC_API_KEY = "你的 API 密钥"

2. 持久化配置

将以下内容添加到 PowerShell 配置文件中（$PROFILE）：

# Claw Code 环境配置
$env:PATH += ";C:\Program Files\Python313;C:\Program Files\Python313\Scripts;$env:USERPROFILE\.cargo\bin"
$env:HOME = $env:USERPROFILE
$env:ANTHROPIC_API_KEY = "你的 API 密钥"

使用方法

Python 版本

# 查看项目摘要
python -m src.main summary

# 查看命令列表
python -m src.main commands --limit 10

# 查看工具列表
python -m src.main tools --limit 10

# 执行命令（包含空格）
powershell -Command "python -m src.main exec-command add-dir \"Create a new directory\""

# 执行工具（包含空格）
powershell -Command "python -m src.main exec-tool AgentTool '{\"agent\": \"generalPurposeAgent\", \"prompt\": \"Write a Python function\"}'"

Rust 版本

# 启动交互式 REPL
rust/target/release/claw.exe

# 运行单个提示
rust/target/release/claw.exe "写一个 Python 函数来计算斐波那契数列"

# 查看帮助
rust/target/release/claw.exe --help

# 设置别名（方便使用）
Set-Alias -Name claw -Value "E:\soft\claw-code-main\rust\target\release\claw.exe"

# 现在可以直接使用 claw 命令
claw "写一个 Dockerfile"

常见问题及解决方案

1. 命令未找到错误

问题：python 或 rustc 命令未找到
解决方案：确保已将 Python 和 Rust 添加到系统路径

2. HOME 环境变量未设置

问题：io error: HOME is not set
解决方案：设置 HOME 环境变量：

$env:HOME = $env:USERPROFILE

3. API 凭证缺失

问题：missing Claw credentials
解决方案：设置 Anthropic API 密钥：

$env:ANTHROPIC_API_KEY = "你的 API 密钥"

4. PowerShell 参数解析问题

问题：执行包含空格的命令时参数解析错误
解决方案：使用 powershell -Command 来执行包含空格的命令

5. 会话文件不存在

问题：failed to restore session: 系统找不到指定的文件
解决方案：这是预期的，因为会话文件还不存在。先运行其他命令创建会话。

集成到 Trae

1. 创建技能目录

New-Item -ItemType Directory -Path "$env:USERPROFILE\.trae-cn\skills\claw-code" -Force

2. 创建技能定义文件

在 $env:USERPROFILE\.trae-cn\skills\claw-code\ 目录下创建 SKILL.md 文件，内容包括 Claw Code 的功能、使用方法和示例。

3. 创建工具配置文件

在同一目录下创建 tool.json 文件，定义在 Trae 中可以使用的 Claw Code 命令。

4. 通过 Trae 命令面板使用

1. 打开 Trae 命令面板（Ctrl+Shift+P）
2. 输入 “claw:” 查看可用的 Claw Code 命令
3. 选择你需要的命令并执行

高级功能

会话管理

# 导出会话
claw --resume session.json /export notes.txt

# 查看会话状态
claw --resume session.json /status

插件管理

# 列出插件
claw /plugin list

# 安装插件
claw /plugin install <path>

Git 集成

# 查看分支
claw /branch list

# 创建提交
claw /commit

示例工作流

代码生成

# 使用 Rust 实现
claw "写一个 Python 函数来计算斐波那契数列"

# 使用 Python 实现
powershell -Command "python -m src.main exec-command add-dir \"Create a new directory\""

项目分析

# 使用 Python 实现
python -m src.main summary

# 使用 Rust 实现
claw "分析这个代码库并提出改进建议"

代理开发

# 使用 Python 实现
powershell -Command "python -m src.main exec-tool AgentTool '{\"agent\": \"generalPurposeAgent\", \"prompt\": \"Build a simple web server\"}'"

# 使用 Rust 实现
claw "Use the general purpose agent to build a simple web server"

结论

Claw Code 是一个功能强大的代码助手工具，通过本文档的配置和使用指南，你可以在本地环境中成功部署和使用 Claw Code，提高开发效率。

注意事项

• 确保网络连接正常，能够访问 Anthropic API
• 注意 API 密钥的安全，不要在公共场合暴露
• 定期更新 Claw Code 到最新版本以获得最佳体验
• 如果遇到问题，请参考错误信息和本文档的故障排除部分