编码器配置

AI编码工具的配置管理器。适用于Claude Code、Gemini CLI、Codex CLI和Antigravity。

迁移说明： 此包已从重命名 @regression-io/claude-config 到 coder-configThe claude-config 命令仍然可以作为别名使用。

问题

AI编码助手功能强大，但跨项目管理其配置是乏味的。每个工具都有自己的配置格式。每个项目都需要设置MCP服务器。会话之间上下文丢失。跨多个仓库工作意味着每次都要重新解释关系。

Coder Config的功能是什么

工作流 将相关的repos分组在一起。当工作流处于活动状态时，Claude会自动知道它可以访问哪些目录，并接收您的自定义上下文。适用于微服务、单仓库或任何项目相互关联的多仓库工作流。

统一MCP注册表 在全局注册表中定义一次MCP服务器。通过切换为每个项目启用它们。配置继承自全局→ 工作区→ 项目，因此通用工具始终可用，而特定于项目的工具则保持作用域。

层次规则 规则从以下位置级联 ~/.claude/rules/ 具体到项目规则。全球公约适用于所有地方；项目具体说明保持本地化。

持久性内存 存储跨会话持续存在的首选项、更正和模式。当你告诉Claude“始终使用我们的记录器而不是console.log”时，它会记住——不仅是为了这个会话，而且是永久的。

插件系统 从插件市场安装LSP服务器、MCP工具和自定义命令。插件的作用域可以是全局的，也可以是每个项目的。

多工具输出 编写一个配置，为Claude代码生成输出(.mcp.json)，Gemini CLI(settings.json)，Codex CLI(config.toml)以及反重力。无需重新配置即可切换工具。

Web用户界面 用于管理上述所有内容的可视化界面。文件资源管理器 .claude 文件夹、MCP开关、内存编辑器、工作流管理。在3333端口本地运行。

安装

npm install -g coder-config

需要Node.js 18+。

从@regression-io/claude配置迁移？ ``bash npm uninstall -g @regression-io/claude-config npm install -g coder-config ` 您在中的设置 ~/.claude-config/` 自动保存。

快速开始

# 1. Install
npm install -g coder-config

# 2. Set up auto-start (recommended)
coder-config ui install

# 3. Open the UI
open http://localhost:3333

服务器在登录时自动启动。从浏览器安装为PWA，以便进行类似应用程序的访问。

更新

coder-config update
# Then restart: coder-config ui stop && coder-config ui

CLI替代方案

# Initialize a project
coder-config init

# Add MCPs to your project
coder-config add postgres github

# Generate .mcp.json for Claude Code
coder-config apply

CLI命令

两者 coder-config 和 claude-config 工作一样。

项目命令

coder-config init                        # Initialize project
coder-config apply                       # Generate .mcp.json from config
coder-config show                        # Show current project config
coder-config list                        # List available MCPs (✓ = active)
coder-config add  [mcp...]          # Add MCP(s) to project
coder-config remove  [mcp...]       # Remove MCP(s) from project

内存命令

coder-config memory                         # Show memory status
coder-config memory init                    # Initialize project memory
coder-config memory add  ""  # Add entry
coder-config memory search           # Search all memory

# Types: preference, correction, fact (global)
#        context, pattern, decision, issue, history (project)

环境命令

coder-config env                    # List environment variables
coder-config env set    # Set variable in .claude/.env
coder-config env unset         # Remove variable

项目命令

coder-config project                      # List registered projects
coder-config project add [path]           # Add project (defaults to cwd)
coder-config project add [path] --name X  # Add with custom display name
coder-config project remove    # Remove from registry

工作流命令

coder-config workstream                   # List all workstreams
coder-config workstream create "Name"     # Create new workstream
coder-config workstream delete      # Delete workstream
coder-config workstream use         # Activate workstream (this terminal)
coder-config workstream active            # Show current active workstream
coder-config workstream deactivate        # Deactivate workstream (this terminal)
coder-config workstream add  
   # Add project to workstream
coder-config workstream remove  
  # Remove project from workstream
