Claude Code 快速上手指南

📖 目录

• 什么是 Claude Code？
• 安装前的准备
• 安装步骤
• 首次使用配置
• 基本使用方法
• 常用功能示例
• 常见问题解答

---

什么是 Claude Code？

Claude Code 是 Anthropic 官方推出的命令行工具（CLI），它将 Claude AI 的强大能力直接带到你的终端中，帮助你：

• ✅ 编写和修改代码
• ✅ 调试程序问题
• ✅ 解释复杂代码
• ✅ 自动化开发任务
• ✅ 直接在项目中进行代码重构

与网页版不同，Claude Code 可以直接访问你的本地文件，实时编辑代码，执行命令，是开发者的 AI 助手。

---

安装前的准备

1. 检查系统要求

Claude Code 支持以下操作系统：

• macOS
• Linux
• Windows (需要 WSL 或 PowerShell)

2. 安装 Node.js

Claude Code 需要 Node.js 环境（版本 18 或更高）。

检查是否已安装 Node.js

打开终端（macOS/Linux）或命令提示符（Windows），输入：

node --version

如果显示版本号（如 v18.0.0 或更高），说明已安装，可以跳到下一步。

如果未安装 Node.js

方法 1：使用官方安装包（推荐新手）

1. 访问 Node.js 官网：https://nodejs.org
2. 下载 LTS（长期支持）版本
3. 运行安装包，按照提示完成安装
4. 重新打开终端，运行 node --version 确认安装成功

方法 2：使用包管理器（macOS）

# 使用 Homebrew
brew install node

方法 3：使用包管理器（Linux - Ubuntu/Debian）

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

---

安装步骤

第 1 步：安装 Claude Code

打开终端，运行以下命令：

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

说明：

• npm 是 Node.js 的包管理工具
• -g 表示全局安装，让你可以在任何目录使用 claude 命令
• 安装过程可能需要 1-2 分钟

第 2 步：验证安装

安装完成后，运行：

claude --version

如果显示版本号，说明安装成功！

---

首次使用配置

1. 获取 API 密钥

在使用 Claude Code 之前，你需要一个 Anthropic API 密钥：

1. 访问 Anthropic 官方控制台：https://console.anthropic.com
2. 注册或登录账号
3. 在"API Keys"页面创建新的 API 密钥
4. 复制密钥（格式类似：sk-ant-...）

如果需要免费的第三方 API 代理服务，推荐使用https://api.code-relay.com/register?aff=u1o3进行注册，这样使用了推荐码，新用户的初始使用金额从$25提升到$30，我这边也有一定奖励，双赢

额度可以选择无限

⚠️ 重要：妥善保管你的 API 密钥，不要分享给他人或提交到代码仓库

2. 配置 API 密钥

方法 1：通过命令配置

运行 Claude Code 时，首次会提示你输入 API 密钥：

claude

按照提示粘贴你的 API 密钥即可。

方法 2：通过环境变量配置

在终端配置文件中添加（macOS/Linux）：

# 编辑 ~/.zshrc 或 ~/.bashrc
export ANTHROPIC_API_KEY='你的API密钥'

保存后运行：

source ~/.zshrc  # 或 source ~/.bashrc

方法 3：配置settings.json文件（推荐）

1. 按 Cmd + Shift + G
2. 输入 ~/.claude
3. 双击 settings.json 用文本编辑器打开

🎯 常用配置参数

{
“env”: {
“ANTHROPIC_AUTH_TOKEN”: “sk-ant-your-api-key”,
“ANTHROPIC_BASE_URL”: “https://api.anthropic.com/”
},
“model”: “claude-sonnet-4-5-20250929”,
“temperature”: 0.7,
“max_tokens”: 4096,
“timeout”: 30000
}

参数说明：

• ANTHROPIC_AUTH_TOKEN：你的 API 密钥
• ANTHROPIC_BASE_URL：API 端点（建议用官方我用的是https://api.codemirror.codes/的，没有账号的用https://api.code-relay.com/register?aff=u1o3注册，你我都能额外获取使用金额）
• model：默认使用的 Claude 模型
• temperature：创造性程度（0-1，越高越有创造性）
• max_tokens：最大输出长度
• timeout：请求超时时间（毫秒）

我这边settings.json文件配置的是：

{
    "env": {
            "ANTHROPIC_AUTH_TOKEN": "sk-改为你上面创建的令牌密钥",
            "ANTHROPIC_BASE_URL": "https://api.codemirror.codes/"
    }
}

