命令

Hawa Code 提供了丰富的命令行接口，支持交互式会话、配置管理、MCP 服务器管理等功能。

基本用法

hcode [prompt] [options]

默认情况下，不带任何子命令启动会进入交互式会话模式。

全局选项

选项	说明
-c, --cwd <cwd>	设置当前工作目录
-d, --debug	启用调试模式
--verbose	启用详细输出模式
-ea, --enable-architect	启用 Architect 工具
-p, --print	打印响应后退出（适合管道使用）
--dangerously-skip-permissions	跳过所有权限检查（仅限无网络访问的 Docker 容器）
-v, --version	显示版本号

示例

# 启动交互式会话
hcode

# 直接执行提示
hcode "分析当前目录的代码结构"

# 管道输入
echo "优化这段代码" | hcode -p

# 指定工作目录
hcode -c /path/to/project "解释这段代码"

---

配置管理 (config)

管理 Hawa Code 的配置项。

hcode config <subcommand>

子命令

get <key>

获取配置值。

hcode config get theme
hcode config get theme -g  # 获取全局配置

选项：

• -g, --global - 使用全局配置

set <key> <value>

设置配置值。

hcode config set theme dark
hcode config set theme dark -g  # 设置全局配置

选项：

• -g, --global - 使用全局配置

remove <key>

删除配置项。

hcode config remove theme

选项：

• -g, --global - 使用全局配置

list

列出所有配置值。

hcode config list
hcode config list -g  # 列出全局配置

选项：

• -g, --global - 使用全局配置

---

已批准工具管理 (approved-tools)

管理已批准使用的工具列表。

hcode approved-tools <subcommand>

子命令

list

列出所有已批准的工具。

hcode approved-tools list

remove <tool>

从已批准列表中移除指定工具。

hcode approved-tools remove BashTool

---

MCP 服务器管理 (mcp)

配置和管理 MCP (Model Context Protocol) 服务器。

hcode mcp <subcommand>

子命令

serve

启动 Hawa Code MCP 服务器。

hcode mcp serve

add <name> <command> [args...]

添加一个 stdio 类型的 MCP 服务器。

# 添加 npx 服务器
hcode mcp add my-server npx -y @modelcontextprotocol/server-filesystem /path/to/files

# 添加带环境变量的服务器
hcode mcp add my-server node server.js -e API_KEY=secret -e PORT=3000

选项：

• -s, --scope <scope> - 配置范围（project 或 global），默认 project
• -e, --env <env...> - 设置环境变量（如 -e KEY=value）

add-sse <name> <url>

添加一个 SSE 类型的 MCP 服务器（需要特定权限）。

hcode mcp add-sse my-server http://localhost:3000/sse

选项：

• -s, --scope <scope> - 配置范围（project 或 global），默认 project

remove <name>

移除 MCP 服务器。

hcode mcp remove my-server

选项：

• -s, --scope <scope> - 配置范围（project、global 或 mcprc），默认 project

list

列出所有配置的 MCP 服务器。

hcode mcp list

get <name>

获取指定 MCP 服务器的详细信息。

hcode mcp get my-server

reset-mcprc-choices

重置所有 .mcp.json 服务器的批准/拒绝状态（需要特定权限）。

hcode mcp reset-mcprc-choices

---

更新 (update)

检查并安装更新。

hcode update

此命令会：

1. 检查最新版本
2. 如果有新版本，自动下载并安装
3. 显示更新结果