Claude Code 从零开始教程：10 分钟跑通你的第一行 AI 代码

Claude Code 从零开始教程：10 分钟跑通你的第一行 AI 代码

本教程介绍如何在 Claude Code 中通过 CodeGateway 接入 Anthropic 的 Claude 模型。Claude Code 是 Anthropic 推出的命令行编码助手——把它指向 CodeGateway，请求就会被转发到 Claude 模型。

一句话：适合谁读：从来没写过代码、或只接触过一点点编程的人。读完你会知道 Claude Code 是什么、能做什么、怎么装上、怎么让它给你写首个程序。每一步都有截图，所有专有名词都有"人话"注解。

目录

1. 先用一个比喻搞清楚 Claude Code 是什么
2. 开始之前你需要什么
3. 首步：安装 Node.js（约 3 分钟）
4. 第二步：安装 Claude Code（约 1 分钟）
5. 第三步：注册 CodeGateway 拿到钥匙（约 2 分钟）
6. 第四步：把钥匙交给 Claude Code（约 2 分钟）
7. 第五步：发出你的第一条指令（约 2 分钟）
8. 常见疑问与处理
9. 接下来可以学什么

先用一个比喻搞清楚 Claude Code 是什么

把"写程序"想象成"在厨房做菜"：

• 平时你自己看菜谱、备菜、切菜、下锅，每一步都是手动。
• Claude Code 像一位会写代码的助手坐在厨房里。你说："帮我做一份番茄炒蛋"，它会自己找菜谱、切菜、下锅，最后端给你一盘菜。

放回程序员的世界：

• "厨房" = 你电脑上的一个文件夹
• "菜" = 你想做出来的程序、网页、脚本
• "Claude Code" = 一个会写代码、会跑命令、会改文件的 AI 助手

它不是网页 ChatGPT 那种只能"打字回复"的形态，而是真的能在你电脑上动手做事。所以你需要给它两样东西：

1. 一个能让它动手的环境（你的电脑 + 一些基础软件）
2. 一把通信钥匙（API Key，让它能和 AI 模型说话）

在任意项目目录运行 claude，即可让 Claude 帮你写代码。所有请求都会经 CodeGateway 路由，按 token 用量阶梯计费（详见 /pricing）。

开始之前你需要什么

完全不需要：会编程、有信用卡（CodeGateway 邮箱注册即可）。

Windows 用户特别提示：本教程的命令在 macOS / Linux / WSL2 都能跑。原生 Windows 命令行（cmd / PowerShell）也能跑大部分命令，但强烈建议装 WSL2（一个让 Windows 跑 Linux 的工具，免费）。本文之后命令以 Linux / macOS 风格为准。

首步：安装 Node.js（约 3 分钟）

Node.js 是什么？：一个让你电脑能跑 JavaScript 代码的"环境"。Claude Code 是用 JavaScript 写的，所以需要它。

macOS 用户

打开"终端"（应用程序 → 实用工具 → 终端，或直接 Spotlight 搜 "terminal"），粘贴：

# 装 Homebrew（如果没装过的话）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 装 Node.js
brew install node

截图占位：终端里运行 brew install node 的过程。

Windows 用户（WSL2 / Ubuntu）

打开"Ubuntu"应用，输入：

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

Linux 用户

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

验证装好没

node --version

输出形如 v20.x.x 即可。只要数字开头是 18 或更高就行。

出问题？跳到常见疑问。

第二步：安装 Claude Code（约 1 分钟）

继续在终端里：

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

npm 是什么？：跟着 Node.js 一起装上的一个"软件管家"。install -g 就是"全局安装这个软件"。

装完验证：

claude --version

截图占位：终端输出 claude --version 的版本号。

如果看到版本号说明 OK。看到 command not found: claude，参见常见疑问。

第三步：注册 CodeGateway 拿到钥匙（约 2 分钟）

Claude Code 要工作，必须能和 AI 模型说话。说话需要一把"钥匙" —— API Key。我们用 CodeGateway 来拿这把钥匙，原因有两个：

• 邮箱注册即可，不需要绑国际信用卡
• 新账号自动送 $2 体验额度，足够你跟着本教程跑通整个流程

操作步骤

1. 打开 https://www.codegateway.dev
2. 点右上角"注册"，填邮箱 + 密码
3. 邮箱收到验证邮件，点链接激活
4. 登录后进入"Dashboard"
5. 找到"API Keys"，点"Create Key"
6. 给 Key 起个名字（比如 my-first-key），点"创建"
7. 屏幕上会出现一串以 sk-cg- 开头的字符串 —— 这就是你的钥匙

截图占位：API Key 创建完成，钥匙展示在屏幕上。

重要：

• 这串钥匙只会展示一次。立刻复制保存到一个安全的地方（密码管理器、加密备忘录都行）。
• 不要发给任何人，不要上传到网盘 / 公开仓库。如果不小心泄露了，回到 CodeGateway Dashboard 删掉旧 Key 重生成一个就行。

第四步：把钥匙交给 Claude Code（约 2 分钟）

Claude Code 是从两个"环境变量"里读这把钥匙的，名字分别叫 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY。