coder-config workstream inject [--silent] # Output restriction + context (for hooks)
coder-config workstream detect [path]     # Detect workstream for directory
coder-config workstream check-path 
 # Check if path is within workstream (exit 0/1)
coder-config workstream install-hook      # Install hook for Claude Code
coder-config workstream install-hook --gemini  # Install hook for Gemini CLI
coder-config workstream install-hook --codex   # Install hook for Codex CLI
coder-config workstream install-hook --all     # Install hooks for all supported tools

# Folder auto-activation
coder-config workstream add-trigger    # Add trigger folder
coder-config workstream remove-trigger    # Remove trigger folder
coder-config workstream auto-activate  [on|off|default]  # Set auto-activate
coder-config workstream check-folder [path] [--json]  # Check folder for matches
coder-config workstream install-cd-hook    # Install cd hook for shell
coder-config workstream uninstall-cd-hook  # Remove cd hook
coder-config workstream cd-hook-status     # Check cd hook status

每端子隔离：与 Shell 集成，每个终端都可以有自己的活动工作流：

# Terminal 1
coder-config workstream use project-a

# Terminal 2
coder-config workstream use project-b

当AI处于活动状态时，它会收到一个限制，告诉它只能在工作流的目录中工作。

多工具支持：工作流与Claude Code、Gemini CLI和Codex CLI配合使用。为您喜欢的工具安装挂钩：

# For Claude Code only
coder-config workstream install-hook

# For Gemini CLI only
coder-config workstream install-hook --gemini

# For Codex CLI only
coder-config workstream install-hook --codex

# For all supported tools
coder-config workstream install-hook --all

文件夹自动激活：当您cd到匹配的目录时，自动激活工作流：

# Install the cd hook (adds function to ~/.zshrc or ~/.bashrc)
coder-config workstream install-cd-hook

# Now when you cd into a project folder:
cd ~/projects/my-app  # Auto-activates matching workstream
# Output: 📂 Workstream: My App

# If multiple workstreams match, you'll be prompted:
cd ~/projects
# Output: Multiple workstreams match this folder:
#   1) Frontend
#   2) Backend
#   0) Skip
# Choose [0-2]:

触发器文件夹：除了项目路径，您还可以添加额外的触发器文件夹：

coder-config workstream add-trigger "My Work" ~/projects
coder-config workstream remove-trigger "My Work" ~/projects

自动激活设置：按工作流或全局控制：

coder-config workstream auto-activate "My Work" on      # Always auto-activate
coder-config workstream auto-activate "My Work" off     # Never auto-activate
coder-config workstream auto-activate "My Work" default # Use global setting

注册表命令

coder-config registry                       # List MCPs in global registry
coder-config registry add  ''   # Add MCP to global registry
coder-config registry remove          # Remove MCP from registry

更新

coder-config update             # Check npm and install updates if available
coder-config update --check     # Check for updates without installing
coder-config update /path/src   # Update from local development source

UI会自动检查更新，并在“首选项”中启用自动更新。服务器更新后，UI会自动刷新以加载新版本。

Web用户界面

coder-config ui                    # Start UI on port 3333
coder-config ui --port 8080        # Custom port
coder-config ui /path/to/project   # Specific project directory
coder-config ui --foreground       # Run in foreground (blocking)
coder-config ui status             # Check if daemon is running
coder-config ui stop               # Stop the daemon

# Auto-start on login (macOS)
coder-config ui install            # Install LaunchAgent for auto-start
coder-config ui uninstall          # Remove auto-start

守护程序模式：默认情况下， coder-config ui 作为后台守护进程运行。 UI从您的主目录运行，并在终端会话中持续存在。使用标题中的下拉菜单在已注册的项目之间切换。

PWA/自动启动：将UI作为PWA安装在浏览器中，然后运行 coder-config ui install 让服务器在登录时自动启动。您的PWA将始终立即连接。

壳牌集成

要获得完整功能，请添加 ~/.zshrc:

source /path/to/coder-config/shell/claude-config.zsh

这使得：

