更新日期：2026 年 3 月 7 日

Hajimi Code 配置参考

面向“AI 编码助手怎么配置”搜索意图，集中展示字段表、环境变量和目录结构，适合快速对照排错。

config.toml 字段说明

全局配置文件在 ~/.hajimi/config.toml，项目级覆盖文件在 .hajimi/config.toml。

分区说明—常用项在 [general] 与 [agent]；扩展能力分别在 [mcp] 与 [hooks]。

字段	类型	默认值	说明
`general.approval_mode`	string	`"default"`	审批模式：default / auto_edit / yolo
`general.log_level`	string	`"info"`	日志级别：error / warn / info / debug / trace
`general.max_steps`	number	`300`	代理最大执行步数
`general.log_retention_days`	number	`7`	日志保留天数
`general.max_context_tokens`	number	`0 (=200000)`	上下文窗口大小（0 表示使用默认 200000）
`general.max_output_tokens`	number	`8000`	单次最大输出 Token 数
`agent.custom_prompt_file`	string	`—`	自定义系统提示词文件路径
`agent.max_concurrent_subagents`	number	`—`	最大并发子代理数
`agent.compaction_model`	string	`—`	上下文压缩使用的模型角色或 model id（如 fast / pro）
`hooks.hooks`	array	`[]`	Hook 列表（before_tool / after_tool / before_model / after_model 等）
`mcp.servers`	array	`[]`	MCP 服务器列表（name / command / args / env）

HAJIMI.md（自定义指令）

创建 HAJIMI.md 文件写入偏好指令，AI 会在每次对话中自动参考。

# ~/.hajimi/HAJIMI.md（全局）或 .hajimi/HAJIMI.md（项目级）

- 回复使用中文
- 代码风格偏好函数式编程
- 使用 pnpm 而不是 npm
- 提交信息使用英文

加载优先级—项目级 .hajimi/HAJIMI.md → 全局 ~/.hajimi/HAJIMI.md → custom_prompt_file 指定的文件。

环境变量

环境变量的优先级高于配置文件，适合在 CI/CD 或临时场景中覆盖参数：

环境变量	说明
`HAJIMI_APPROVAL_MODE`	覆盖审批模式（default / auto_edit / yolo）
`HAJIMI_LOG`	覆盖日志级别
`HAJIMI_MAX_STEPS`	覆盖最大步数
`HAJIMI_MAX_CONTEXT_TOKENS`	覆盖上下文 Token 上限
`HAJIMI_MAX_OUTPUT_TOKENS`	覆盖输出 Token 上限
`HAJIMI_HOME`	覆盖配置与会话数据根目录（默认 ~/.hajimi）
`HAJIMI_LLM_REQUEST_LOG_DIR`	覆盖原始 LLM 请求日志目录
`HAJIMI_MASTER_KEY / HAJIMI_MASTER_KEY_FILE`	覆盖 API Key 加密主密钥来源（高级）
`OPENAI_API_KEY / OPENAI_BASE_URL / OPENAI_MODEL`	自动创建 OpenAI 环境供应商（OpenAI Response 共用这组变量）
`ANTHROPIC_AUTH_TOKEN / ANTHROPIC_BASE_URL / ANTHROPIC_MODEL`	自动创建 Anthropic 环境供应商
`GEMINI_API_KEY / GEMINI_MODEL / GEMINI_BASE_URL`	自动创建 Gemini 环境供应商（GEMINI_BASE_URL 可选）

配置优先级—内置默认 → 全局 config.toml → 项目 config.toml → 环境变量 → CLI 参数

目录结构一览

~/.hajimi/
├── config.toml              # 全局配置
├── HAJIMI.md                # 全局自定义指令
├── channels.toml            # 渠道桥接配置
├── skills.json              # 技能启用/禁用状态
├── settings/
│   ├── providers.toml       # API 供应商配置
│   └── active.toml          # 角色模型绑定
├── commands/                # 全局自定义命令
│   └── my-command.md
├── skills/                  # 全局技能
│   └── my-skill/
│       └── SKILL.md
├── sessions/                # 会话数据
│   └── <session-id>/
│       ├── state.json
│       └── messages.jsonl
└── memory/                  # 项目记忆
    └── <project-hash>/
        └── memory.md