环境变量是什么？：你可以把它想象成贴在终端门口的便签：终端启动的每个程序进门时都会看一眼便签上的内容。

macOS / Linux 用户

终端里运行：

echo 'export ANTHROPIC_BASE_URL="https://api.codegateway.dev"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-cg-把你刚才复制的钥匙粘到这里"' >> ~/.zshrc
source ~/.zshrc

如果你的终端是 bash（macOS 旧版本默认是 bash），把 ~/.zshrc 全部换成 ~/.bashrc 即可。

截图占位：粘贴并执行三行命令的过程。

Windows WSL 用户

跟 Linux 一样。

验证钥匙生效

echo $ANTHROPIC_API_KEY

应该回显出你的钥匙。如果只回显空行，说明刚才的命令哪一步出了岔，重新粘贴一次。

第五步：发出你的第一条指令（约 2 分钟）

创建一个空文件夹

mkdir hello-claude
cd hello-claude

mkdir = make directory（建文件夹）；cd = change directory（进文件夹）。

启动 Claude Code

claude

终端会进入一个对话界面（像 ChatGPT 但在你电脑上）。

截图占位：Claude Code 启动后的欢迎界面。

发出第一条指令

把这段话粘进去回车：

请在当前文件夹里创建一个 Python 文件 hello.py，
内容是打印 "Hello, Claude Code!"，
然后告诉我怎么运行它。

接下来你会看到 Claude Code：

1. 主动写一个 hello.py
2. 输出运行命令：python hello.py
3. 可能还会告诉你需要先装 Python 或解释代码

截图占位：Claude Code 写文件 + 输出运行命令的对话过程。

跑一下试试

退出 Claude Code（按两次 Ctrl+C，或输入 /exit），然后：

python3 hello.py

终端打印 Hello, Claude Code! —— 恭喜，你的第一行 AI 写的代码跑起来了。

没有装 Python？macOS 大多自带 python3，Windows / Linux 用 apt install python3 或 brew install python 装一下。

常见疑问与处理

Q：`node --version` 显示 `command not found`。 A：说明 Node.js 没装上。再跑一次首步的安装命令。如果用 brew 报错，可能要先重启终端或加 brew 到 PATH（按报错提示操作即可）。

Q：`npm install -g` 报权限错误。 A：macOS / Linux 加 sudo：sudo npm install -g @anthropic-ai/claude-code。Windows WSL 同理。

Q：`claude --version` 显示 `command not found`。 A：- 关掉终端再开一个新窗口（让 PATH 重新读）

• 检查 npm config get prefix 输出的路径是否在你的 PATH 里
• 实在不行，重装：npm uninstall -g @anthropic-ai/claude-code && npm install -g @anthropic-ai/claude-code

Q：Claude Code 启动后报 401 / Unauthorized。 A：钥匙没生效。检查：

• echo $ANTHROPIC_API_KEY 能否正常输出
• 是否复制时多了空格 / 漏了字符
• 是否漏写了 export 关键字
• 改完别忘记 source ~/.zshrc（或 .bashrc）

Q：Claude Code 启动后一直转圈不响应。 A：大概率网络问题。试：

• 浏览器打开 https://www.codegateway.dev 看能否打开
• 切换到手机热点试一次
• 还不行参见Claude Code 连接超时排查

Q：钥匙丢了 / 不小心发到群里了。 A：Dashboard → API Keys → 找到那把 Key → Delete → 重新 Create 一把。1 秒搞定。

Q：$2 额度用完了怎么办？ A：- 想继续学：Dashboard → Topup 充 $5–$10 起步够用很久

• 不想付费：每个新邮箱注册都送 $2，但不要用一次性邮箱注册多个账号刷额度，违反服务条款会被封号

Q：能不能用网页版完成全部步骤？ A：Claude Code 是命令行工具，必须在终端里用。如果你完全不想碰终端，可以用 Anthropic 的官方网页版 Claude.ai —— 但那是另一个产品，不是本文讲的 Claude Code。

Q：跟着做完发现自己其实不感兴趣怎么办？ A：没关系。你已经学会了三件事：用终端、装一个全局软件、读懂环境变量。这三件事在很多其他场合都有用。Claude Code 也不会乱花钱 —— 你不主动让它工作就不会扣额度。

接下来可以学什么

跑通了第一行代码只是开始。接下来按兴趣选：

• 想知道 Claude Code 都能做什么 → Claude Code 完整配置指南
• 经常遇到连接问题 → Claude Code 连接超时排查指南
• 想用得更专业 → Claude Code 进阶技巧与佳实践
• 想了解收费规则 → 充值费用指南 + 阶梯倍率详解
• 想对比其他 AI 编程工具 → Claude Code vs Cursor vs GitHub Copilot

如果在本教程的任何一步卡住，欢迎到反馈页留言，我们会持续根据真实卡点优化文档。

入门门槛比想象中低。把今天的钥匙留着，几天后回来再玩两个小项目（让 Claude Code 写一个简单网页、写一个抓取脚本），熟悉感就会自然建立起来。

参考资料

Claude Code 官方文档 · Anthropic API 参考