加载中…
完全没写过代码？也能用 Claude Code。零术语 + 全流程截图，10 分钟完成安装、配置、跑出第一个 AI 写的程序。
本教程介绍如何在 Claude Code 中通过 CodeGateway 接入 Anthropic 的 Claude 模型。Claude Code 是 Anthropic 推出的命令行编码助手——把它指向 CodeGateway，请求就会被转发到 Claude 模型。
一句话：适合谁读：从来没写过代码、或只接触过一点点编程的人。读完你会知道 Claude Code 是什么、能做什么、怎么装上、怎么让它给你写首个程序。每一步都有截图，所有专有名词都有"人话"注解。
把"写程序"想象成"在厨房做菜"：
放回程序员的世界：
它不是网页 ChatGPT 那种只能"打字回复"的形态，而是真的能在你电脑上动手做事。所以你需要给它两样东西：
在任意项目目录运行 claude，即可让 Claude 帮你写代码。所有请求都会经 CodeGateway 路由，按 token 用量阶梯计费（详见 /pricing）。
项目 | 要求 | 你大概率已经有 |
|---|---|---|
一台电脑 | macOS / Windows / Linux | ✓ |
网络 | 能正常上网 | ✓ |
一个邮箱 | 用来注册账号 | ✓ |
一点耐心 | 10–15 分钟 | ✓ |
完全不需要：会编程、有信用卡（CodeGateway 邮箱注册即可）。
Windows 用户特别提示：本教程的命令在 macOS / Linux / WSL2 都能跑。原生 Windows 命令行（cmd / PowerShell）也能跑大部分命令，但强烈建议装 WSL2（一个让 Windows 跑 Linux 的工具，免费）。本文之后命令以 Linux / macOS 风格为准。
Node.js 是什么？：一个让你电脑能跑 JavaScript 代码的"环境"。Claude Code 是用 JavaScript 写的，所以需要它。
打开"终端"（应用程序 → 实用工具 → 终端，或直接 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 的过程。
打开"Ubuntu"应用，输入：
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs# Ubuntu / Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejsnode --version输出形如 v20.x.x 即可。只要数字开头是 18 或更高就行。
出问题？跳到常见疑问。
继续在终端里：
npm install -g @anthropic-ai/claude-codenpm 是什么？：跟着 Node.js 一起装上的一个"软件管家"。install -g 就是"全局安装这个软件"。
装完验证：
claude --version截图占位：终端输出 claude --version 的版本号。
如果看到版本号说明 OK。看到 command not found: claude，参见常见疑问。
Claude Code 要工作，必须能和 AI 模型说话。说话需要一把"钥匙" —— API Key。我们用 CodeGateway 来拿这把钥匙，原因有两个：
my-first-key），点"创建"sk-cg- 开头的字符串 —— 这就是你的钥匙截图占位：API Key 创建完成，钥匙展示在屏幕上。
重要：
Claude Code 是从两个"环境变量"里读这把钥匙的，名字分别叫 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY。
环境变量是什么？：你可以把它想象成贴在终端门口的便签：终端启动的每个程序进门时都会看一眼便签上的内容。
终端里运行：
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 即可。
截图占位：粘贴并执行三行命令的过程。
跟 Linux 一样。
echo $ANTHROPIC_API_KEY应该回显出你的钥匙。如果只回显空行，说明刚才的命令哪一步出了岔，重新粘贴一次。
mkdir hello-claude
cd hello-claudemkdir = make directory（建文件夹）；cd = change directory（进文件夹）。
claude终端会进入一个对话界面（像 ChatGPT 但在你电脑上）。
截图占位：Claude Code 启动后的欢迎界面。
把这段话粘进去回车：
请在当前文件夹里创建一个 Python 文件 hello.py，
内容是打印 "Hello, Claude Code!"，
然后告诉我怎么运行它。接下来你会看到 Claude Code：
hello.pypython hello.py截图占位：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-codeQ：Claude Code 启动后报 401 / Unauthorized。 A：钥匙没生效。检查：
echo $ANTHROPIC_API_KEY 能否正常输出export 关键字source ~/.zshrc（或 .bashrc）Q：Claude Code 启动后一直转圈不响应。 A：大概率网络问题。试：
Q：钥匙丢了 / 不小心发到群里了。 A：Dashboard → API Keys → 找到那把 Key → Delete → 重新 Create 一把。1 秒搞定。
Q：$2 额度用完了怎么办？ A：- 想继续学：Dashboard → Topup 充 $5–$10 起步够用很久
Q：能不能用网页版完成全部步骤？ A：Claude Code 是命令行工具，必须在终端里用。如果你完全不想碰终端，可以用 Anthropic 的官方网页版 Claude.ai —— 但那是另一个产品，不是本文讲的 Claude Code。
Q：跟着做完发现自己其实不感兴趣怎么办？ A：没关系。你已经学会了三件事：用终端、装一个全局软件、读懂环境变量。这三件事在很多其他场合都有用。Claude Code 也不会乱花钱 —— 你不主动让它工作就不会扣额度。
跑通了第一行代码只是开始。接下来按兴趣选：
如果在本教程的任何一步卡住，欢迎到反馈页留言，我们会持续根据真实卡点优化文档。
入门门槛比想象中低。把今天的钥匙留着，几天后回来再玩两个小项目（让 Claude Code 写一个简单网页、写一个抓取脚本），熟悉感就会自然建立起来。