Claude Code 模型配置完全指南（一）：新手入门与安装

本文是 Claude Code 模型配置系列教程的第一篇，带你从零开始安装和配置 Claude Code。

什么是 Claude Code？

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，让你可以在终端中直接与 AI 对话、编写代码、调试程序。它类似于一个超级智能的编程伙伴，随时待命帮助你解决 coding 问题。

🌟 核心功能

• 💻 代码生成 – 自然语言描述需求，自动生成代码
• 📖 代码解释 – 上传代码文件，AI 帮你理解和解释
• 🐛 调试辅助 – 分析错误信息，提供修复建议
• 📁 文件操作 – 读取、编辑项目文件
• 🎭 多模型支持 – 可选择不同 Claude 模型（Opus、Sonnet、Haiku）

第一步：注册 Anthropic 账号

1. 访问官网

打开浏览器访问：https://www.anthropic.com

2. 创建账号

1. 点击右上角 “Sign Up” 或 “Get Started”
2. 选择注册方式：
   • 邮箱注册（推荐）
   • Google 账号快捷登录
   • Microsoft 账号快捷登录
3. 填写邮箱，设置密码
4. 验证邮箱（查收验证邮件）

3. 完成个人资料

• 填写姓名
• 选择使用场景（个人/企业）
• 同意服务条款

第二步：获取 API 密钥

1. 进入控制台

登录账号后，访问：https://console.anthropic.com

2. 创建 API Key

1. 点击左侧菜单 “API Keys”
2. 点击 “Create Key” 按钮
3. 给密钥起个名字（如：my-claude-code）
4. 选择权限范围（建议选 Full Access）
5. 点击 “Create”

推荐保存方式：

• 🔐 密码管理器（1Password、Bitwarden）
• 📁 本地加密文件
• 🔧 环境变量（后续会讲到）

第三步：安装 Claude Code CLI

方法一：npm 安装（推荐）

# 确保已安装 Node.js 18+
node --version

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

方法二：Homebrew 安装（macOS）

# 安装 Homebrew（如果未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Claude Code
brew install claude-code

# 验证
claude --version

方法三：直接下载

# Linux/macOS
curl -L https://github.com/anthropics/claude-code/releases/latest/download/claude-code-linux-x64.tar.gz | tar xz
sudo mv claude /usr/local/bin/

# Windows
# 访问 https://github.com/anthropics/claude-code/releases 下载 .exe 文件

第四步：配置 API 密钥

方式一：交互式配置（推荐新手）

# 运行配置命令
claude config

# 按提示输入 API Key
# 选择默认模型（推荐 claude-sonnet-4-20250514）

方式二：环境变量

# Linux/macOS - 添加到 ~/.bashrc 或 ~/.zshrc
export ANTHROPIC_API_KEY="你的 API 密钥"

# 使配置生效
source ~/.bashrc  # 或 source ~/.zshrc

# Windows PowerShell
$env:ANTHROPIC_API_KEY="你的 API 密钥"

# Windows CMD
set ANTHROPIC_API_KEY=你的 API 密钥

方式三：配置文件

# 创建配置目录
mkdir -p ~/.claude

# 创建配置文件
cat > ~/.claude/config.json << 'CONFIG'
{
  "apiKey": "你的 API 密钥",
  "model": "claude-sonnet-4-20250514"
}
CONFIG

第五步：验证安装

# 测试连接
claude --help

# 简单对话测试
claude "你好，请用一句话介绍你自己"

如果看到 AI 回复，说明配置成功！🎉

常见问题 FAQ

Q1: 安装时提示权限错误？

# npm 安装时使用 sudo
sudo npm install -g @anthropic-ai/claude-code

# 或者修改 npm 全局目录权限
sudo chown -R $(whoami) /usr/local/lib/node_modules

Q2: API 密钥无效？

检查：

• 密钥是否完整复制（无多余空格）
• 密钥是否已过期（控制台可重新生成）
• 账号是否有可用额度

Q3: 命令找不到 claude？

# 检查 npm 全局目录是否在 PATH 中
echo $PATH

# 手动添加（Linux/macOS）
export PATH=$PATH:$(npm config get prefix)/bin

下一篇

下一篇：Claude Code 模型配置完全指南（二）：模型选择与高级配置

在第二篇中，我们将深入讲解：

• 📊 如何选择合适的 Claude 模型
• ⚙️ 高级配置选项详解
• 🔧 自定义工作流设置

本文由 AI 助手自动生成并发布 | 最后更新：2026-03-29