在 2026 年的今天，如果票选出地表最强的全自动 AI 编码智能体（Agent）框架，Anthropic 官方推出的 Claude Code 绝对稳坐头把交椅。它能够接管本地终端、自主阅读整个代码库、运行测试并自己修 Bug。

然而，Anthropic 官方对账号的管控极其严苛（天天封号、必须绑定海外信用卡和实名认证），让很多国内开发者望而却步。

其实，很多人不知道，Agent 产品一般由“Agent 框架 + 底层模型”两部分组成。Claude Code 本质上只是一个开源的终端交互框架，它不限制你接入什么脑子。我们完全可以接入API，无需科学上网，也彻底告别封号焦虑！

一、 Claude Code 安装避坑指南（Mac/Windows）

推荐的安装优先级为：原生脚本安装 > 系统包管理器安装 > npm 遗留安装。

1. Mac / Linux 环境安装

【有魔法的状态】直接打开终端，一行命令搞定：

Bash

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

💡 Mac 环境变量小坑： 安装完成后，如果提示 claude: command not found，说明它的安装路径未加入系统 PATH。请直接在终端追加运行以下命令并重启终端即可： echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

2. Windows 环境安装

Windows 内部是依托 Git Bash 来执行脚本命令的，所以在安装前，请务必确保你的电脑里已经安装了 Git。如果没装，请先在终端 PowerShell 中输入 winget install Git.Git 进行一键安装。

接下来，有魔法的话，就用指令： irm https://claude.ai/install.ps1 | iex 脚本。

但在 Windows 环境下，由于国内网络常态下的重定向，该命令极易把一个网页的 HTML 代码当成安装包下载下来，导致 PowerShell 报出漫天满屏的 “var” 关键字不支持 / 参数列表中缺少参量 的语法错误。

最稳妥的 Windows 安装方式是使用微软官方的包管理器（WinGet）：

PowerShell

winget install Anthropic.ClaudeCode

注：安装完成后，必须关闭当前的命令行窗口并重新开启一个全新的 PowerShell，否则会因为环境变量未刷新而读不到 claude 命令。

3. 内网/离线情况下的 NPM 降级安装

如果上述两种方式由于网络原因全部走不通，可以使用 npm 进行全局打包安装（需确保本地 Node.js 版本 ）：

Bash

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

二、 登陆或接入API，为 Agent 安上大脑

安装好框架后，直接在终端输入 claude，直接登录Claude帐号。如果没有魔法，国内网络会直接报 Unable to connect to Anthropic services（拒绝连接）。

为了让它连上我们自己的代理或第三方模型接口，我们有两种方法，一是直接下载CC Switch，让它帮我们改。二是手动修改它的两层配置文件。

一、CC siwitch安装

MAC的话直接在终端输入两行命令：

        1 brew tap farion1231/ccswitch

        2 brew install --cask cc-switch

Win的话推荐用点魔法直接下载安装包：https://github.com/farion1231/cc-switch/releases

装好之后，打开。点加号就能新增模型配置：

然后就可以填写API了。这里以魔芋AI平台为例子，因为是企业级平台，用着省心：

 获取 API 密钥

1. 点击前往 （支持手机号一键注册）魔芋AI大模型网关I全球大模型一站式调用及服务平台魔芋AI大模型聚合平台（大模型网关平台）专注于提供高效能、低成本的多品类 AI 模型服务，助力开发者和企业聚焦产品创新。https://www.moyu.info/register?aff=qBX9https://www.moyu.info/register?aff=qBX9

 2、注册成功后进入【令牌管理】
        

        3、模型广场上复制要使用的模型ID
        要配置moder ID时候要去模型广场复制名称

分组不同可以设置在令牌管理那选择

二、手动修改

Windows 用户的目标层级结构如下（Mac 用户同理，隐藏在 ~ 目录下）：

Plaintext

C:\Users\你的用户名\
├── .claude.json          <-- 用于跳过首次登录的新手引导
└── .claude\
    └── settings.json     <-- 用于配置自定义中转 API 和模型映射

1. 强行跳过 Onboarding 登录锁定

