open-index/open-npm huggingface dataset:
npm package: @ia-ccun/code-agent-claw
Description: Code Agent Claw WebUI - Node.js implementation with frontend configuration
Author: xujianjiang
Latest version: 0.0.6

# Code Agent Claw WebUI

可视化界面，让你可以用浏览器配置和管理 Code Agent。

## 什么是 Code Agent Claw WebUI

这是一个运行在浏览器中的可视化控制台，用于：
- **配置 Agent**：设置模型、提供商、工作目录等参数
- **发送指令**：通过图形界面发送提示、引导或后续消息
- **实时交互**：查看 Agent 的实时响应和状态
- **会话管理**：创建和管理多个对话会话

## 安装步骤

### 1. 安装 Node.js

确保你的系统已安装 Node.js 20.0 或更高版本：

```bash
node --version
```

如未安装，请访问 [nodejs.org](https://nodejs.org/) 下载安装。

### 2. 全局安装

```bash
npm i -g @ia-ccun/code-agent-claw
```

### 3. 启动服务

```bash
# 默认端口 8081
aicode-claw

# 自定义端口
aicode-claw -p 8082
aicode-claw --port 9999
```

启动成功后，终端会显示：

```
Server started: http://localhost:8081
WebUI:          http://localhost:8081/index.html
```

### 4. 打开浏览器访问

在浏览器中打开 http://localhost:8081 即可看到控制台界面。

## 首次配置

首次使用时，需要完成以下配置：

### 配置说明

> 💡 **提示**：Provider 和 Model 的可用选项可以参考 `~/.aicode-cli/agent/models.json` 文件。

| 配置项 | 说明 | 示例值 |
|--------|------|--------|
| **Command** | aicode 命令的路径 | `aicode` 或完整路径 |
| **Provider** | LLM 服务提供商 | `minimax-custom` |
| **Model** | 使用的模型名称 | `MiniMax-M2.5` |
| **Working Dir** | Agent 工作目录 | `~/.aicode-cli` |
| **Session Dir** | 会话保存目录 | `~/.aicode-cli/agent/sessions` |

### 配置步骤

1. 在 Web 界面左侧的「配置面板」中填写上述信息
2. 点击「初始化」按钮
3. 等待 Agent 启动，状态指示器变绿即表示成功

## 使用指南

### 发送提示

在底部输入框中输入你的问题或指令，点击发送或按 Enter 提交。Agent 会实时返回响应。

### 使用引导消息

点击「Steer」按钮发送引导消息，用于调整 Agent 的行为或方向。

### 后续对话

在对话过程中，可以使用「Follow Up」发送后续补充信息。

### 中止操作

如果 Agent 响应时间过长，点击「Abort」按钮中止当前操作。

### 创建新会话

点击「New Session」创建全新对话，会清除当前上下文。

## 常见问题

**Q: 启动后提示 "aicode command not found"**

A: 确保已将 aicode CLI 安装到系统路径中，或在配置中填写完整路径。

**Q: 状态一直显示 "未连接"**

A: 检查配置是否正确填写，然后点击「初始化」按钮启动 Agent。

**Q: 如何修改端口号？**

A: 可以通过环境变量 `AICODE_UI_PORT` 修改，或直接修改 `config/default.json`。

## 技术支持

如遇问题，可查看终端日志获取详细错误信息。