Claude Code 安装与使用全指南（含 MiniMax API 配置）

一、Claude Code 是什么

Claude Code 是 Anthropic 推出的 本地 AI 编程助手 CLI 工具，可以直接在终端中运行，深度理解当前代码仓库的上下文，支持：

代码阅读、修改、重构
自动生成测试、文档
多文件级别的推理与变更
与 Git 工作流深度结合

其定位更接近 “AI Pair Programmer + Repo Agent”，而非简单的 Chat CLI。

二、系统与环境要求

1. 系统要求

操作系统
- macOS 10.15+
- Ubuntu 20.04+ / Debian 10+
- Windows 10+（需 WSL1 / WSL2 或 Git for Windows）
硬件
- 内存 ≥ 4GB
网络
- 需要稳定的互联网连接（鉴权 + 模型推理）
Shell
- Bash / Zsh / Fish（推荐）

2. 依赖说明

Node.js 18+
- 仅在使用 NPM 安装方式时需要
ripgrep
- 通常随 Claude Code 自带
- 若搜索功能异常，需手动安装

三、Claude Code 的安装方式

1. 原生安装（推荐）

这是目前最稳定、最推荐的安装方式，特点：

单一二进制文件
不依赖 Node.js
自动更新可靠性更高

macOS / Linux / WSL

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

Windows CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

安装完成后，确保 claude 已在 PATH 中：

claude doctor

2. Homebrew（macOS）

brew install --cask claude-code

3. NPM 安装（不推荐，除非必须）

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

注意事项：

不要使用 sudo
Node 版本需 ≥ 18
容易出现权限与 postinstall 问题

四、启动与基础使用

进入你的项目目录：

cd your-project
claude

首次启动时：

进行账号登录 / OAuth 授权
选择 Trust This Folder（信任当前目录）
Claude Code 将索引项目文件并进入交互模式

此后，你可以直接使用自然语言进行指令，例如：

“解释这个项目的整体架构”
“重构这个模块并补充单元测试”
“找出可能的性能瓶颈”

五、Windows 使用建议

可选方案

Git for Windows + Git Bash
- 需要额外配置 bash 路径：

$env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"

六、更新与维护

自动更新（默认开启）

启动时自动检查
后台下载并安装
下次启动生效

手动更新

claude update

关闭自动更新（不建议）

export DISABLE_AUTOUPDATER=1

七、卸载 Claude Code

原生安装卸载（macOS / Linux / WSL）

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

清理配置（可选）

rm -rf ~/.claude
rm ~/.claude.json
rm -rf .claude
rm -f .mcp.json

八、使用 MiniMax API 运行 Claude Code（重点）

Claude Code 支持通过 Anthropic 兼容 API 接入第三方模型，MiniMax 即是其中之一。

重要前提（非常关键）

必须先清除所有 Anthropic 官方环境变量

unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_BASE_URL

否则会导致 配置不生效或请求走官方接口。

方式一：使用 cc-switch（推荐）

适合频繁在多个 API Provider 间切换，配置自动化程度高。

方式二：手动配置 settings.json（通用、可控）

1. 配置文件路径

~/.claude/settings.json

2. 示例配置（MiniMax）

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

说明：

ANTHROPIC_BASE_URL
指向 MiniMax 的 Anthropic 兼容接口
ANTHROPIC_AUTH_TOKEN
使用 MiniMax API Key
所有模型统一指向 MiniMax-M2.1，避免模型回退

注意：环境变量的优先级高于 settings.json

3. 启动 Claude Code

cd your-project
claude

启动成功后，即可在 Claude Code 中 透明地使用 MiniMax 模型。

九、常见问题与建议

搜索异常
- 检查 ripgrep 是否存在
请求超时
- 提高 API_TIMEOUT_MS
模型不生效
- 99% 是环境变量未清理干净
企业/团队使用
- 建议通过 Console 或云厂商（Bedrock / Vertex）统一接入

十、总结

Claude Code 是目前 工程化程度极高的 AI 编程 CLI 工具，具备以下核心优势：

真正理解代码仓库上下文
原生 CLI，融入开发流程
支持第三方模型（如 MiniMax）
适合个人开发者与团队规模化使用

通过合理配置，你可以将 Claude Code 作为 长期驻场的 AI 工程助手，而不仅仅是一个“会聊天的模型”。

十一、Coding Plan

智谱

🚀 速来拼好模，智谱 GLM Coding 超值订阅，邀你一起薅羊毛！Claude Code、Cline 等 20+ 大编程工具无缝支持，“码力”全开，越拼越爽！立即开拼，享限时惊喜价！

链接：https://www.bigmodel.cn/glm-coding?ic=BZIP9TJ93R