每个终端工作流 - workstream use 仅对当前终端激活
自动生成 .mcp.json 当进入一个项目时 .claude/mcps.json
所有命令的选项卡完成

配置层次结构

设置从全局合并到项目再到子项目：

~/.claude/mcps.json                    # Global - applies everywhere
~/projects/.claude/mcps.json           # Workspace - applies to projects here
~/projects/my-app/.claude/             # Project - specific to this project
~/projects/my-app/server/.claude/      # Sub-project - inherits from parent

自动检测子项目（包含 .git)，或者您可以使用Web UI中的“添加子项目”手动链接任何文件夹。

项目结构

之后 coder-config init:

your-project/
├── .claude/
│   ├── mcps.json       # MCP configuration
│   ├── settings.json   # Claude Code settings
│   ├── rules/          # Project rules (*.md)
│   └── commands/       # Custom commands (*.md)
└── .mcp.json           # Generated - Claude Code reads this

MCP配置

.claude/mcps.json:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

环境变量使用 ${VAR} 语法和从加载 .claude/.env.

记忆系统

Claude Code会话的持久内存。

全球 (~/.claude/memory/)

文件	目的
`preferences.md`	用户偏好和风格
`corrections.md`	要避免的错误
`facts.md`	环境事实

项目 ( /.claude/memory/)

文件	目的
`context.md`	项目概况
`patterns.md`	代码模式
`decisions.md`	架构决策
`issues.md`	已知问题
`history.md`	会话历史记录

通过Web UI进行管理或直接编辑文件。

会话保持

保存Claude Code会话中的上下文，并在下一个会话启动时还原它。

运作原理

保存上下文 -使用 /flush 在Claude Code中编写上下文摘要
自动恢复 -The session-start 钩子将保存的上下文注入到下一个会话中

每个项目的上下文存储在 .claude/session-context.md.

设置

从UI： 首选 系统>会话 然后单击“全部安装”

从CLI：

coder-config session install

这将安装SessionStart钩子和 /flush 命令。

CLI命令

coder-config session           # Show session status
coder-config session install   # Install hooks and /flush command
coder-config session clear     # Clear saved context

存储位置

会话上下文存储在每个项目中 .claude/session-context.md.

工作流

工作流是 上下文集 用于多项目工作流。他们将相关项目分组，并将上下文规则注入到每个Claude会话中。

为什么选择工作流？

在处理跨越多个repos的复杂功能（例如REST API+UI+共享库）时，您需要Claude来理解更广泛的上下文。工作流通过以下方式解决此问题：

将相关项目分组在一起
定义特定于该工作流的规则
自动将这些规则注入到每个Claude会话中

示例

# Create a workstream for user authentication feature
coder-config workstream create "User Auth"

# Add related projects
coder-config workstream add "User Auth" ~/projects/api
coder-config workstream add "User Auth" ~/projects/ui
coder-config workstream add "User Auth" ~/projects/shared

# Activate it
coder-config workstream use "User Auth"

然后在Web UI中，编辑工作流以添加以下规则：

关注用户身份验证流程。使用JWT令牌。React Query用于状态管理。PostgreSQL用于持久性。

挂钩集成

要自动注入规则，请安装预提示钩子：

选项1：一键安装（推荐）

打开Web UI→ 工作流→ 点击“自动安装挂钩”

选项2：手动

# Add to ~/.claude/hooks/pre-prompt.sh
coder-config workstream inject --silent

安装后，您的活动工作流规则将预先添加到每个Claude会话中。

活动跟踪和建议

Coder配置可以跟踪您处理的文件，并根据模式建议工作流：

它是如何工作的：

响应后钩子记录Claude会话期间访问的文件路径
检测到共同活动模式（经常一起工作的项目）
工作流建议基于这些模式出现在UI中

设置（可选）：

# Install the activity tracking hook
# Add to ~/.claude/hooks/post-response.sh:
source /path/to/coder-config/hooks/activity-track.sh

在Web UI中：

Activity Insights面板显示会话、跟踪的文件和活动项目
检测到模式时，会显示建议的工作流
点击“创建”打开预填充对话框（根据需要调整项目）
单击“X”可忽略您不想要的建议

