claude code+matt pocock环境搭建安装配置 Claude Code CLI 完整教学文档目录前置

安装配置 Claude Code CLI 完整教学文档

文档说明：本教程指导您全局安装 Anthropic 官方 Claude Code 命令行工具，并按照您的要求配置 ~/.claude/settings.json 文件。

前置要求

Node.js（建议 v16 或更高版本）与 npm 已安装。
- 检查：终端运行 node -v 和 npm -v。
- 未安装？前往 Node.js 官网下载。
Anthropic API Key（或兼容的第三方 API Key，如 DeepSeek）——若您仅使用官方 Claude 服务，需在 Anthropic Console 获取 API Key。
操作系统：macOS、Linux 或 Windows（本教程以 macOS/Linux 路径为主，Windows 用户请相应调整路径，如 %USERPROFILE%\.claude\settings.json）。
网络连接正常。

安装 Claude Code CLI

在终端中执行以下命令，全局安装最新版 Claude Code：

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

-g 表示全局安装。
安装完成后，系统会提供 claude 命令。

验证安装：

claude --version

若输出类似 v1.0.0 的版本号，说明安装成功。

配置 ~/.claude/settings.json

1. 创建目录与文件

在终端执行：

mkdir -p ~/.claude
touch ~/.claude/settings.json

2. 编辑配置文件

使用任意文本编辑器打开文件：

nano ~/.claude/settings.json
# 或
vim ~/.claude/settings.json
# 或 VS Code
code ~/.claude/settings.json

3. 写入配置内容

根据您的需求，以下提供两种典型配置示例：

示例 A：使用 Anthropic 官方 API

{
  "apiKey": "sk-ant-xxxxxxxxxxxxxxxxxxxxxxxx",
  "model": "claude-3-5-sonnet-20241022",
  "maxTokens": 4096,
  "theme": "dark"
}

字段说明：

apiKey：您的 Anthropic API Key。
model：默认使用的模型，例如 claude-3-5-sonnet-20241022、claude-3-opus-20240229 等。
maxTokens：单次响应的最大 token 数。
theme：终端界面主题，可选 dark 或 light。

示例 B：使用第三方兼容端点（如 DeepSeek）

以下配置使 Claude Code 通过 DeepSeek 的 Anthropic 兼容接口工作（需替换为真实的 DeepSeek API Key）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "your-deepseek-api-key",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash"
  },
  "theme": "dark"
}

字段说明：

ANTHROPIC_BASE_URL：兼容端点地址。
ANTHROPIC_AUTH_TOKEN：第三方服务的 API Key。
其余 ANTHROPIC_* 变量将各类模型映射到指定模型，避免代码内部默认调用不存在的模型而报错。
CLAUDE_CODE_SUBAGENT_MODEL：子代理使用的模型。

⚠️ 注意：请将示例中的 your-deepseek-api-key 替换为真实密钥。模型名称（如 deepseek-chat）请以 DeepSeek 官方最新文档为准。

4. 保存并退出

nano：Ctrl+O 保存，Ctrl+X 退出。
vim：按 Esc 后输入 :wq 保存。

验证安装与配置

1. 检查配置文件格式

cat ~/.claude/settings.json

确保 JSON 格式正确（无多余逗号、括号匹配）。可使用在线 JSON 校验工具或运行：

python3 -m json.tool ~/.claude/settings.json

（若安装了 Python）

2. 运行 Claude Code