跳到主要内容
Hajimi logo
Hajimi

更新日期：2026 年 3 月 7 日

Hajimi Code 使用文档

本文档面向“AI 编码助手 CLI 怎么用”搜索需求，覆盖安装教程、命令参数、自动改代码流程、run --json 集成与审批策略。当前文档按 v0.3.18 编写（可用 hajimi version 核对本机版本）。

概览

Hajimi Code 提供四种使用方式，你可以根据场景灵活选择：

交互对话（REPL）

输入 hajimi 进入持续任务模式，通过目标驱动 Agent 执行。支持上下文记忆、命令补全和会话恢复。

一次性执行（run）

使用 hajimi run 执行单次任务，完成即退出。支持 JSON 输出，适合脚本和 CI/CD。

Web 界面（web）

使用 hajimi web 启动本地 Web 服务，通过浏览器与 AI 交互，支持审批确认和会话管理。

渠道桥接（channel）

通过 hajimi channel 将 AI 接入 Telegram、Discord、Slack、Mattermost 或飞书。

4

种模型协议

OpenAI · Anthropic · Gemini · OpenAI Response

8

个内置命令

/commit · /review · /fix · /explain …

5

个渠道平台

Telegram · Discord · Slack · Mattermost · 飞书

安装与启动

  1. 1) 通过 Homebrew 安装（推荐）

    macOS 和 Linux 用户推荐使用 Homebrew 一键安装：

    brew tap hajimi-work/tap brew install hajimi

    安装完成后，可以使用 hajimi 或简写 ha 来调用。

  2. 2) 手动下载安装

    前往 Releases 页面 下载对应平台的二进制文件，解压后放入 PATH 目录即可。

  3. 3) 首次运行配置

    首次运行会自动启动配置向导：

    hajimi # 按提示选择 API 协议（OpenAI / Anthropic / OpenAI Response / Gemini） # 输入你的 API Key 和 Base URL # 选择默认模型

    配置完成后即可开始使用。后续可通过 hajimi config 随时修改。

  4. 4) 验证安装

    hajimi version hajimi run 你好，请做个自我介绍
环境变量快速配置—如果你已有 API Key，可以通过环境变量跳过向导：例如 OPENAI_API_KEY（OpenAI / OpenAI Response）或ANTHROPIC_AUTH_TOKEN（Anthropic），Hajimi 会自动识别并创建供应商。

命令参考

为了减少主文档的首屏体积，完整命令表已拆分到独立子页。你可以按需查看：

为什么这样调整—主文档保留流程说明和关键概念，超长表格放到独立页面，首屏加载更快，目录跳转也更稳定。

展开查看本章节详细内容。

展开查看本章节详细内容。

展开查看本章节详细内容。

展开查看本章节详细内容。

展开查看本章节详细内容。

展开查看本章节详细内容。

连接 Telegram、Discord、Slack、Mattermost、飞书等平台，让团队在群聊中直接调用 Hajimi。

展开查看本章节详细内容。

展开查看本章节详细内容。

展开查看本章节详细内容。

展开查看本章节详细内容。

展开查看本章节详细内容。

展开查看本章节详细内容。

展开查看本章节详细内容。

展开查看本章节详细内容。