前言

在 AI 编程工具层出不穷的当下，Claude Code 凭借其独特的 “代理式开发” 模式异军突起。本文从安装配置到实战案例，手把手教你快速上手这款工具，看完就能用！

一、Claude Code 与 Cursor 的核心差异

用过 Cursor 的开发者都知道，它更像是 “AI 辅助敲代码”—— 你需要明确指令才能得到反馈。而Claude Code 完全不同：

• 你只需提出项目目标，它会自动拆解任务、规划步骤

• 支持自主调试代码、优化逻辑

• 能记住项目上下文，无需反复重复需求

二、安装配置全流程（附避坑指南）

1. 环境准备

必须安装 Node.js 18+，否则会报错！

• 下载地址：Node.js 官方下载

• 验证命令：

node -v # 输出v18.x.x即为合格

Windows 用户注意：必须启用 WSL2

# 管理员身份运行PowerShell

wsl --install # 自动安装Ubuntu子系统，重启后打开Ubuntu完成初始化

2. 安装 Claude Code

一行命令搞定全局安装：

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

验证安装：

claude -v # 显示版本号即成功

3. 账户配置与免费额度获取

（1）登录方式选择

首次运行claude会出现两种登录选项：

• 订阅账户（Pro/Max 套餐）：适合长期使用

• API 密钥登录：按使用量计费，推荐新人先选这个，但是因为ip会有被封的风险

这时候我们可以打开浏览器 → 进入 Claude Code官方共享平台 - 中国用户专属AI编程助手 ，完成邮箱/手机号注册，填入我的邀请码GBAYO0可额外获得2000积分

注：新用户可获免费额度，足够日常开发使用

创建API密钥
登录后台 → 导航至 API密钥 → 点击 创建API秘钥

• 密钥格式：sk-xxxxxxxxxxxxxxxx
• 务必保存密钥（关闭页面后不可查看）
• 

（3）终端配置

1.临时版（每次打开终端都要做）

# 设置中转地址

$env:ANTHROPIC_BASE_URL = "https://api.aicodemirror.com/api/claudecode"

# 保存配置

$env:ANTHROPIC_API_KEY = "你的实际密钥"  
$env:ANTHROPIC_AUTH_TOKEN = "你的实际令牌"

2.永久版

1. 打开 “系统属性”：在桌面上右键点击 “此电脑”，选择 “属性”，然后在弹出窗口的左侧选择 “高级系统设置”。
2. 配置环境变量：在 “系统属性” 窗口的 “高级” 选项卡下，点击 “环境变量” 按钮。在 “系统变量” 部分，点击 “新建”。

   • 对于ANTHROPIC_BASE_URL，变量名处输入ANTHROPIC_BASE_URL，变量值处填入https://api.aicodemirror.com/api/claudecode。
   • 对于ANTHROPIC_API_KEY，新建变量，变量名设为ANTHROPIC_API_KEY，变量值填入你的实际密钥。
   • 对于ANTHROPIC_AUTH_TOKEN，同样新建变量，变量名设为ANTHROPIC_AUTH_TOKEN，变量值填入你的实际令牌。

3. 完成设置后，一路点击 “确定” 保存设置。之后重启你的终端，新配置就会生效。

避坑提示：

• 用中转前必须先/logout退出原有登录

• 敏感项目不要用第三方中转，有数据风险

三、必学斜杠命令

命令	作用
/config	打开配置面板
/help	查看所有命令说明
/run	执行当前项目代码
/test	运行测试用例
/clear	清空对话历史

四、核心功能实战

1. 上下文记忆（CLAUDE.md）

在项目根目录创建该文件，示例内容：

# 项目规范

- 编程语言：JavaScript（ES6标准）

- 代码风格：使用单引号、结尾不加逗号

- 必须包含单元测试

Claude 会自动遵循这些规则，无需反复提醒。

2. 图像识别功能

前端开发者福音：

1. 截图 UI 设计稿（Ctrl+C 复制）

1. 在 Claude 终端粘贴（右键）

1. 输入指令：“生成这个界面的 HTML+CSS 代码”

五、实战案例：开发待办应用

需求描述

创建一个待办列表Web应用，要求：

1. 支持添加/删除/标记完成功能

2. 数据本地存储

3. 响应式设计

开发过程

1. 创建项目文件夹：

mkdir todo-app && cd todo-app

claude # 启动工具

1. 输入上述需求，Claude 自动生成：

• • index.html（页面结构）

• • style.css（响应式样式）

• • app.js（核心逻辑）

• • 本地存储代码段

1. 运行测试：

/run # 自动启动服务，打开浏览器预览

1. 优化迭代：

输入 “添加待办事项排序功能”，Claude 会自动修改 app.js 并提示变更点。

六、使用总结

1. 优势：

• • 适合复杂项目开发，节省 70% 规划时间

• • 上下文记忆能力强，无需重复需求

• • 终端 + IDE 联动流畅

1. 注意事项：

• • 复杂需求建议分步骤提出

• • 定期用/save保存对话历史

结语

Claude Code 不是简单的代码生成器，而是真正能和你 “协作开发” 的 AI 伙伴。如果你受够了反复调试、重复编码，建议试试这款工具！