Claude Code

Claude Code 是 Anthropic 官方 CLI 工具，让开发者在终端中直接与 Claude 模型交互。它能直接读写文件、执行命令、操作 Git，是一个真正参与开发过程的 AI 助手。

安装配置

环境要求

需要 Node.js 18+ 环境。

# 确认 Node 版本
node --version

# 安装
npm install -g @anthropic-ai/claude-code

# 验证
claude --version

Windows 用户

遇到脚本执行限制时，先解除限制：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

配置文件位置

操作系统	配置路径
Windows	`%USERPROFILE%\.claude\`
macOS/Linux	`~/.claude/`

核心配置文件 settings.json 控制模型选择、环境变量、权限等行为。

第三方 API 接入

支持配置第三方 API 提供者，绕过 Anthropic 官方 API 限制。以 MiniMax 为例：

访问 MiniMax 开放平台创建 API Key
编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MINIMAX_API_KEY",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "ANTHROPIC_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_SMALL_FAST_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.7"
  }
}

在 ~/.claude.json 中添加 "hasCompletedOnboarding": true 跳过引导流程

ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 优先级高于配置文件中的其他设置。

MCP 扩展配置

MCP 让 Claude Code 连接外部工具和数据源。在 settings.json 中添加 mcpServers 字段：

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": ["minimax-coding-plan-mcp", "-y"],
      "env": {
        "MINIMAX_API_KEY": "YOUR_KEY",
        "MINIMAX_API_HOST": "https://api.minimaxi.com"
      }
    }
  }
}

进入 Claude Code 后输入 /mcp 查看已注册 Server。协议细节见 MCP协议。

全局规范配置

Claude Code 通过 CLAUDE.md 文件理解项目规范，放在项目根目录自动读取。

全局规范（所有项目生效）创建 CLAUDE_GLOBAL.md 放在 ~/ 目录，通过 --system-prompt 注入：

function cc {
    param([string]$task)
    $configPath = "$HOME\CLAUDE_GLOBAL.md"
    if (Test-Path $configPath) {
        $systemPrompt = Get-Content $configPath -Raw -Encoding utf8
    } else {
        $systemPrompt = "You are a senior developer. Respond in Chinese."
    }
    if ($task) {
        claude --system-prompt $systemPrompt $task
    } else {
        claude --system-prompt $systemPrompt
    }
}

将函数添加到 PowerShell $PROFILE，输入 cc 即可启动带全局规范的 Claude Code。

常用命令

命令	说明
`claude`	启动交互式会话
`claude "任务描述"`	直接执行单次任务
`claude --help`	查看帮助信息
`claude config set`	设置配置项
`claude mcp add`	添加 MCP 服务器
`/mcp`	查看已注册 MCP Server
`/plugin install`	安装技能插件

技能系统完整说明见 Claude Code技能。

常见问题

问题	原因	解决方案
npm 安装失败	网络问题或权限不足	换源 `npm config set registry https://registry.npmmirror.com`，或用管理员权限
无法连接模型	Auth Token 或 Base URL 配置错误	检查 `ANTHROPIC_AUTH_TOKEN` 和 `ANTHROPIC_BASE_URL`，用 `claude config list` 查看
MCP Server 工具未生效	Server 启动命令不可用	`/mcp` 确认状态，检查 `uvx`/`npx` 是否已安装
上下文窗口填满	长会话输出质量下降	`/compact` 压缩上下文，或开启新会话