ClaudeCode 入门教程
ClaudeCode
用一句命令让 AI 在你终端里写代码——这篇教程帮你从零拿到一把 Claude Code 钥匙,无需折腾依赖,开箱即用。
共 8 步 · 约 16 分钟
1
2min准备工作
- 操作系统:Windows 10+、macOS 12+ 或主流 Linux 发行版(Ubuntu 20.04+ 等)
- 网络:能正常访问 GitHub 和 api.anthropic.com
- Anthropic API Key(推荐):如果还没有,可在初始化过程中根据提示免费注册获取(通常新账户享有试用额度),无需提前准备
- 官方发布页:https://github.com/anthropics/claude-code/releases
2
2min前往 GitHub 下载页面

- 打开上面的链接,找到最新的 Release(通常顶部第一个)。
- 在 Assets 区域,根据你的系统选择文件:
- Windows:
claude-code-windows-amd64.exe(可能以.msi形式提供,请按显示为准) - macOS:
claude-code-darwin-amd64(Apple Silicon 选claude-code-darwin-arm64) - Linux:
claude-code-linux-amd64
- Windows:
- 点击文件名开始下载,保存到你能记住的位置。
3
2min运行安装包
📸 [shot:windows-installer] 截取 Windows 安装向导的“正在安装”或“完成”界面
- 双击下载的安装程序文件(
.exe或.msi),弹出安装向导。 - 一路点击 Next,保持默认安装路径,在提示是否加入 PATH 时确保 勾选(通常已默认勾选)。
- 点击 Install,等待进度条走完,点击 Finish 完成安装。
4
2min初次启动并配置
📸 [shot:first-launch] 截取终端里
claude命令后出现的欢迎界面和 API Key 提示
- 打开终端,输入
claude并回车,首次运行会进入配置流程。 - 当看到提示“Enter your Anthropic API key”时:
- 如果你已经有 Key,直接粘贴后按回车。
- 如果没有,请不要跳过;按照屏幕提示打开浏览器注册或登录 Anthropic 账户,新用户通常可立即获得免费试用额度。完成后,将生成的 API Key 粘贴回终端。
- 接着按提示选择默认模型(推荐 Claude 3.5 Sonnet),等待初始化完成。
5
2min验证安装
📸 [shot:version-check] 截取终端执行
claude --version后显示的版本号信息
- 新开一个终端窗口(确保环境变量生效)。
- 输入以下命令查看版本号:
bash
claude --version - 如果看到类似
claude-code version 0.3.x的输出,说明安装成功且命令可全局使用。
6
2min🎉 结果展示
现在,直接在终端里输入 claude,回车后就能进入交互式编码会话。试试:
bash
claude "用 Python 写一个读取 CSV 并打印前10行的脚本"AI 会立刻生成代码,并询问你是否在终端运行。
7
2min进阶技巧
1. 设置别名,一键唤出
- Windows(PowerShell):在
$PROFILE中添加:powershellSet-Alias cc claude - macOS / Linux:在
~/.bashrc或~/.zshrc中添加:之后用bashalias cc='claude'cc就能启动 Claude Code。
2. 静默升级到最新版
随时执行 claude upgrade 即可自动检测并安装最新版本,无需重复手动下载。(以实际 CLI 支持情况为准)
8
2min常见问题
| 问题 | 原因 | 解决 |
|---|---|---|
终端提示 command not found: claude | 安装路径未加入 PATH | 重新打开终端,或手动添加安装目录到 PATH(Windows 用户请检查安装时是否勾选“Add to PATH”) |
claude --version 无反应或报错 | 环境变量未生效,或安装不完整 | 关闭所有终端后重试;若仍失败,请重新安装 |
| 提示 “API key is invalid” | Key 输入错误或已过期 | 检查 Key 是否完整粘贴,或在 Anthropic Console 重新生成 |
| 免费额度用完后无法使用 | 试用额度用完,需要绑定付费 Key | 在终端执行 claude config set apiKey <your-key> 更新密钥 |
| Linux 下提示权限拒绝 | 未赋予执行权限 | 重新执行 sudo chmod +x /usr/local/bin/claude |
别等 IDE 启动了——现在就在终端里用一句 claude,把脑中的逻辑变成屏幕上的代码。装上它,你才会发现原来命令行里的 AI 编程可以这么丝滑。