claude code 简单配置

教程
2025-12-26

claude code 简单配置

前置环境要求

在安装 Claude Code 之前，请确保已安装以下环境：

Node.js 环境


# 验证 Node.js 安装

node --version  # 建议 v20.0.0 或更高版本

npm --version

如未安装，请访问：https://nodejs.org/

Python 环境（用于部分 MCP 服务器）


# 验证 Python 安装

python --version  # 需要 Python 3.11 或更高版本

uv 工具（Python 包管理器）


# Windows 安装 uv

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# 验证安装

uvx --version

1. 安装Claude Code

全局安装


npm install -g @anthropic-ai/claude-code

验证是否安装成功：


claude --version

2. Claude Code 基础配置

配置文件位置：C:Usersyz.claudesettings.json（使用 ccw 命令或直接编辑文件）

2.1 环境变量配置（必须）


{

  "env": {

     "ANTHROPIC_AUTH_TOKEN": "sk-***",

     "ANTHROPIC_BASE_URL": "https://***.com",

     "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-5",

     "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-5",

     "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5",

     "ANTHROPIC_MODEL": "claude-sonnet-4-5",

     "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"

  }

}

关键配置说明

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"（强烈推荐）

禁用非必要网络请求，包括：

  • 遥测数据上报

  • 使用分析统计

  • 其他后台网络活动

为什么必须配置？

如果不配置此环境变量，使用第三方 API 时可能出现：

  1. 连接不稳定 - Claude Code 尝试连接 Anthropic 官方服务器导致超时
  2. 响应中断 - 非必要请求干扰正常 API 调用
  3. 额度异常消耗 - 部分请求可能被错误计费
  4. 频繁报错 - 各种网络相关错误提示

2.2 初次引导配置

配置文件位置：C:Usersyz.claude.json（注意：与 settings.json 同级目录）


{

  "hasCompletedOnboarding": true

}

作用

  • 跳过新手引导 - 首次运行 claude 命令时不会进入交互式引导流程

  • 直接开始使用 - 系统判定你已完成初始化，直接进入工作状态

工作原理

当用户首次运行 claude 命令时：

  • hasCompletedOnboarding: false（或不存在）→ 触发新手引导

  • hasCompletedOnboarding: true → 跳过引导

2.3 Git 提交署名配置（可选）

同样在 C:Usersyz.claude.json 中添加：


{

  "hasCompletedOnboarding": true,

  "attribution": {

     "commit": "",

     "pr": ""

  }

}

配置项说明

attribution.commit

  • 默认行为：在 Git Commit 末尾添加 Co-authored-by: Claude <noreply@anthropic.com>

  • 关闭方法：设置为空字符串 ""

attribution.pr

  • 默认行为：在 Pull Request 描述中添加"🤖 Generated with Claude Code"

  • 关闭方法：设置为空字符串 ""

完整 .claude.json 示例


{

  "hasCompletedOnboarding": true,

  "attribution": {

     "commit": "",

     "pr": ""

  }

}

3. 可以安装使用 CCometixLine

开源地址 Haleclipse/CCometixLine: Claude Code statusline tool written in Rust

下载对应安装包到claude code安装目录。创建目录 ccline将下载文件复制到目录中

执行


# 初始化配置文件

ccline --init

# 检查配置有效性  

ccline --check

# 打印当前配置

ccline --print

# 进入 TUI 配置模式

ccline --config

在C:Usersyz.claudesettings.json 中添加


{

  "statusLine": {

     "type": "command", 

     "command": "%USERPROFILE%.claudecclineccline.exe",

     "padding": 0

  }

}

4. shift-enter 换行

$.actions 内加上


         {

             "command": {

                 "action": "sendInput",

                 "input": "u001bn"

             },

             "id": "User.sendInput.FE9C254"

         },

$.keybindings 里加上


         {

             "id": "User.sendInput.FE9C254",

             "keys": "shift+enter"

         },

完整：


{

     "actions": [

         {

             "command": {

                 "action": "sendInput",

                 "input": "u001bn"

             },

             "id": "User.sendInput.FE9C254"

         }

     ],

     "keybindings": [

         {

             "id": "User.sendInput.FE9C254",

             "keys": "shift+enter"

         }

     ]

}

5. 生成提示词cluade.md


我是一名使用java语言的后端工程师, 现在需要一份全局提示词,请你使用AskUserQuestion工具完成这一任务.

6. MCP 服务器配置

MCP（Model Context Protocol）服务器为 Claude Code 提供扩展能力。配置文件位置：C:Usersyz.claudesettings.json

