logo

快速导航

完整教程指南

Claude Code 快速上手指南

完整的安装配置教程，让小白也能轻松上手 AI 编程助手

📚 AI 服务文档中心

C

Claude Code

Anthropic

G

Grok CLI

xAI

💡点击卡片查看详细配置文档，或访问完整文档中心浏览所有 AI 工具

安装进度

跟随步骤，轻松完成配置

1
/ 10
开始
当前：系统要求
完成
📋

系统要求

💻 支持的操作系统

  • Windows 10/11
  • macOS 10.15+
  • Linux (Ubuntu 20.04+)

⚡ 基本配置要求

  • 4GB+ 内存
  • 稳定的网络连接
  • Node.js 18+

提示： 如果你不确定是否满足要求，别担心！接下来的教程会帮你安装所需的软件。

🚀

一键安装向导

推荐新手使用

🔧 Claude Code 密钥安装向导

快速配置您的 Claude Code 开发环境
检测密钥
检测系统中的API密钥
导出配置
导出Claude Code配置文件
完成安装
按照说明完成Claude Code配置
步骤 1: API密钥状态
⚠️ 未检测到可用的API密钥
请先到密钥管理页面创建API密钥，然后刷新此页面。
如需帮助，请参考 使用文档或联系客服
1

安装 Node.js

（编程运行环境）

什么是 Node.js？ 它是运行 Claude Code 必需的基础环境，就像手机需要操作系统一样。

1
下载安装包

点击下方按钮下载 Node.js 官方安装包

🔗 下载 Node.js（选择 Windows 安装包）
2
安装软件

下载完成后，双击运行安装包，按照提示点击"下一步"即可完成安装

✅ 验证安装是否成功

安装完成后，运行以下命令检查：

node --version

如果显示版本号（如 v18.17.0），说明安装成功！

2

安装 Git

1. 下载 Git

🔗 下载 Git for Windows

2. 验证安装

git --version

期待输出: git version 2.45.1.windows.1

3

安装 Claude Code

1. 安装 Claude Code

方式一：NPM 全局安装（推荐）
npm install -g @anthropic-ai/claude-code
方式二：使用自动安装脚本
irm https://claude.ai/install.ps1 | iex

💡 确保安装过程中没有出现 fail 或 error 等错误信息

2. 验证安装

claude --version

期待输出: Claude Code version 1.x.x

4

获取密钥

1. 登录平台

🔐 登录 平台

2. 获取 API 密钥

🔑 获取 API 密钥

3. 密钥管理选项

A
选择第一个密钥并复制
B
点击右侧操作面板"导出配置"，下载预配置的 settings.json 文件
5

配置环境

🔧方式一：环境变量配置（推荐）

通过终端设置环境变量，这是最简单的配置方式：

export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxxxxxxx" export ANTHROPIC_BASE_URL="https://xxx.xxx"

💡 这种方式在每次终端会话中都需要重新设置，建议添加到 ~/.bashrc 或 ~/.zshrc 中

📝方式二：配置文件设置

创建或编辑 Claude Code 配置文件：

vim ~/.claude/settings.json

配置文件内容：

{
    "env": {
        "ANTHROPIC_API_KEY": "您创建的key",
        "ANTHROPIC_BASE_URL": "https://xxx.xxx",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
        "CLAUDE_MODEL": "claude-sonnet-4-20250514"
    },
    "apiKeyHelper": "echo '您创建的key'"
}

⚡方式三：命令行配置

使用 Claude Code 内置命令配置：

claude-code config set api-key sk-ant-xxxxxxxxxxxxxxxxxxxxx

🚀绕过登录方案（不想登录Claude Code）

1
在 ~/.claude 目录下创建 ide 文件夹
2
在 ide 文件夹下创建 49562.lock 文件

✅ 完成后即可跳过 Claude Code 登录流程

6

验证配置

1. 启动 Claude Code

claude

2. 配置流程指导

1

选择主题风格

建议选择 "1. Dark mode" 或直接按回车确认

╭──────────────────────────╮
│ ✻ Welcome to Claude Code │
╰──────────────────────────╯
> 1. Dark mode√
2

API Key 选择

选择 "2. No (recommended)" 使用自定义配置

> 2. No (recommended)√
3

安全提醒

阅读安全提醒后按回车继续

Press Enter to continue…
4

文件夹信任

选择 "1. Yes, proceed" 信任当前文件夹

> 1. Yes, proceed
5

测试对话

在输入框中输入"你好"并按回车测试

> 你好
● 你好！我是Claude Code，很高兴为您提供软件工程方面的帮助。

3. 配置成功验证

完成上述5个步骤后，如果看到类似下面的欢迎界面，说明配置成功：

