网飞笔记

主题

Claude Code 安装与使用指南 ​

Claude Code 是 Anthropic 推出的编程助手，运行在电脑终端中。你告诉它想完成的事情，它可以先读懂当前项目，再在你确认后修改代码、运行测试或解释报错。本文不要求你会编程，跟着步骤做即可。

📌 写在前面 ​

  • Claude Code 和 Claude 网页版不一样。 Claude 网页版用来聊天；Claude Code 装在电脑上，能在你授权后读取当前项目文件、执行命令。
  • 它不是「一键自动做完一切」。 最稳妥的用法是：先让它解释项目，再让它给出计划，确认后才允许修改。
  • 每次对话都需要联网。 推荐通过 AWS Bedrock 或 Cloudflare AI Gateway 中转接入，比直连 Anthropic 服务器更稳定，国内网络兼容性更好。
  • 推荐使用第三方中转 API，比如 AWS Bedrock 或 Cloudflare AI Gateway，无需使用官方 Claude.ai 账户直连，稳定性更高。

🌐 网络推荐：Claude Code 需要稳定访问 Anthropic 服务器完成登录与对话，推荐使用 NetFlow —— CN2GIA 三网优化直连，节点稳定、速度快，登录卡住或对话超时大多是网络问题，稳定节点即可解决。

👉 获取 NetFlow 订阅

🧰 开始前要准备什么 ​

需要准备说明
操作系统macOS 13+、Windows 10 1809+ / Windows 11、Ubuntu 20.04+ / Debian 10+ 等主流 Linux 发行版
硬件4GB 以上内存，x64 或 ARM64 处理器
网络能稳定访问 Anthropic 服务器（见上方网络推荐）
一个代码项目文件夹网站、App、小程序或 GitHub 克隆下来的项目都可以
API 访问凭证推荐使用 AWS Bedrock（需 AWS 账户并申请 Claude 访问权限）或 Cloudflare AI Gateway（需 Anthropic API Key）；不推荐直接用官方 Claude.ai 账户直连
终端macOS 用「终端」，Windows 用 PowerShell（或 Git Bash），Linux 用系统终端

本文中的命令请整行复制到终端，再按 Enter 回车。不要把命令粘贴到浏览器搜索框、微信聊天框或代码文件中。

🚀 第一步：安装 Claude Code ​

方式一：官方原生安装脚本（推荐，无需提前装 Node.js） ​

macOS / Linux：

bash
curl -fsSL https://claude.ai/install.sh | bash

Windows（PowerShell）：

powershell
irm https://claude.ai/install.ps1 | iex

安装完成后关闭终端、重新打开，让命令生效。原生安装的版本以后会自动在后台更新。

方式二：已安装 Node.js 18+ 的用户，可用 npm 安装 ​

国内用户前置操作： 先配置npm镜像源以防下载卡死：

bash
npm config set registry https://registry.npmmirror.com
bash
npm install -g @anthropic-ai/claude-code

⚠️ 不要在命令前加 sudo，也不要用 sudo npm install -g，容易造成以后升级、权限混乱。

💡 国内网络提速：如果 npm 安装时速度很慢或超时，可先切换到淘宝镜像源：

bash
npm config set registry https://registry.npmmirror.com

方式三：macOS 用户也可用 Homebrew ​

bash
brew install --cask claude-code

验证安装 ​

打开终端，输入：

bash
claude --version

再输入：

bash
claude doctor

claude --version 显示版本号、claude doctor 没有报错，就说明 CLI 已经安装好。

🔐 第二步：配置 API 连接 ​

推荐使用第三方中转 API 接入 Claude Code，不推荐直接使用 Claude.ai 官方账户连接。常见的两种方式：

⚠️ 国内用户重要提示：如果你直接运行 claude 并选择登录 Anthropic 官方账号，在国内网络直连时，该官方账号有极高概率在 24 小时内被封禁！最安全的方式是使用第三方中转 API，完全不需要官方 Claude.ai 账号。

⚠️ 国内IP直连Anthropic官方账户，90%以上概率在24小时内被封禁，请务必通过第三方中转API接入。

方式三：第三方中转 API（OpenRouter 等，适合国内用户） ​

如果你有 OpenRouter 或其他国内可访问的第三方中转 API Key，可以通过设置环境变量直接使用，无需官方 Anthropic 账号：

macOS / Linux：

bash
# 在 ~/.zshrc 或 ~/.bashrc 末尾添加以下两行
export ANTHROPIC_BASE_URL="https://your-relay-domain.com/v1"
export ANTHROPIC_API_KEY="your-relay-api-key"

保存后执行 source ~/.zshrc（或重启终端）使配置生效。

Windows（PowerShell）：