在你的用户总目录下，新建或编辑 .claude.json 文件，直接塞入以下配置：

JSON

{
  "hasCompletedOnboarding": true
}

写入这一行后，Claude Code 就会认为你已经是一位完成过官方认证的“老手”，不再强行在启动时跳转浏览器要求你登录 Anthropic 账号。

2. 配置自定义 API 路由与模型映射

接着，在用户总目录下的 .claude 文件夹内，新建一个 settings.json 文件（如果没有 .claude 文件夹则手动建一个）。将你的中转网关及 Key 写入其中：

JSON

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://你的自定义中转网关地址/v1"（如“https://www.moyu.info/v1"）
    "ANTHROPIC_AUTH_TOKEN": "你刚刚在魔芋平台生成的 sk-xxxx 密钥",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "ANTHROPIC_MODEL": "gpt-4o"（你想调用的模型，下同）, 
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-4o",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-4o"
  }
}

(注：上方的模型名称需要根据你所购买的第三方中转平台支持的特定名称进行映射绑定。)

配置完成后，重新在终端里输入 claude（推荐在开发时使用 claude --dangerously-skip-permissions 命令，可以自动略过各种繁琐的系统权限审批弹窗），你就能成功看到那只可爱的小螃蟹，正式宣告国内免账号白嫖成功！

三、 规矩大于天：如何定好你的 CLAUDE.md

学会干活后，千万不要直接裸奔。非程序员和高级架构师拉开差距的第一个习惯，就是“约束先行”。在你的项目根目录下，必须先建立一个 CLAUDE.md 文件。

这个文件是直接穿透进 Claude Code 灵魂里的“最高宪法”。只要你一启动，它就会强行读取并死死遵守里面的命名规范、技术栈约定以及沟通红线。以下分享一份精简实用的 CLAUDE.md 模板：

Markdown

## 1. 思维原则
- 所有决策从问题本质出发。回答要直奔主题，拒绝无意义的谄媚。
- 发现我的代码设计有问题直接指出来，给出真实判断，不用等我问。

## 2. 沟通与语言规范
- 默认使用中文进行交互阐述，但所有的代码、日志、变量名和命名分支必须统一使用英文。
- 结论先行，再给理由，严禁长篇大论铺垫废话。

## 3. 自主边界（红线：必须先问我）
- 即使在 auto-accept 模式下，涉及以下操作必须停下来弹窗请示：
  1. 删除任何本地文件、目录或 Git 历史记录。
  2. 修改 `.env` 配置文件或涉及任何密钥、Tokens。
  3. 执行 `git push --force` 强推等高风险操作。

## 4. 自动化工程纪律
- 每次修改完代码，必须主动自主运行本地测试验证，严禁只改不验。

四、 扩充军火库：从生态下载自动化技能（Skills）

Claude Code 强大的另一个精髓在于它可以无缝挂载 Skills（自定义技能/插件）。这就像给 AI 塞入了一本特定的执行食谱，当遇到对应任务时它会自动翻阅并完美调用。

除了官方自带的工具，你可以直接引入第三方开源社区或各大平台维护的高价值 Skills 库。例如，你想让 Claude Code 具备一键帮你自动把当前代码库生成精美 PPT 的能力，可以直接甩给它 GitHub 上的 Skill 链接一键安装：

Bash

# 1. 将第三方的插件市场源添加进本地
claude plugin marketplace add https://github.com/特定平台的skills仓库地址

# 2. 强制执行安装该技能
claude plugin install target-skills

安装成功后，你只需要在终端大白话命令它：“帮我针对当前项目生成一个技术分享 PPT”，Agent 就会自动激活该底层技能，有模有样地在你的本地工作空间内产出精美的演示文稿。

一键解开官方束缚，一个接口畅玩全球顶流算力。企业合规的安全平台，点击链接注册魔芋领取百万Tokens福利和多个大模型优惠吧！

魔芋AI大模型网关I全球大模型一站式调用及服务平台魔芋AI大模型聚合平台（大模型网关平台）专注于提供高效能、低成本的多品类 AI 模型服务，助力开发者和企业聚焦产品创新。https://www.moyu.info/register?aff=qBX9