toolin.ai logo
toolin.ai
首页
AI工具
AI技能包
AI资讯
精选推文
AI提示词
提交AI工具提交
toolin.ai logo
toolin.ai

百万AI玩家的创作利器库,发现最佳AI工具组合,提升您的创作效率

AI工具961个
技能包11个
产品功能
  • AI工具
  • AI技能包
  • AI资讯
  • 精选推文
关于我们
  • 关于Toolin
  • 联系我们
  • 合作洽谈
  • 更新日志
关注我们
© 2025 toolin.ai. All rights reserved.
服务条款隐私政策

Claude Code 从零上手:国内用户保姆级安装教程

2026/04/20
·toolin小编

无需海外手机号和 Visa 卡,用国产模型也能跑 Claude Code。Mac 和 Windows 双平台完整安装流程,从安装框架到接入 GLM-5.1 全流程指引。

Claude Code 从零上手:国内用户保姆级安装教程
Claude Code 从零上手:国内用户保姆级安装教程
2026/04/20

Claude Code 从零上手:国内用户保姆级安装教程

无需海外手机号和 Visa 卡,用国产模型也能跑 Claude Code。Mac 和 Windows 双平台完整安装流程,从安装框架到接入 GLM-5.1 全流程指引。

开始前的准备第一步:安装 Claude Code 框架macOS 安装Windows 安装第二步:安装 CC Switch 接入国产模型macOS 安装 CC SwitchWindows 安装 CC Switch配置模型第三步:启动并配置 Claude Code第四步:编写 CLAUDE.md 配置文件常用操作常见问题
AI教程

Claude Code 是目前公认最强的 AI 编程 Agent 框架。很多人以为它必须配合 Claude 官方模型才能用,但实际上,Claude Code 本质是一个 Agent 框架,搭配任何模型都能运行。本文手把手教你从零安装 Claude Code,并用国产模型 GLM-5.1 接入,全程不需要海外手机号、Visa 卡,甚至不需要代理。

开始前的准备

  • 操作系统:macOS 或 Windows 均可
  • 网络:有代理最好,没有也能用(本文两种方案都覆盖)
  • 模型选择:推荐 GLM-5.1(国内效果最接近 Claude Opus 4.6),也可用 MiniMax M2.7 或 K2.5
  • 预计时间:30-60 分钟(视网速而定)
  • 成本:免费

第一步:安装 Claude Code 框架

macOS 安装

有代理的用户,打开终端,执行一行命令即可:

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

如果提示 PATH 未配置,按照提示执行输出的 echo 命令,然后运行 claude --version 验证安装。

Claude Code 安装成功提示

没有代理的用户,先安装 Homebrew:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完成后,将 Homebrew 加入 PATH(安装结束时会有提示),然后用 Homebrew 安装 Claude Code:

brew install --cask claude-code@latest

安装完成后输入 claude 即可看到启动界面。

macOS 通过 Homebrew 安装 Claude Code

Windows 安装

Windows 上 Claude Code 内部使用 Git Bash,所以必须先装 Git。

打开终端(任务栏搜索"终端"),执行:

winget install Git.Git

有代理的用户,Git 装好后执行:

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

没有代理的用户,使用 WinGet 安装:

winget install Anthropic.ClaudeCode

安装完成后在终端输入 claude 验证。

Windows 安装 Claude Code 成功

第二步:安装 CC Switch 接入国产模型

到这一步框架装好了,但还没有"大脑"。用 CC Switch 工具可以方便地接入国产模型并随时切换。

macOS 安装 CC Switch

brew tap farion1231/ccswitch
brew install --cask cc-switch

Windows 安装 CC Switch

前往 CC Switch Releases 页面 下载安装包,双击运行即可。

配置模型

打开 CC Switch,在 Claude 栏下点击右上角加号,新增模型配置:

  1. 选择目标模型(如 GLM 国内版)
  2. 填入你的 API Key
  3. 确认模型配置(大部分会自动填充)
  4. 点击添加

CC Switch 配置模型界面

配置完成后,CC Switch 会自动切换到新模型。

第三步:启动并配置 Claude Code