╭───────────────────────────────────────────────────╮
│ ✻ Welcome to Claude Code! │
│ │
│ /help for help, /status for your current setup │
│ │
│ Overrides (via env): │
│ • API Base URL: │
│ │
╰───────────────────────────────────────────────────╯

💡 如果配置过程中出现问题，请检查：

  • • API 密钥是否正确
  • • settings.json 文件格式是否正确
  • • 网络连接是否正常
📚

实战教程

🔍 5.1 理解新代码库

快速了解代码库概况
1.进入项目根目录：cd /path/to/project
2.启动 Claude Code：claude
3.请求代码库概况：给我一个代码库概览

💡 小技巧： 从广泛的问题入手，然后逐步聚焦到具体领域

查找相关代码

• 查找处理用户认证的文件

• 这些认证文件是如何协同工作的？

• 从前端到数据库，跟踪登录过程

🐛 5.2 高效修复Bug

诊断错误消息
1.分享错误消息：我在运行 npm test 时看到错误
2.请求修复建议：提供一些修复 user.ts 中 @ts-ignore 的方法
3.应用修复：更新 user.ts，添加你建议的 null 检查

💡 小技巧： 提供堆栈跟踪和重现步骤

🔄 5.3 代码重构

现代化旧代码
1.识别旧代码：查找我们代码库中弃用的 API
2.请求重构建议：建议如何重构 utils.js，使用现代 JavaScript 特性
3.安全应用更改：重构 utils.js，使用 ES2024 特性，同时保持原有行为
4.验证重构：对重构后的代码运行测试

✅ 5.4 处理测试

添加测试覆盖率
1.识别未测试代码：查找 NotificationsService.swift 中未覆盖的函数
2.生成测试框架：为通知服务添加测试
3.添加测试用例：为通知服务中的边缘情况添加测试用例
4.运行验证：运行新测试，修复任何失败

🔀 5.5 创建Pull Request

生成全面的PR
1.总结更改：总结我对认证模块所做的更改
2.生成 PR：创建一个 PR
3.完善描述：增强 PR 描述，补充有关安全性改进的更多信息
4.添加测试信息：添加关于如何测试这些更改的信息

📝 5.6 处理文档

生成代码文档
1.识别缺失文档：查找 auth 模块中没有适当 JSDoc 注释的函数
2.生成文档：为 auth.js 中未注释的函数添加 JSDoc 注释
3.增强文档：改进生成的文档，增加更多上下文和示例
4.验证文档：检查文档是否符合我们项目的标准

🖼️ 5.7 使用图像

分析图像和屏幕截图
添加图像方法：
  • • 拖拽图像到 Claude Code 窗口
  • • 复制粘贴图像 (Ctrl+V)
  • • 提供图像路径
分析请求示例：
  • • "这张图显示了什么？"
  • • "描述 UI 元素"
  • • "生成匹配的 CSS"

🚀 高级功能

🧠 深入思考

处理复杂问题时使用：

深入思考在我们的代码库中实现OAuth2的最佳方法
🎨 模型切换

切换 Claude 模型：

/model
💾 上下文管理

压缩上下文节省点数：

/compact [描述]
🔄 对话恢复

恢复之前的对话：

claude --continueclaude --resume
🔧 Git 操作

自然语言 Git 命令：

提交我的更改创建一个 PR
🔌 MCP 服务器

扩展 Claude 功能：

claude mcp add <name> <command>

📝 5.8 设置项目记忆

创建有效的CLAUDE.md文件

为了存储重要的项目信息、约定和常用命令，设置CLAUDE.md文件：

/init

💡 小技巧： 包括常用命令、代码风格偏好和架构模式

⚡ 5.9 Unix风格实用程序

添加到验证过程

将 Claude 添加到构建脚本：

"scripts": {
  "lint:claude": "claude -p '检查代码差异并报告拼写错误'"
}
管道输入输出

通过 Claude 管道传输数据：

cat build-error.txt | claude -p '解释构建错误原因' > output.txt

🔧 5.10 MCP服务器配置

配置MCP服务器

通过连接专用工具和外部服务器增强 Claude 功能：

添加 MCP Stdio 服务器：

claude mcp add <name> <command> [args...]

管理服务器：

claude mcp list
claude mcp get my-server
claude mcp remove my-server
连接到Postgres MCP服务器

为 Claude 提供只读权限查询 PostgreSQL 数据库：

claude mcp add postgres-server /path/to/postgres-mcp-server --connection-string "postgresql://user:pass@localhost:5432/mydb"

使用示例：

  • • "描述一下我们用户表的架构"
  • • "系统中最新的订单有哪些？"
  • • "展示客户和发票之间的关系"
🚀

进阶特性

🔌 6.1 IDE集成

