🚀 Claude Code
AI 编程助手安装使用教程
查看官方文档
最新版本 v1.x
1
安装 Node.js 环境
在安装 Claude Code 之前，您需要先安装 Node.js。推荐使用 fnm（Fast Node Manager）来管理 Node.js 环境。
安装 fnm：
curl -sSL https://raw.githubusercontent.com/Schniz/fnm/master/install.sh | bash
💡 提示
安装完成后，需要重新加载 shell 配置文件。您可以重新打开终端，或运行：
source ~/.bashrc # 如果使用 bash
source ~/.zshrc # 如果使用 zsh
安装 Node.js：
fnm install --lts
fnm use lts-latest
验证安装：
node --version
npm --version
✅ 成功标志
如果能看到版本号（如 v20.x.x 和 10.x.x），说明 Node.js 环境已成功安装
2
安装 Claude Code
Node.js 环境准备好后，使用 npm 全局安装 Claude Code：
npm install -g claude-code
⚠️ 权限问题
如果遇到权限问题，可能需要使用 sudo：
sudo npm install -g claude-code
🌐 网络问题
如果遇到网络问题，可以使用国内镜像源：
npm install -g claude-code --registry=https://registry.npmmirror.com
3
验证安装
安装完成后，运行以下命令检查安装是否成功：
claude doctor
✅ 验证成功
如果安装成功，您将看到：
- Claude Code 版本信息
- 系统环境检查结果
- Node.js 和 npm 版本
- 配置文件路径
查看版本号：
claude --version
4
配置 API Key
首次使用需要配置 API Key 和 Base URL。
🔑 获取配置信息
直接使用我提供的 API Base URL 和 API Key
使用 zcf 配置（支持自定义 Base URL）
🚀 推荐使用 zcf 配置
zcf 提供更灵活的配置方式，支持自定义 API Base URL 和多种 API Key 配置，适合使用代理或第三方服务的场景
运行 zcf 配置命令：
npx zcf
按照交互式提示配置：
- API Base URL：自定义 API 端点（如代理地址或第三方服务）
- API Key：您的 Anthropic API Key 或第三方服务密钥
- 模型选择：可指定默认使用的模型版本
💡 使用场景
适合使用 zcf 的情况：
- 需要通过代理访问 Claude API
- 使用第三方 Claude API 服务
- 需要自定义 API 端点地址
- 企业内部部署的 API 网关
配置示例：
# 示例：配置自定义 Base URL
API Base URL: https://your-proxy.com/v1
API Key: sk-ant-your-api-key-here
Default Model: claude-sonnet-4.5
📸 配置流程图解：
步骤 1
在终端中运行 npx zcf 命令，启动配置向导
步骤 2
选择配置类型，必须选择自定义配置
步骤 3
输入 API Base URL，使用我提供的地址
步骤 4
输入 API Key，使用我提供的密钥
步骤 5
确认模型选择 claude-sonnet-4.5
步骤 6
配置完成！系统会显示配置摘要，您可以开始使用 Claude Code
⚠️ 注意事项
- 确保自定义 Base URL 地址正确且可访问
- Base URL 通常以 /v1 结尾
- 使用第三方服务时，请确认服务提供商的可靠性
- 配置完成后，建议使用 claude doctor 验证连接
🔒 安全提示
无论使用哪种配置方式：
- API Key 存储在本地，不会上传到云端
- 请妥善保管您的 API Key，不要分享给他人
- 定期更换 API Key 以确保账户安全
- 不要在公共代码仓库中提交配置文件
5
开始使用
基本命令：
1. 启动 Claude Code：
claude
2. 在特定项目目录启动：
cd /path/to/your/project
claude
3. 查看帮助信息：
claude --help
💡 使用技巧
- 使用 / 查看所有可用的斜杠命令
- Claude Code 会自动读取项目文件，理解代码上下文
- 支持连续对话，逐步完善代码
- 危险操作（如删除文件）会要求二次确认
6
核心功能
Claude Code 提供强大的 AI 编程辅助能力：
📝 代码生成
智能生成高质量代码，支持多种编程语言
🔍 代码分析
深度理解代码库结构和逻辑
🐛 调试助手
快速定位和修复代码问题
📚 文档生成
自动生成项目文档和注释
♻️ 代码重构
优化代码结构，提升代码质量
🧪 测试编写
自动生成单元测试和集成测试
🌟 支持的编程语言
Claude Code 支持几乎所有主流编程语言，包括但不限于：
JavaScript、TypeScript、Python、Java、Go、Rust、C++、C#、Ruby、PHP、Swift、Kotlin 等