CLI 设置

Amp settings.json 的位置与优先级，以及常用设置项：费用显示、Git 提交署名、技能路径、MCP 权限、工具禁用、更新模式等。

位置

用户设置：~/.config/amp/settings.json（或 .jsonc；Windows 为 %USERPROFILE%\.config\amp\）；
工作区设置：从当前目录向上到仓库根（非 Git 仓库则为当前目录）找到的最近的 .amp/settings.json；
自定义用户设置：--settings-file <path>。

amp config edit 在 $EDITOR 里打开用户设置，加 --workspace 则编辑工作区设置。同一设置出现在多处时，工作区设置覆盖用户设置。所有设置项都带 amp. 前缀；在文件里加上 "$schema": "https://ampcode.com/cli-settings.schema.json" 即可获得校验和补全。

常用设置

设置	说明
`amp.showCosts`（默认 true）	在 CLI 里显示线程费用
`amp.git.commit.ampThread.enabled`（默认 true）	提交里加 `Amp-Thread-ID` 尾注；也可用环境变量 `AMP_DISABLE_AMP_THREAD_TRAILER=1` 关闭
`amp.git.commit.coauthor.enabled`（默认 true）	提交里加 `Co-authored-by: Amp` 尾注；环境变量 `AMP_DISABLE_AMP_COAUTHOR_TRAILER=1`
`amp.keymap`	自定义 CLI 键位（用户设置覆盖工作区设置）
`amp.mcpServers` / `amp.mcpPermissions`	MCP 服务器和允许/拒绝规则
`amp.skills.path`	额外的技能目录（冒号分隔，Windows 用分号，相对路径按工作区根解析）
`amp.skills.disableClaudeCodeSkills` / `disableGlobalAgentsSkills`	跳过 Claude Code 目录或全局通用目录里的技能
`amp.tools.disable`	按名称禁用工具；`builtin:名称` 只禁用内置的，支持 `*` 通配
`amp.notifications.enabled`（默认 true）	任务完成或等待输入时播放提示音；SSH 下改发终端响铃
`amp.terminal.copyOnSelect`、`amp.terminal.detailsExpandedByDefault`	选中即复制；默认展开思考与工具调用细节
`amp.thread.autoArchiveOnQuit`	退出时自动归档打开的 CLI 线程
`amp.defaultVisibility`	按仓库来源设置线程默认可见性：`private`、`workspace`、`group`
`amp.updates.mode`（默认 `auto`）	`auto` 自动安装更新，`warn` 只提示，`disabled` 关闭检查（也可设 `AMP_SKIP_UPDATE_CHECK=1`）
`amp.fuzzy.alwaysIncludePaths`	即使被 Git 忽略也始终包含在 `@` 文件模糊搜索里的 glob
`amp.runner.*`、`amp.remoteThreadCreation.enabled`	runner 自动更新、注入环境变量；允许 ampcode.com 在本机 TUI 里创建线程

定价与额度（免费额度、按量计费、工作区方案）见官方 Pricing 页，以官方为准。