Web UI功能

特性	描述
工程资源管理器	浏览和编辑 `.claude/` 项目层次结构中的文件夹
Claude代码设置	权限、模型、钩子和行为的可视化编辑器
Gemini CLI设置	配置模型、显示选项和沙盒模式
Codex CLI设置	配置型号、安全性、MCP服务器和功能
反重力设置	配置安全策略、浏览器分配列表和代理模式
MCP注册表	搜索GitHub/npm，添加和配置MCP服务器
插件	浏览市场，安装具有范围控制的插件
记忆	管理偏好、更正、模式和决策
工作流	使用共享上下文规则对相关项目进行分组

附加功能：标题中的项目/工作流切换器、子项目检测、暗模式、自动更新。

插件

Claude Code插件扩展了LSP服务器、MCP服务器、命令和始终在线指导的功能。 插件替换模板 -插件始终处于活动状态并自动更新，而不是可能过时的静态文件。

为什么插件胜过模板？

特性	插件
交付	启用插件一次
更新	从市场自动刷新
新鲜度	始终保持最新
范围	全球、项目或本地
发现	浏览市场

安装插件

从CLI：

# Add the coder-config plugins marketplace
claude plugin marketplace add regression-io/claude-config-plugins

# Install framework-specific plugins
claude plugin install fastapi-support@claude-config-plugins
claude plugin install react-typescript@claude-config-plugins
claude plugin install python-support@claude-config-plugins

从Web UI：

打开项目资源管理器
点击 + 任何项目文件夹上的菜单
选择 安装插件
通过作用域选择（本地/用户）打开/关闭插件

插件目录

这插件页面显示所有可用插件：

按市场、类别、来源类型（人类/社区）、安装状态过滤
按名称或描述搜索
查看插件详细信息（包括LSP/MCP/命令）

市场

插件来自市场（Git仓库）：

claude插件官方 -Anthropic的官方插件
回归io/claude配置插件 -框架和语言插件
通过过滤器下拉菜单中的“管理市场”添加社区市场

支持的市场格式：

owner/repo --GitHub简写
https://github.com/owner/repo --完整URL
/local/path --本地目录

Claude代码设置

Web UI提供了一个可视化编辑器 ~/.claude/settings.json:

权限

配置Claude Code可以自动执行的操作：

允许 -无需询问即可运行的工具
问 -需要确认的工具
拒绝 -被阻止的工具

模式示例：