powershell
$env:ANTHROPIC_BASE_URL = "https://your-relay-domain.com/v1"
$env:ANTHROPIC_API_KEY = "your-relay-api-key"

或将其永久写入 ~/.claude/settings.json：

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://your-relay-domain.com/v1",
    "ANTHROPIC_API_KEY": "your-relay-api-key"
  }
}

配置好环境变量后，直接运行 claude 即可，无需额外登录。

AWS Bedrock 托管了多个版本的 Claude 模型，稳定性强，适合个人和团队使用。

前提： 已开通 AWS 账户，并在 AWS Bedrock 控制台 申请了 Claude 模型的访问权限。

  1. 在本地配置好 AWS 凭证（通过 aws configure 命令，或设置 AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY 环境变量）；
  2. 在终端设置以下环境变量后启动：
bash
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1   # 替换为你申请了 Claude 访问权限的 AWS 区域
claude

方式二：Cloudflare AI Gateway ​

Cloudflare AI Gateway 作为请求代理，将请求转发至 Anthropic API，适合已有 Anthropic API Key 的用户，在 Cloudflare 控制台可看到完整的请求日志和用量统计。

  1. 在 Cloudflare 控制台 → AI Gateway 创建一个新网关，记录网关地址；
  2. 在终端设置环境变量后启动：
bash
export ANTHROPIC_BASE_URL=https://gateway.ai.cloudflare.com/v1/账户ID/网关名/anthropic
export ANTHROPIC_API_KEY=your-api-key
claude

或在 ~/.claude/settings.json 中永久保存，避免每次手动设置：

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gateway.ai.cloudflare.com/v1/账户ID/网关名/anthropic",
    "ANTHROPIC_API_KEY": "your-api-key"
  }
}

连接成功后，终端会显示 Claude 的对话提示，即可开始使用。

方式三：Shell配置文件持久化（开发者推荐） ​

在 ~/.zshrc 或 ~/.bashrc 末尾添加：

bash
export ANTHROPIC_BASE_URL=你的中转API地址
export ANTHROPIC_API_KEY=你的API密钥

然后执行 source ~/.zshrc 使其生效。

📂 第三步：进入你的项目文件夹 ​

和所有终端编程助手一样，Claude Code 必须在正确的项目文件夹中启动。

macOS / Linux ​

  1. 在 Finder 或文件管理器中找到你的项目文件夹。
  2. 回到终端，输入 cd 后留一个空格，先不要按 Enter。
  3. 用鼠标把项目文件夹拖进终端窗口，路径会自动出现。
  4. 按 Enter。
  5. 输入：
bash
pwd

确认输出路径末尾是你的项目文件夹名称。

Windows Git Bash ​

  1. 在资源管理器中打开项目文件夹。

  2. 点击地址栏，复制文件夹完整路径，例如 C:\Users\你的用户名\Desktop\我的项目。

  3. 在 Git Bash 输入 cd（注意后面有一个空格），再粘贴路径并按 Enter。例如：

    bash
    cd "/c/Users/你的用户名/Desktop/我的项目"

  4. 输入 pwd，确认最后显示的是你的项目目录。

进入正确目录后再运行：

bash
claude

🔒 第四步：先了解权限模式，用得更放心 ​

Claude Code 修改文件、执行命令前默认会向你确认。按 Shift + Tab 可以在几种模式间切换，新手建议只用前两种：

模式行为适合场景
Default（默认）每次编辑文件、执行命令都会询问新手日常使用，最保险
Plan（计划模式）只读分析、给出计划，不做任何修改想先了解项目或方案时
Accept Edits（自动接受编辑）自动应用文件修改，命令执行仍会询问已确认过计划、想少点几次确认
Bypass Permissions（跳过全部确认）不再询问，直接执行不建议新手使用，仅用于你完全信任的沙盒环境

🧭 第五步：第一次怎么问，才不容易出错 ​

第一次不要直接说“帮我把项目做好”。推荐分三轮提问。

第 1 轮：只让它了解项目 ​

复制下面文字发送给 Claude Code：

text
请先阅读这个项目的 README、目录结构和 package.json，不要修改任何文件。
用中文告诉我：项目是做什么的、如何本地启动、修改后要运行什么检查。

第 2 轮：让它先给计划 ​

例如你想改首页文字，就输入：

text
我想把首页标题改得更简洁。请先告诉我需要修改哪个文件、准备改成什么，不要立刻修改。

第 3 轮：确认后才让它改 ​

当它给出的计划符合你的想法时，再发送：

text
可以，按刚才的方案修改。完成后运行项目已有的检查或构建命令，并把改动文件和结果列出来。

