首次配置

API 密钥配置

ClawdBot 需要 Anthropic API 密钥才能工作。有以下几种配置方式：

方法一：交互式配置

首次运行 claude 命令时，会自动提示你输入 API 密钥：

claude
# 按照提示输入你的 API 密钥

方法二：环境变量

将 API 密钥设置为环境变量（推荐）：

# macOS / Linux - 添加到 ~/.bashrc 或 ~/.zshrc
export ANTHROPIC_API_KEY="sk-ant-xxxxx"

# Windows PowerShell - 添加到 $PROFILE
$env:ANTHROPIC_API_KEY="sk-ant-xxxxx"

获取 API 密钥

1. 访问 Anthropic Console
2. 登录或注册账户
3. 进入 API Keys 页面
4. 创建新的 API 密钥

注意：请妥善保管你的 API 密钥，不要分享给他人或提交到代码仓库。

项目配置文件

ClawdBot 支持通过配置文件来定制行为。在项目根目录创建这些文件：

CLAUDE.md

这是最重要的配置文件，用于描述项目信息和规范：

# 项目名称

## 项目描述
这是一个 XXX 项目，使用 XXX 技术栈。

## 技术栈
- 前端：React + TypeScript
- 后端：Node.js + Express
- 数据库：PostgreSQL

## 代码规范
- 使用 ESLint + Prettier
- 组件使用函数式组件
- 变量命名使用 camelCase

## 目录结构
- /src - 源代码
- /tests - 测试文件
- /docs - 文档

.claudeignore

类似 .gitignore，指定 ClawdBot 应该忽略的文件和目录：

node_modules/
.git/
dist/
build/
*.log
.env

记忆功能

ClawdBot 支持跨会话记忆，让 AI 记住重要的项目信息。

MEMORY.md

创建此文件来保存需要持久化的信息：

# 项目记忆

## 重要决策
- 2024-01-15: 决定使用 PostgreSQL 而非 MySQL
- 2024-01-20: API 版本升级到 v2

## 常见问题
- 登录失败通常是因为 token 过期
- 部署时需要先运行 migration

ClawdBot 会在每次对话时读取这些文件，保持上下文连贯。

权限设置

ClawdBot 可以执行文件编辑和终端命令。你可以控制它的权限：

文件编辑权限

• 默认模式：每次编辑前都会询问确认
• 自动模式：信任 ClawdBot 的编辑（使用 --auto-edit 标志）

命令执行权限

• 安全模式：只允许执行白名单命令
• 完全模式：允许执行任何命令（需确认）

建议新用户使用默认的安全设置，熟悉后再逐步放宽。

常用命令

以下是 ClawdBot 中的常用命令和快捷键：