第02章：Claude Code的安装和配置

第02章：Claude Code的安装和配置

Claude Code是目前市面上最强大的AI编程代理。帮客户装好它，让它工作起来，是你最快能提供的第一个服务。

Claude Code是Anthropic在2024年推出的AI编程代理工具。

它和普通的AI聊天不同：Claude Code可以直接在你的本地文件系统里操作——读代码、写代码、运行命令、调试错误，全程自动化。

对于程序员来说，它是一个强大的编程助手。对于企业来说，它可以处理各种自动化脚本任务。

你能提供的服务：帮客户安装、配置Claude Code，以及根据客户需求设置合适的工作流。

安装前的准备

客户的机器需要以下条件：

  • 操作系统：macOS 10.15+、Windows 10+、或 Ubuntu/Debian Linux
  • Node.js 18+（Claude Code是基于Node.js的）
  • 稳定的网络连接（需要访问Anthropic API）
  • Anthropic API Key（需要客户自己注册，或者你帮他注册）

获取API Key的步骤：

  1. 访问 https://console.anthropic.com
  2. 注册账号（支持Google账号登录）
  3. 进入"API Keys"页面
  4. 点击"Create Key"，生成一个API Key
  5. 记录好这个Key（只显示一次）

关于费用：Claude Code消耗的是Anthropic的API，按token计费。通常使用场景下，一个月的API费用约$20-100。建议客户先充值$20测试。

安装步骤

Step 1：安装Node.js

macOS（使用Homebrew）：

# 如果没有Homebrew，先安装
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装Node.js
brew install node

Windows：

  • 访问 https://nodejs.org 下载LTS版本的安装包
  • 双击安装，全程下一步即可
  • 安装完成后，打开PowerShell，运行 node -v 验证安装成功

Linux（Ubuntu/Debian）：

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

验证安装：node -v 应显示版本号（如 v20.x.x）

Step 2：安装Claude Code

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

安装完成后，验证：

claude --version

Step 3：配置API Key

方法1：环境变量（推荐）

macOS/Linux：

echo 'export ANTHROPIC_API_KEY="你的API Key"' >> ~/.bashrc
source ~/.bashrc

Windows（PowerShell）：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "你的API Key", "User")

方法2：直接在命令行设置（临时）

export ANTHROPIC_API_KEY="你的API Key"  # macOS/Linux
$env:ANTHROPIC_API_KEY="你的API Key"    # Windows PowerShell

Step 4：初次运行测试

在任意目录下运行：

claude

Claude Code会启动一个交互式界面，你可以输入任务，比如：

  • “分析这个文件夹里的Python脚本，告诉我它做什么”
  • “帮我写一个Excel文件批量处理的脚本”
  • “这段代码有什么问题，帮我修复”

常见安装问题

问题1：npm: command not found → Node.js没有正确安装，或者环境变量没有生效。重新安装Node.js，或者重启终端。

问题2：claude: command not found（安装后） → npm全局安装路径没有在PATH里。macOS/Linux运行：

echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

问题3：API调用失败（401错误） → API Key填写错误，或者Key已过期。重新检查Key，确保复制完整，没有多余空格。

问题4：网络超时 → 中国大陆访问Anthropic API可能需要代理。需要在系统层面配置代理，或者使用Claude Code的代理设置选项。

你作为"安装服务提供者"的工作流程

当你帮客户安装Claude Code，标准的服务流程是：

  1. 了解客户环境：操作系统、技术背景、想用Claude Code做什么
  2. 远程或上门安装：大多数情况下，远程协助（Todesk/TeamViewer/Zoom屏幕共享）就够了
  3. 配置API Key：帮客户注册API账号并配置
  4. 测试运行：运行一个示例任务，确认正常工作
  5. 简单培训：教客户最基本的使用方式（启动、输入任务、退出）
  6. 留文档：给客户留一份简单的使用说明（你可以准备一个标准模板）

整个服务，通常1-3小时可以完成。

服务扩展：Claude Code的高阶配置

对于有更多需求的客户，可以提供高阶配置：

  • CLAUDE.md项目规范文件：在客户的项目目录里创建CLAUDE.md，告诉Claude Code这个项目的规则和背景（比如"我们用Python 3.11，不使用外部数据库，代码风格遵循PEP8"），让每次使用都自动遵守这些规则

  • 权限配置：Claude Code可以配置允许执行哪些操作（读文件/写文件/运行命令），帮客户设置合适的权限边界

  • 工作目录隔离：帮客户建立专门的工作目录，让Claude Code只在这个目录里操作，避免误操作

本章小结

Claude Code的安装：Node.js → npm安装Claude Code → 配置API Key → 测试运行。

你的服务价值：把这个1-3小时的安装配置工作，变成¥300-800的服务（因为对客户来说这是无法独立完成的工作）。

→ 第3章：Ollama本地大模型部署——帮客户摆脱网络依赖