配置总览

在 settings.json 中添加 mcpServers 字段：


{

  "env": { ... },

  "mcpServers": {

     // MCP 服务器配置

  }

}

各 MCP 服务器详解

1. ace-tool（优先级最高，必装）

作用：Augment Context Engine - 最强大的代码上下文理解引擎

能力：

  • 语义级代码搜索（理解业务逻辑，不仅是字符串匹配）

  • 跨语言链路追踪（Rust Command ↔ Frontend Invoke）

  • 代码风格/实现模式查找

配置：


"ace-tool": {

  "command": "ace-tool",

  "args": [

     "--base-url", "https://acemcp.heroman.wtf/relay/",

     "--token", "ace_********",

     "--batch-size", "100",

     "--max-lines-per-blob", "4000",

     "--upload-concurrency", "5",

     "--upload-timeout-ms", "60000",

     "--retrieval-timeout-ms", "120000"

  ]

}

环境依赖：需要先全局安装 npm install -g ace-tool

2. serena（符号级精度工具）

作用：专业代码符号操作工具（定义查找、引用分析、重构）

能力：

  • 精确查找 TypeScript Interface / Rust Struct / Function 定义

  • 查找所有引用位置

  • 符号重命名（自动更新所有引用）

  • Import/Mod 关系分析

配置：


"serena": {

  "command": "uvx",

  "type": "stdio",

  "args": [

     "--python", "3.11",

     "--from", "git+https://github.com/oraios/serena",

     "serena-mcp-server",

     "--context", "desktop-app",

     "--mode", "editing",

     "--mode", "interactive",

     "--project-from-cwd"

  ]

}

使用场景：当 ace-tool 已定位上下文后，需要符号级精确操作时使用

环境依赖：需要 Python 3.11+ 和 uv

3. code-index（代码索引补充）

作用：快速代码搜索（正则/模糊匹配）

能力：

  • 文件查找（支持 glob 模式：*.py, src/**/*.ts）

  • 快速全文搜索

  • 符号概览

配置：


"code-index": {

  "command": "uvx",

  "args": ["code-index-mcp"]

}

使用场景：ace-tool 兜底方案，或需要简单字符串搜索时

环境依赖：需要 Python 和 uv

4. context7（外部知识库）

作用：实时获取最新官方文档和代码示例

能力：

  • Tauri 官方文档（v1/v2，必须明确版本）

  • Rust std 文档

  • npm 包文档

  • MDN Web API 文档

配置：


"context7": {

  "command": "npx",

  "type": "stdio",

  "args": [

     "-y",

     "@upstash/context7-mcp",

     "--api-key", "**********"

  ]

}

重要：不参与项目内代码理解，仅用于外部知识查询

环境依赖：需要 Node.js/npm

5. filesystem（文件系统访问）

作用：提供安全的文件读写能力

能力：

  • 读取/写入文件

  • 列出目录

  • 创建/移动文件

配置：


"filesystem": {

  "command": "npx",

  "args": [

     "-y",

     "@modelcontextprotocol/server-filesystem",

     "D:pythonacgo"  // 允许访问的根目录（可配置多个）

  ]

}

安全：只能访问指定目录，无法越界

环境依赖：需要 Node.js/npm

6. server-git（版本控制）

作用：Git 操作能力

能力：

  • 查看 Diff / Blame

  • 提交历史分析

  • 分支管理

配置：


"server-git": {

  "command": "uvx",

  "args": [

     "mcp-server-git",

     "--repository", "D:pythonacgo"  // Git 仓库路径

  ]

}

用途：理解修改背景，不参与方案设计

环境依赖：需要 Python、uv 和 Git

7. memory（长期记忆）

作用：跨会话持久化知识

能力：

  • 存储项目规范（如 Rust Clippy 规则）

  • 记录环境坑点（跨平台编译问题）

  • 缓存常用命令

配置：


"memory": {

  "command": "npx",

  "type": "stdio",

  "args": [

     "-y",

     "@modelcontextprotocol/server-memory"

  ]

}

环境依赖：需要 Node.js/npm

8. sequential-thinking（深度思考）

作用：复杂问题分析工具

能力：

  • 多步推理链（Chain of Thought）

  • 方案对比评估

  • 假设验证

配置：


"sequential-thinking": {

  "command": "npx",

  "type": "stdio",

  "args": [

     "-y",

     "@modelcontextprotocol/server-sequential-thinking"

  ]

}