Bash(npm run build)      # Specific command
Bash(npm:*)              # Prefix match (npm anything)
Read(**)                 # All file reads
Edit(src/**)             # Edit files in src/
mcp__github__*           # All GitHub MCP tools

模型选择

选择您喜欢的克劳德模型（作品4.6、十四行诗4.6、俳句4.5）和努力程度（低/中/高）。

行为

展示思考总结
语音听写
自动记忆
启用所有项目MCP服务器
输出样式，默认shell，CLAUDE.md除外

Gemini CLI设置

Web UI提供了一个可视化编辑器 ~/.gemini/settings.json:

模型选择

选择Gemini型号（自动、Gemini 3.1 Pro、3 Flash、2.5 Pro等）。

显示选项

配置主题、令牌计数显示、差异视图和流媒体。

通用设置

Vim键绑定
自动保存
检查更新

沙盒模式

控制命令执行安全（启用/禁用）。

Codex CLI设置

Web UI提供了一个可视化编辑器 ~/.codex/config.toml:

模型设置

模型 -选择GPT-5.2 Codex、GPT-5、o3 mini等。
推理努力 -控制彻底性（最小到x高）

安全

审批政策 -何时请求命令批准（根据请求、不受信任、失败、从不）
沙盒模式 -文件系统访问级别（只读、工作区写入、完全访问）

MCP服务器

使用与其他工具相同的格式为Codex CLI配置MCP服务器。

特性

切换shell快照和web搜索等功能标志。

显示和历史记录

配置TUI动画、通知和会话历史持久性。

有关完整的配置选项，请参阅 Codex CLI文档.

反重力设置

Web UI提供了一个可视化编辑器 ~/.gemini/antigravity/settings.json:

安全策略

策略	选项
终端执行	关闭、自动、涡轮
代码审查	启用、禁用
JS执行	沙盒，直接

MCP服务器

为反重力配置MCP服务器。注意：反重力不支持 ${VAR} 插值-变量被解析为实际值。

浏览器列表

控制Antigravity在会话期间可以访问哪些URL。

代理模式

配置自主多步操作、迭代限制和确认要求。

偏好

用户设置存储在 ~/.claude-config/config.json:

{
  "toolsDir": "~/mcp-tools",
  "registryPath": "~/.claude/registry.json",
  "ui": {
    "port": 3333,
    "openBrowser": true
  }
}

密钥	描述
`toolsDir`	本地MCP工具目录
`registryPath`	自定义MCP注册表的路径
`ui.port`	web UI的默认端口
`ui.openBrowser`	自动打开浏览器 `coder-config ui`

拉尔夫循环（实验）

注： Ralph Loops是一个实验性功能，默认情况下处于禁用状态。在Web UI中启用它 首选项>实验功能.

Ralph Loops支持自主开发——Claude Code持续运行，直到任务完成。

coder-config loop                           # List all loops
coder-config loop create "Task description" # Create new loop
coder-config loop create "Task" --workstream   # Create loop in workstream context
coder-config loop start                 # Start/resume a loop
coder-config loop pause                 # Pause loop at next safe point
coder-config loop resume                # Resume paused loop
coder-config loop cancel                # Cancel loop
coder-config loop delete                # Delete loop and its data
coder-config loop approve               # Approve plan (when in plan phase)
coder-config loop complete              # Mark loop as complete
coder-config loop status [id]               # Show status (active loop if no id)
coder-config loop active                    # Show current active loop
coder-config loop history                   # Show completed loops
coder-config loop config                    # Show loop configuration
coder-config loop config --max-iterations 50    # Set max iterations
coder-config loop config --auto-approve-plan    # Skip manual plan approval

三阶段工作流程:

阐明 -Claude通过提问来理解需求
计划 -Claude创建实施计划（需要批准）
执行 -克劳德执行计划直到完成

运行循环:

export CODER_LOOP_ID=
claude --continue "Your task description"

安全机构:

迭代次数限制（默认值：50）
阶段闸门（手动计划审批）
超出限制时优雅地停顿

需求

Node.js 18+
构建工具（适用于没有预构建二进制文件的较新Node.js版本）：

- macOS：Xcode命令行工具(xcode-select --install) - Linux: build-essential 包裹 - 视窗：Visual Studio生成工具

发展

git clone https://github.com/regression-io/coder-config.git
cd coder-config
npm install
npm run build
npm start

测试

该项目具有全面的测试覆盖率，在18个测试文件中有608个测试：

# Run all tests
npm test

测试覆盖范围包括：

核心实用程序和配置管理
MCP注册表操作
内存和环境变量系统
项目初始化和注册表
配置生成和层次结构

看测试_验证.md 了解详细的覆盖范围信息。

许可证

麻省理工学院

Coder Config

快速接入

详细介绍

编码器配置

问题

Coder Config的功能是什么

安装

快速开始

更新

CLI替代方案

CLI命令

项目命令

内存命令

环境命令

项目命令

工作流命令

注册表命令

更新

Web用户界面

壳牌集成

配置层次结构

项目结构

MCP配置

记忆系统

会话保持

运作原理

设置

CLI命令

存储位置

工作流

为什么选择工作流？

示例

挂钩集成

活动跟踪和建议

Web UI功能

插件

为什么插件胜过模板？

安装插件

插件目录

市场

Claude代码设置

权限

模型选择

行为

Gemini CLI设置

模型选择

显示选项

通用设置

沙盒模式

Codex CLI设置

模型设置

安全

MCP服务器

特性

显示和历史记录

反重力设置

安全策略

MCP服务器

浏览器列表

代理模式

偏好

拉尔夫循环（实验）

需求

发展

测试

许可证

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP