适用 Windows / macOS / Linux，并包含 国内网络环境可用方案与常见问题排查。
Claude Code 是 Anthropic 官方的终端 AI 编程助手，可用于：写代码、解释代码、重构、生成脚本、审查 PR、运行测试、维护项目记忆（CLAUDE.md）等。
1）安装 Node.js（推荐 ≥ 18，建议用 LTS）
Claude Code 依赖 Node.js。推荐安装 Node.js LTS 版本。
Ubuntu / Debian
macOS（Homebrew）
Windows（推荐）
- 到 Node.js 官网下载安装 LTS
- 安装后在 PowerShell / CMD 执行：
2）安装 Claude Code（全局安装）
如果看到类似 的版本号，说明安装成功。
如果你用的是 macOS/Linux 且权限报错，可尝试：
或使用 管理 Node 避免 sudo（更推荐）。
方案 A（官方方式）：Anthropic API Key
如果你可以正常访问 Anthropic 官方并能付款，这是最稳妥的方式。
方案 B（国内常用）：第三方中转服务（示例：DKAPI）
提示：第三方中转服务并非官方，优点是国内更容易直连、可能有试用额度；缺点是安全、稳定性、隐私都取决于服务商。
基本步骤（通用，不强绑定某一家）
- 注册并登录中转平台
- 在控制台创建 API Token（一般以 开头）
- 记录 Token 与 Base URL（通常平台会提供类似 的地址）
Claude Code 通过环境变量读取 Token 与 API 地址：
- ：你的 API Key / Token
- ：第三方中转地址（如果用官方则通常不需要设置）
1）Linux / macOS：临时设置（仅当前终端有效）
2）Linux / macOS：永久设置（推荐）
bash 用户
zsh 用户（macOS 默认）
3）Windows：永久设置（推荐）
PowerShell（当前用户）
设置后请重新打开一个新的 PowerShell / 终端窗口再运行 Claude Code。
验证是否生效：
进入你的项目目录：
首次启动通常会出现交互式引导，包括：
- 选择主题（Theme）
- 确认安全提示
- 使用默认 Terminal 设置
- 信任当前工作目录（Trust current directory）
建议：只在可信项目里选择 Trust，避免在陌生目录中授权过多访问。
1）接入外部工具（MCP：模型上下文协议）
MCP 可以让 Claude Code 调用外部服务或工具，例如数据库、浏览器自动化等。
添加 MySQL（示例）
添加 Playwright（网页自动化）
提醒：MCP 工具可以访问你的系统/网络资源，务必只安装可信来源。
2）自定义团队快捷命令（项目共享）
在项目根目录创建：
示例：
之后你可以在 Claude Code 中快速调用这些命令（团队共享同一套流程非常方便）。
额外安全建议（强烈推荐加入教程里）：
- 不要把 Token 写进代码仓库（Git）
- 不要在 Claude 中粘贴生产密钥、数据库密码、客户数据
- 使用第三方中转时，只用于学习/非敏感项目
一条命令生成：
保存生成文件后运行（Python 示例）：
浏览器访问：
通常生成 + 运行速度非常快，成本视模型和输出长度而定。
Claude Code = 终端里的 Claude AI：写代码、重构、查文档、审查、测试一条龙；国内网络环境可通过官方或第三方中转接入使用。
- 补齐了 Windows 环境变量设置
- “国内免费”写得更稳妥：强调第三方风险，避免“保证永久免费”这种容易被打脸的描述
- 排版更适合公众号/博客（每段可直接复制）
- 多了 验证命令、常见错误排查、安全建议，减少读者踩坑
- 语言更中立、少广告感，更容易被转发和长期留存
如果你愿意，我还能继续帮你做两件事（不用你再写内容）：
- 把这篇教程改成 更适合公众号排版（含标题层级、提示框、表情符号风格统一）
- 给你附一份 “新手从 0 到跑通 Claude Code 的最短路径版（3 分钟版）”，适合放在开头作为 TL;DR。
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/226145.html