⚠️ 如果它计划改动的文件明显超出你的要求，直接说“不要改这些文件，请缩小范围并重新给计划”。不要因为它说得很专业就立刻确认。

📝 第六步：给项目建立长期说明（可选） ​

当你已经确认 Claude Code 能正确理解项目后，可以在 Claude Code 对话里输入：

text
/init

它会生成一个叫 CLAUDE.md 的项目说明文件，通常用来记录项目结构、启动命令、测试命令和编码约定。

生成后请做两件事：

  1. 打开 CLAUDE.md 看一遍，删掉不准确的内容；
  2. 如果这份说明对团队成员也有用，再把它和普通代码一样审查、提交。

不要把密码、Token、账号、服务器 IP 或付费信息写进 CLAUDE.md。如果想让 Claude Code 完全不去读取某些敏感文件，可以在项目里新建 .claude/settings.json，加入：

json
{
  "permissions": {
    "deny": ["Read(./.env)", "Read(./secrets/**)"]
  }
}

✅ 第七步：修改完成后怎么检查 ​

Claude Code 说“完成了”以后，按这 5 步自己确认：

  1. 查看它说改了哪些文件；

  2. 在终端输入：

    bash
    git status
git diff

  3. git status 会显示改动文件，git diff 会显示每一行修改；

  4. 运行它建议的启动、测试或构建命令，亲自检查页面或功能；

  5. 没问题再提交代码、推送或部署。

如果项目不是 Git 仓库，也可以在 VS Code 等编辑器的“源代码管理”或“更改”面板查看修改过的文件。

🛠️ 常用操作 ​

你想做什么怎么做
在当前项目开始对话在项目目录输入 claude
带着任务直接打开输入 claude "帮我解释这个项目"
继续最近一次对话输入 claude -c
恢复指定历史对话输入 claude -r 或 claude --resume
切换模型会话中输入 /model
查看或修改权限规则会话中输入 /permissions
管理 MCP 扩展工具会话中输入 /mcp
清空当前上下文会话中输入 /clear
快速切换权限模式按 Shift + Tab
检查安装和环境输入 claude doctor
更新 Claude Code输入 claude update
中断当前操作按 Ctrl + C

🔁 常见问题（FAQ） ​

Q：国内网络能直接用吗？
A：Claude Code 需要联网访问 Anthropic 服务器，国内网络直连通常无法登录或会频繁超时，建议使用稳定的海外网络节点，见文章开头的「网络推荐」。

Q：输入 claude 后提示找不到命令？
A：先关闭并重新打开终端；用 npm 安装的用户需确认 node --version 能正常显示版本号；仍不行就重新运行安装命令，不要随意加 sudo。

Q：安装时出现权限错误怎么办？
A：不要用 sudo 强行安装。优先使用官方原生安装脚本，它不依赖系统级的 npm 全局目录，能避免大多数权限问题。

Q：不用官方账户，直接用 API Key 可以吗？
A：可以，也是推荐做法。通过 AWS Bedrock 或 Cloudflare AI Gateway 等第三方中转接入，稳定性比直连 Anthropic 服务器更高，无需官方 Claude.ai 订阅。

Q：AWS Bedrock 和 Cloudflare AI Gateway 哪个更适合我？
A：如果已有 AWS 账号且熟悉 AWS 控制台，推荐 Bedrock；如果已有 Anthropic API Key 并使用 Cloudflare，推荐 AI Gateway。两者都比直连更稳定，按实际情况选择即可。

Q：Claude Code 一次改了太多内容怎么办？
A：先按 Ctrl + C 停止，运行 git diff 查看改动。下次改用 Plan 模式先看计划，再决定是否放行；重要项目可用 Git 提交或备份回退。

Q：以后要重新开始吗？
A：不需要。进入同一个项目文件夹运行 claude -c 可以继续最近的对话；新任务直接重新运行 claude。

Q：Claude Code运行时频繁断连或触发风控？
A：Claude Code发起联网请求走本机底层网络，节点频繁切换会导致IP变动触发风控。建议在代理客户端规则中将 *.anthropic.com 及中转API域名设为强制代理，并在工作期间固定同一节点。

✅ 小结 ​

  1. 用官方安装脚本（或 npm、Homebrew）安装 Claude Code；
  2. 配置 AWS Bedrock 或 Cloudflare AI Gateway 的连接凭证，再运行 claude；
  3. 进入项目文件夹后再启动，先用 Default 或 Plan 模式熟悉权限确认流程；
  4. 按“先阅读、先计划、再修改、最后验证”的顺序使用；
  5. 每次都查看 git diff，确认无误后再发布。

📚 官方参考 ​

内容仅供学习与技术交流使用，采用 CC BY-NC-SA 4.0 许可协议。

© 网飞笔记