GitHub · 使用指南 · Rust 工作区 · 兼容性 · 路线图 · English

Claw Code 是 claw CLI 智能体框架的 Rust 开源实现。核心代码位于 rust/，本仓库为 ultraworkers/claw-code。

npm 安装（推荐）：

npm install -g claw --registry=https://npm.cnb.cool/ccdecode/claw/-/packages/

或下载预编译二进制： 见 CNB Releases

或从源码构建：

git clone https://github.com/ultraworkers/claw-code && cd claw-code/rust
cargo build --workspace

所有模型都需要配置环境变量。可在 ~/.bashrc / ~/.zshrc 中 export 持久化，也可写入 ~/.config/claw/settings.json。

claw 支持 OpenAI 兼容和 Anthropic 兼容两种协议。同一个模型提供商可能提供两种端点，不能混用。

协议	环境变量	说明
OpenAI 兼容	OPENAI_API_KEY + OPENAI_BASE_URL	适用于大多数国产模型
Anthropic 兼容	ANTHROPIC_AUTH_TOKEN + ANTHROPIC_BASE_URL	适用于 Anthropic 协议端点
Anthropic 原生	ANTHROPIC_API_KEY	Claude 官方 API

智谱提供两种协议端点，选一种配置即可：

方式 A — OpenAI 兼容（推荐）：

export OPENAI_API_KEY="sk-你的智谱API密钥"
export OPENAI_BASE_URL="https://open.bigmodel.cn/api/paas/v4"

claw --model "glm-5.1" prompt "你好"
claw --model "glm-5-turbo" prompt "快速回答"
claw --model "glm-4-flash" prompt "免费模型"

方式 B — Anthropic 兼容：

export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"
export ANTHROPIC_AUTH_TOKEN="sk-你的智谱API密钥"

claw --model "glm-5.1" prompt "你好"

⚠️ 注意： 不要同时设置 OPENAI_BASE_URL 和 ANTHROPIC_BASE_URL，两者会冲突。切换前先清掉不用的：

# 切换到 OpenAI 兼容端点时
unset ANTHROPIC_BASE_URL
unset ANTHROPIC_AUTH_TOKEN

# 切换到 Anthropic 兼容端点时
unset OPENAI_BASE_URL
unset OPENAI_API_KEY

可用模型： glm-5 / glm-5-turbo / glm-5.1 / glm-4.7 / glm-4-flash / glm-4-long / glm-4v

export OPENAI_API_KEY="sk-sp-你的CodingPlan密钥"
export OPENAI_BASE_URL="https://coding.dashscope.aliyuncs.com/v1"

claw --model "qwen3.5-plus" prompt "帮我重构代码"

Coding Plan 端点（coding.dashscope.aliyuncs.com）和普通 DashScope 端点（dashscope.aliyuncs.com）是不同的。

export OPENAI_API_KEY="你的MiniMax密钥"
export OPENAI_BASE_URL="https://api.minimaxi.com/v1"    # 国内
# export OPENAI_BASE_URL="https://api.minimax.io/v1"    # 国际

claw --model "m2.7" prompt "实现一个链表"
claw --model "abab7-chat-preview" prompt "写单元测试"

export OPENAI_API_KEY="你的DeepSeek密钥"
export OPENAI_BASE_URL="https://api.deepseek.com/v1"

claw --model "deepseek-chat" prompt "解释这个算法"
claw --model "deepseek-reasoner" prompt "解决这道编程题"

export OPENAI_API_KEY="你的Moonshot密钥"
export OPENAI_BASE_URL="https://api.moonshot.cn/v1"

claw --model "moonshot-v1-128k" prompt "分析大文件"

export ANTHROPIC_API_KEY="sk-ant-..."

claw --model "sonnet" prompt "hello"
claw --model "opus" prompt "深度分析"

export OPENAI_BASE_URL="http://127.0.0.1:11434/v1"

claw --model "llama3.2" prompt "hello"

平台	价格	推荐模型	OpenAI 兼容端点	Anthropic 兼容端点
智谱 AI	~29 元/月	GLM-5.1 / GLM-5-Turbo	.../api/paas/v4	.../api/anthropic
阿里云百炼	~7.9 元/月	Qwen3.5-Plus	.../coding.dashscope.aliyuncs.com/v1	—
MiniMax	~19.9 元/月	M2.7	.../api.minimaxi.com/v1	—
DeepSeek	按 Token 计费	DeepSeek-V3	.../api.deepseek.com/v1	—
Moonshot	按 Token 计费	Moonshot-V1	.../api.moonshot.cn/v1	—

claw doctor                  # 健康检查
claw prompt "你好"           # 单次提问
claw                         # 进入交互式 REPL

将配置写入 ~/.config/claw/settings.json，避免每次 export：

{
  "env": {
    "OPENAI_API_KEY": "your-api-key",
    "OPENAI_BASE_URL": "https://open.bigmodel.cn/api/paas/v4"
  },
  "aliases": {
    "glm": "glm-5.1",
    "glm-turbo": "glm-5-turbo",
    "qwen": "qwen3.5-plus",
    "minimax": "m2.7"
  }
}

然后就可以用别名：

claw --model glm prompt "你好"
claw --model glm-turbo prompt "快速回答"

更多配置详情（代理、会话、兼容性测试等）请参阅 USAGE.md。

---

• rust/ — Rust 工作区和 claw CLI 二进制
• npm/ — npm 跨平台安装包，支持 npm install claw
• USAGE.md — 面向任务的使用指南（npm 安装、Coding Plan 配置、会话管理）
• PARITY.md — Rust 移植兼容性状态
• ROADMAP.md — 路线图和待办事项
• PHILOSOPHY.md — 项目理念和系统设计
• scripts/ — 跨平台构建和发布自动化脚本
• skills/ — Claude Code 构建和发布技能
• src/ + tests/ — Python 参考工作区和审计辅助工具，非主要运行时

git clone https://github.com/ultraworkers/claw-code
cd claw-code/rust
cargo build --workspace
./target/debug/claw doctor

Windows 用户： 二进制文件名为 claw.exe，使用 .\target\debug\claw.exe 运行。

运行测试：

cd rust && cargo test --workspace

• USAGE.md — 完整使用指南（认证、会话、配置、npm 安装、Coding Plan 配置）
• rust/README.md — crate 结构、CLI 接口、功能特性
• PARITY.md — Rust 移植兼容性状态
• ROADMAP.md — 路线图和待办事项
• PHILOSOPHY.md — 项目理念和设计哲学

• REPL 弹性恢复：交互式 REPL 在遇到 API 错误（429 速率限制、419、5xx 服务器错误等）时不再退出。错误会被捕获并显示在会话内 — 输入新消息继续对话，或输入 /exit 退出。
• 自动重试：可重试的 API 故障（速率限制、临时服务器错误）会在 REPL 层面自动重试最多 3 次，每次间隔 5 秒，叠加在 API 提供商层面的指数退避重试之上。
• HTTP 419 支持：状态码 419 现在被归类为可重试错误，确保网关和代理在临时过载时返回 419 后能自动重试。

使用 scripts/cross-build-release.sh 自动构建所有平台并发布到 CNB：

CNB_TOKEN="your-token" ./scripts/cross-build-release.sh v2026.4.10

• clawhip
• oh-my-openagent
• oh-my-claudecode
• oh-my-codex
• UltraWorkers Discord

• 本仓库不主张对原始 Claude Code 源材料的所有权。
• 本仓库不隶属于、不由 Anthropic 认可或维护。