Skip to content

DimCode在终端里 Plan · Agent · Debug

多模型代码智能体,内置会话、工具与安全审批。

DimCode 是面向开发者的多模型 CLI 编程 Agent,适合正在比较 Claude Code、Codex、OpenCode、Cursor 等常用工作流的团队。

快速开始

安装

bash
npm install -g dimcode
# pnpm add -g dimcode
# yarn global add dimcode
# bun add -g dimcode

运行

bash
dim
# or: npx dimcode

配置凭据

  • Ctrl+PConnect Provider(或输入 /connect),添加需要 API key 的提供方(OpenAI / OpenRouter 等)。

TUI 的第 1 分钟

  • Ctrl+P:命令面板(会话、设置、模型、审批、工具设置)。
  • /connect:连接提供方(也可添加自定义 / 本地提供方)。
  • /models:选择模型。
  • /approvals:设置工具审批(autoall)。
  • Shift+Enter:换行;Enter:发送;Ctrl+O:展开/折叠工具调用与思考。

数据存储位置

默认存放在 ~/.dimcode/

  • 配置:~/.dimcode/config.json
  • 会话/缓存:~/.dimcode/dimcode/cache.json
  • 状态存储:~/.dimcode/dimcode/state/

完整说明见:/zh/config

可通过以下变量调整位置:

  • DIMCODE_HOME(基础目录)
  • DIMCODE_STATE_DIR(状态目录)

可选集成

网页搜索(Serper)

WebSearch 需要 Serper API Key。可在 Tool SettingsCtrl+P → Tool Settings 或 /tool-settings)中配置。

MCP 服务器

MCP SettingsCtrl+P → MCP Settings 或 /mcp-settings)中配置。

常见用法

bash
# One-shot prompt (tools auto-approved)
dim exec "Review this repo and propose a refactor plan"

# Start local API server and open the web GUI
dim server --open

# Start GUI dev server (repo only, requires bun)
dim gui

# Editor integration (ACP)
dim acp

ACP 说明见:/zh/acp

需要帮助?

  • dim --help 查看命令与参数。
  • dim --debug 启用诊断,默认写入 ./dimcode-debug.log