支持的IDE

Claude Code 支持连接到主流IDE：

  • • 您可以直接在IDE中看到Claude Code的改动，在IDE中与其交互
  • • Claude Code 现在支持 VSCode 与 JetBrains
  • • 如果您使用Linux / MacOS，您可以直接使用该插件
安装说明

• 如果您使用VSCode，在VSCode的内置终端唤起Claude Code，插件将被自动安装

• 如果您使用JetBrains，您需要通过此链接下载：Claude Code [Beta] - IntelliJ IDEs Plugin

• 如果您使用 VSCode+WSL，请您提前在VSCode 插件商店安装 WSL 插件

测试连接

您可能需要手动指定IDE或检查IDE连接，通过以下命令测试：

/ide

🎨 6.2 模型切换和配置

模型选择说明

Claude Code 支持 Claude 4 Opus 与 Claude 4 Sonnet 灵活切换：

• 我们强烈推荐您使用Claude 4 Sonnet，其使用体验与Claude 4 Opus没有明显差别，但计费倍率仅为1/5

• 我们为您默认选择了Claude 4 Sonnet，您可以在登录后在配置中修改这一选项

• 如果您没有在站点中关闭"强制使用 Sonnet"，您在/model中切换的模型不会被切换

切换模型命令：
/model

💾 6.3 上下文管理

压缩上下文节省点数

Claude Code 支持压缩上下文以节省点数：

• Claude Code 通常会有长上下文，我们建议您使用以下斜杠命令来压缩以节省点数，较长的上下文往往需要更多点数

/compact [您的描述]

🔄 6.4 对话恢复

恢复上次对话

Claude Code 能够恢复以前的对话：

claude --continue

💡 这会立即恢复您最近的对话，无需任何提示

交互式对话选择
claude --resume

这会显示一个交互式对话选择器，显示：

  • • 对话开始时间
  • • 初始提示或对话摘要
  • • 消息数量

💡 使用箭头键导航并按Enter选择对话，您可以使用这个方法选择上下文

🖼️ 6.5 图像处理

添加图像方法

Claude Code 可以处理图像信息。您可以使用以下任何方法：

  • • 将图像拖放到Claude Code窗口中（在MacOS上）
  • • 复制图像并使用Ctrl+v粘贴到CLI中（在MacOS上）
  • • 提供图像路径：分析这个图像：/path/to/your/image.png
图像分析示例

您可以完全使用自然语言要求进行工作：

• 这是错误的截图。是什么导致了它？

• 这个图像显示了什么？

• 描述这个截图中的UI元素

• 生成CSS以匹配这个设计模型

• 什么HTML结构可以重新创建这个组件？

🧠 6.6 深入思考

使用深入思考功能

Claude Code 支持深入思考：

• 您需要通过自然语言要求其进行深入思考

示例：我需要使用OAuth2为我们的API实现一个新的身份验证系统。深入思考在我们的代码库中实现这一点的最佳方法。

安全分析：思考这种方法中潜在的安全漏洞

边缘情况：更深入地思考我们应该处理的边缘情况

⚠️ 推荐您在使用复杂问题的时候使用这一功能，这也会消耗大量的额度点数

🔧 6.7 Git高级操作

自然语言Git操作

Claude Code 支持使用自然语言操作Git，如：

• 提交我的更改

• 创建一个 pr

• 哪个提交在去年十二月添加了 markdown 测试？

• 在 main 分支上变基并解决任何合并冲突

使用Git工作树

您可以使用工作树创建隔离的编码环境：

• 如果您需要同时处理多个任务，并在Claude Code实例之间完全隔离代码，您可以使用此功能

• Git工作树允许您从同一存储库中检出多个分支到单独的目录

创建新工作树：

# 创建带有新分支的工作树
git worktree add ../project-feature-a -b feature-a
# 或使用现有分支创建工作树
git worktree add ../project-bugfix bugfix-123

在工作树中运行Claude Code：

# 导航到您的工作树
cd ../project-feature-a
# 在这个隔离环境中运行Claude Code
claude

⚡ 6.8 其他高级功能

更多功能特性

Claude Code 支持多种高级功能：

  • • Claude Code可以被用作类Unix工具
  • • Claude Code支持自定义斜杠指令
  • • Claude Code支持使用$ARGUMENTS添加命令参数
  • • Claude Code支持高级设置配置
  • • Claude Code支持GitHub Actions集成
  • • Claude Code支持SDK开发
  • • Claude Code支持模型上下文协议（MCP）

💡 对于更多的用法，您可以参考Claude Code的官方文档

🎉

配置完成

🎊 恭喜！现在您可以开始使用 Claude Code 了
您可以选择加入官方AI社区群，专业技术团队24小时保障