Mr.Nine 的技术笔记

Appearance

常用配置 ​

⚠️ 前置条件 ​

在进行配置之前，请确保：

  • 已安装 Claude Code（未安装？请先查看 安装与准备）
  • 已完成账号认证
  • 了解基本的 JSON 格式

配置文件位置

配置文件位于 ~/.claude/settings.json，可以直接编辑此文件。

配置文件位置 ​

文件说明
~/.claude/settings.json全局用户设置
项目目录/CLAUDE.md项目级指令
~/.claude/CLAUDE.md全局指令

配置优先级 ​

Claude Code 的配置遵循 就近覆盖 原则，优先级从高到低：

优先级来源说明
1（最高）项目级 CLAUDE.md仅对当前项目生效，覆盖全局设置
2全局 ~/.claude/CLAUDE.md对所有项目生效的指令
3（最低）全局 ~/.claude/settings.json基础配置（环境变量、权限、模型等）

覆盖规则

  • settings.json 提供基础环境配置（API 密钥、权限、模型选择等）
  • CLAUDE.md 提供行为指令（编码规范、工作流、输出风格等）
  • 项目级 CLAUDE.md 可覆盖全局 CLAUDE.md 中的同类指令

最小可用配置 ​

刚安装完成？只需配置以下两项即可开始使用：

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxx",
    "ANTHROPIC_BASE_URL": "http://your-proxy-server:port"
  },
  "language": "简体中文"
}
字段说明
ANTHROPIC_AUTH_TOKENAPI 密钥，必填
ANTHROPIC_BASE_URLAPI 代理地址，使用中转服务时设置（直连可省略）
language响应语言，推荐设为 简体中文

完整配置示例 ​

json
{
  "attribution": {
    "commit": "",
    "pr": ""
  },
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxx",
    "ANTHROPIC_BASE_URL": "http://your-proxy-server:port",
    "BASH_DEFAULT_TIMEOUT_MS": "600000",
    "BASH_MAX_TIMEOUT_MS": "3600000",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "90",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
    "CODEAGENT_POST_MESSAGE_DELAY": "1",
    "CODEX_TIMEOUT": "7200",
    "DISABLE_INSTALLATION_CHECKS": "1",
    "MAX_THINKING_TOKENS": "31999"
  },
  "language": "简体中文",
  "model": "opus",
  "permissions": {
    "allow": [
      "Bash",
      "BashOutput",
      "Edit",
      "Glob",
      "Grep",
      "KillShell",
      "NotebookEdit",
      "Read",
      "SlashCommand",
      "Task",
      "TodoWrite",
      "WebFetch",
      "WebSearch",
      "Write",
      "mcp__ace-tool",
      "mcp__contextweaver",
      "mcp__context7",
      "mcp__deepwiki",
      "mcp__tavily",
      "mcp__exa",
      "mcp__figma",
      "mcp__mastergo",
      "mcp__pencil",
      "mcp__playwright",
      "mcp__chrome-devtools"
    ]
  },
  "statusLine": {
    "command": "ccline",
    "padding": 0,
    "type": "command"
  }
}

statusLine 配置

statusLine 用于自定义状态栏显示，详见 安装与准备 - CCometixLine。

配置项详解 ​

attribution - 署名 ​

Git 提交和 PR 的署名配置：

字段说明
commitGit commit 消息中的署名
prPull Request 描述中的署名

留空则不添加署名。

env - 环境变量 ​

官方配置 ​

变量说明
ANTHROPIC_AUTH_TOKENAPI 密钥，用于认证
ANTHROPIC_BASE_URLAPI 代理地址，使用中转服务时设置
BASH_DEFAULT_TIMEOUT_MSBash 命令默认超时时间（毫秒），默认 600000（10分钟）
BASH_MAX_TIMEOUT_MSBash 命令最大超时时间（毫秒），默认 3600000（60分钟）
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE自动压缩上下文的阈值百分比，设为 90 表示使用 90% 时触发
CLAUDE_CODE_ATTRIBUTION_HEADER设为 0 禁用署名头部信息
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC设为 1 禁用非必要网络请求（遥测等）
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS设为 1 启用实验性 Agent Teams 功能（多智能体协作）
DISABLE_INSTALLATION_CHECKS设为 1 跳过安装检查，加快启动速度
MAX_THINKING_TOKENS最大思考 Token 数，影响深度推理能力

第三方扩展（CCG 相关） ​

变量说明
CODEAGENT_POST_MESSAGE_DELAY多模型协作时消息发送延迟（秒），避免并发冲突
CODEX_TIMEOUTCodex CLI 超时时间（秒），默认 7200（2小时）

language - 语言 ​

设置 Claude 响应的语言，如 简体中文、English。

model - 模型 ​

指定默认使用的模型：

值模型
opusClaude Opus（最强）
sonnetClaude Sonnet（平衡）
haikuClaude Haiku（快速）

permissions - 权限 ​

预授权工具列表，避免每次使用时询问确认：

权限说明
Bash执行 Shell 命令
BashOutput读取 Shell 命令输出
Edit编辑文件
Glob文件模式匹配
Grep内容搜索
KillShell终止 Shell 进程
NotebookEdit编辑 Jupyter Notebook
Read读取文件
SlashCommand执行斜杠命令
Task启动子任务
TodoWrite写入待办事项
WebFetch获取网页内容
WebSearch网络搜索
Write写入文件
mcp__<server>允许指定 MCP 服务器的所有工具

常用 MCP 服务器权限：

权限说明
mcp__ace-toolAugment 代码上下文引擎
mcp__contextweaver上下文编织工具
mcp__context7库文档查询
mcp__deepwiki开源项目文档
mcp__tavily网络搜索与内容提取
mcp__exa语义搜索引擎
mcp__figmaFigma 设计稿读取
mcp__mastergoMasterGo 设计稿读取
mcp__pencil绘图工具
mcp__playwright浏览器自动化测试
mcp__chrome-devtoolsChrome 开发者工具

MCP 权限配置

mcp__* 通配符不生效，需逐个指定 MCP 服务器名称。

下一步 ​

配置完成后，可以继续了解更多功能：