环境依赖：需要 Node.js/npm

9. chrome-devtools（浏览器控制）

作用：自动化测试和调试

能力：

  • 页面交互（点击、填表）

  • 网络请求分析

  • 性能追踪

  • 截图

配置：


"chrome-devtools": {

  "command": "npx",

  "args": [

     "-y",

     "chrome-devtools-mcp@latest"

  ]

}

环境依赖：需要 Node.js/npm 和 Chrome 浏览器

10. mindmap（思维导图生成）

作用：将 Markdown 内容转换为可视化思维导图

能力：

  • 自然语言/结构化内容转思维导图

  • 自动生成 HTML 文件并在浏览器打开

  • 支持项目架构、知识体系、需求文档等可视化

前置安装：


npm install -g markmap-cli

配置：


"mindmap": {

  "command": "uvx",

  "args": [

   "mindmap-mcp-server",

    "--return-type",

    "html"

  ]

}

环境依赖：需要 Python、uv 和 markmap-cli

完整配置示例

将以下内容添加到 C:Usersyz.claudesettings.json：


{

  "env": {

     "ANTHROPIC_AUTH_TOKEN": "sk-***",

     "ANTHROPIC_BASE_URL": "https://***.com",

     "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-5",

     "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-5",

     "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5",

     "ANTHROPIC_MODEL": "claude-sonnet-4-5",

     "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"

  },

  "mcpServers": {

     "ace-tool": {

       "command": "ace-tool",

       "args": [

         "--base-url", "https://acemcp.heroman.wtf/relay/",

         "--token", "ace_014fa01fa4ca3c7eaad02cb22e483bbaeba03218",

         "--batch-size", "100",

         "--max-lines-per-blob", "4000",

         "--upload-concurrency", "5",

         "--upload-timeout-ms", "60000",

         "--retrieval-timeout-ms", "120000"

       ]

     },

     "serena": {

       "command": "uvx",

       "type": "stdio",

       "args": [

         "--python", "3.11",

         "--from", "git+https://github.com/oraios/serena",

         "serena-mcp-server",

         "--context", "desktop-app",

         "--mode", "editing",

         "--mode", "interactive",

         "--project-from-cwd"

       ]

     },

     "code-index": {

       "command": "uvx",

       "args": ["code-index-mcp"]

     },

     "context7": {

       "command": "npx",

       "type": "stdio",

       "args": [

         "-y",

         "@upstash/context7-mcp",

         "--api-key", "ctx7sk-1ed2dfa5-6155-449f-8544-944c37c3efec"

       ]

     },

     "filesystem": {

       "command": "npx",

       "args": [

         "-y",

         "@modelcontextprotocol/server-filesystem",

         "D:pythonacgo"

       ]

     },

     "server-git": {

       "command": "uvx",

       "args": [

         "mcp-server-git",

         "--repository", "D:pythonacgo"

       ]

     },

     "memory": {

       "command": "npx",

       "type": "stdio",

       "args": [

         "-y",

         "@modelcontextprotocol/server-memory"

       ]

     },

     "sequential-thinking": {

       "command": "npx",

       "type": "stdio",

       "args": [

         "-y",

         "@modelcontextprotocol/server-sequential-thinking"

       ]

     },

     "chrome-devtools": {

       "command": "npx",

       "args": [

         "-y",

         "chrome-devtools-mcp@latest"

       ]

     }

  }

}

MCP 工具使用优先级（关键）

按以下顺序选择工具：

  1. ace-tool（最高优先级） - 任何需要理解代码、业务、上下文的场景
  2. serena - 需要符号级精确能力（定义/引用/重构）
  3. context7 - 查询外部文档（必须明确版本号）
  4. filesystem - 已知文件路径的读写操作
  5. code-index - 简单字符串搜索兜底
  6. 其他工具 - 特定场景补充

铁律：禁止绕过 ace-tool 直接使用低层工具猜文件路径

验证配置

重启 Claude Code 后执行：


# 进入 Claude Code 后查看已加载的 MCP 服务器

# 应该能看到上述 9 个服务器状态为 Active

如某个服务器加载失败，检查：

  1. 对应环境是否安装（Node.js/Python/uv/ace-tool）
  2. 配置文件 JSON 格式是否正确（注意逗号）
  3. 路径是否使用双反斜杠（Windows：D:pathtodir）
阅读

Windows Terminal 设置
上一篇
2026-02-01

Nexus 安装使用
下一篇
2025-12-26
© 2018-05-01 yz ⋅
⋅