我是使用这种方式的，主要推荐这种

---

---

---

Windows 用户可以在系统环境变量中设置 ANTHROPIC_API_KEY。

---

基本使用方法

启动 Claude Code

在任意目录打开终端，运行：

claude

你会看到 Claude Code 的欢迎界面，现在可以开始对话了！

基本交互

直接输入你的问题或需求：

你: 请帮我解释一下这个项目的目录结构

Claude Code 会自动读取当前目录的文件，并给出详细说明。

退出 Claude Code

输入以下任一命令：

• exit
• quit
• 或按 Ctrl + C

---

常用功能示例

1. 创建新文件

你: 创建一个简单的 Python 计算器程序

Claude Code 会：

1. 创建 calculator.py 文件
2. 编写完整的代码
3. 解释代码功能

2. 调试代码

你: 这个脚本报错了，帮我看看问题在哪

Claude Code 会：

1. 读取相关文件
2. 分析错误原因
3. 提供修复方案
4. 询问是否自动修复

3. 代码审查

你: 检查 main.js 文件的代码质量

Claude Code 会：

1. 分析代码结构
2. 指出潜在问题
3. 提供改进建议

4. 添加新功能

你: 给这个网站添加深色模式功能

Claude Code 会：

1. 分析现有代码
2. 规划实现方案
3. 修改相关文件
4. 确保功能正常

5. 解释复杂代码

你: 解释 src/utils/algorithm.js 中的排序算法

Claude Code 会详细说明算法逻辑和实现细节。

6. 执行命令

你: 运行 npm test 查看测试结果

Claude Code 会执行命令并分析输出结果。

---

实用技巧

1. 指定文件

在对话中明确提到文件名：

你: 修改 package.json 中的版本号为 2.0.0

2. 批量操作

你: 将所有 .js 文件中的 var 替换为 const

3. 询问建议

你: 这个项目的代码结构有什么改进建议？

4. 学习模式

你: 教我如何使用 React Hooks，并给我一个实际例子

5. Git 操作

你: 创建一个 git commit，提交信息要描述刚才的修改

---

常见问题解答

Q1: Claude Code 会收费吗？

A: Claude Code 本身是免费工具，但使用时会调用 Anthropic API，根据你的使用量收费。具体定价请查看：https://www.anthropic.com/pricing

新用户通常有免费额度可以试用。

Q2: 我的代码会被上传到云端吗？

A: Claude Code 会读取你的本地文件并发送到 Anthropic API 进行处理。Anthropic 不会使用你的数据训练模型。详见隐私政策：https://www.anthropic.com/legal/privacy

Q3: 可以在没有网络的情况下使用吗？

A: 不可以，Claude Code 需要连接到 Anthropic API 服务器。

Q4: Claude Code 支持哪些编程语言？

A: Claude Code 支持几乎所有主流编程语言，包括：

• Python, JavaScript, TypeScript
• Java, C++, C#, Go, Rust
• HTML, CSS, SQL
• 以及更多…

Q5: 出现 “API key not found” 错误怎么办？

A: 请检查：

1. 是否正确设置了 ANTHROPIC_API_KEY 环境变量
2. API 密钥格式是否正确（应以 sk-ant- 开头）
3. 是否重启了终端（设置环境变量后需要重启）

Q6: 如何更新 Claude Code？

A: 运行以下命令：

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

Q7: Claude Code 会自动修改我的文件吗？

A: 默认情况下，Claude Code 会在修改文件前告知你，并等待确认。你可以在设置中调整这个行为。

Q8: 遇到问题怎么办？

A: 可以：

1. 运行 claude --help 查看帮助文档
2. 访问官方 GitHub 仓库：https://github.com/anthropics/claude-code
3. 查看官方文档：https://docs.anthropic.com

---

下一步学习

掌握基础后，你可以探索更多高级功能：

1. 自定义命令：创建项目专属的快捷命令
2. MCP 服务器：扩展 Claude Code 的能力
3. 工作流自动化：让 Claude Code 处理重复任务
4. 团队协作：在团队中推广使用

运行以下命令了解更多：

claude --help

或在 Claude Code 对话中输入：

你: 介绍一下高级功能

---

获取帮助

• 📚 官方文档：https://docs.anthropic.com
• 💬 GitHub Issues：https://github.com/anthropics/claude-code/issues
• 🌐 官方网站：https://claude.ai

---

祝你使用愉快！🚀

如果这份指南对你有帮助，欢迎分享给更多开发者！