Code Agent Claw WebUI

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

什么是 Code Agent Claw WebUI

这是一个运行在浏览器中的可视化控制台，用于：

• 配置 Agent：设置模型、提供商、工作目录等参数
• 发送指令：通过图形界面发送提示、引导或后续消息
• 实时交互：查看 Agent 的实时响应和状态
• 会话管理：创建和管理多个对话会话

安装步骤

1. 安装 Node.js

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

node --version

如未安装，请访问 nodejs.org 下载安装。

2. 全局安装

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

3. 启动服务

# 默认端口 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。

技术支持

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