在终端输入 claude 启动。首次运行会有初始化设置:

  1. 选择主题:选你喜欢的颜色模式,之后可以用 /theme 修改
  2. 安全提示:确认了解 AI 可能犯错,建议审查生成的代码
  3. 终端设置:使用推荐的终端设置(快捷键换行 + 视觉提示)
  4. 信任目录:确认当前工作目录可信

Claude Code 初始化界面

提示:推荐使用 claude --dangerously-skip-permissions 启动,省去频繁点 allow 的麻烦。但请确保在可信的项目目录中使用。

第四步:编写 CLAUDE.md 配置文件

CLAUDE.md 是 Claude Code 的行为准则,分两层:

  • 全局级:放在 ~/.claude/CLAUDE.md,所有项目都会加载
  • 项目级:放在项目根目录的 CLAUDE.md,只在对应项目中生效

CLAUDE.md 分层结构

关键注意:CLAUDE.md 不要超过 80 行,超过 200 行 Claude 会忽略后半段内容。

以下是一份可直接复用的全局 CLAUDE.md 模板:

## 关于我
[你的名字 / 身份 / 职业背景,非程序员一定要写出来]
我用 Claude Code 做 [具体用途 1] 和 [具体用途 2]

## 思维原则
所有决策从问题本质出发,不因「惯例如此」照搬
不要谄媚,不要夸我的想法好,给我真实判断
发现更好的做法直接说,不用等我问

## 约束先行
新项目先写 CLAUDE.md,新目录先定结构约定
没有规范的工作空间不动手
需要调整规范时先改文档、再改实践

## 沟通方式
默认中文,代码和变量名用英文
结论先行,再给理由
遇到模糊需求,先给最合理的方案再问调整

## 自主边界(红线,必须先问我)
删除文件、目录或 git 历史
修改 .env、密钥、token、CI/CD 配置
git push、git rebase、git reset --hard
公开发布(npm publish、部署到生产等)

## 通用工程纪律
改完主动跑验证,不要只改不验
不要为了跑起来注释掉报错,找根本原因
密钥和 token 不进代码、不进 commit
大改动前先在 Plan Mode 出方案,确认后再动手

常用操作

  • 切换模型:在 Claude Code 中输入 /model 即可切换已配置的模型
  • 进入项目目录:cd 到目标文件夹后输入 claude 启动,这样上下文更聚焦
  • 项目级 CLAUDE.md:直接在项目中和 Claude Code 对话,让它帮你生成即可

常见问题

  • 安装后输入 claude 提示找不到命令:需要把安装路径加入 PATH,按安装结束时的提示执行对应命令
  • 没有 API Key 怎么办:到对应模型的开放平台注册账号并创建 Key,通常有免费额度
  • Windows 上安装失败:确保已安装 Git,且终端使用的是 PowerShell 或 Windows Terminal
所有文章

作者

avatar for toolin小编
toolin小编

分类

  • AI教程
开始前的准备第一步:安装 Claude Code 框架macOS 安装Windows 安装第二步:安装 CC Switch 接入国产模型macOS 安装 CC SwitchWindows 安装 CC Switch配置模型第三步:启动并配置 Claude Code第四步:编写 CLAUDE.md 配置文件常用操作常见问题

相关文章

AI短剧制作全流程实操指南
AI教程

AI短剧制作全流程实操指南

从剧本到成片,用豆包、小云雀、Vidu等工具零基础制作AI短剧,附工具对比和费用参考。

avatar for toolin小编
toolin小编
2天前
Claude Opus 4.7 深度解析
AI产品

Claude Opus 4.7 深度解析

Claude Opus 4.7在综合榜和代码榜同时登顶,长任务执行、工具调用稳定性大幅提升,更适合企业级生产环境。

avatar for toolin小编
toolin小编
2天前
Anthropic 负责人的 Vibe Coding 大师课
AI教程

Anthropic 负责人的 Vibe Coding 大师课

Anthropic 研究员 Erik Schluntz 分享生产环境中负责任地使用 Vibe Coding 的实战经验,涵盖 22000 行代码合并案例、叶子节点策略和进阶技巧。

avatar for toolin小编
toolin小编
1天前