(最新版)Cluade code安装、部署教程-Mac

一、环境准备

1.1 检查 Node.js 环境

在终端中输入以下命令,检查 Node.js 是否已安装:

npm list -g --depth=0

预期结果:

  • 显示已安装的全局包列表(如下图所示)

  • 或者显示空列表(这也是正常的)

我的结果是:

这是我之前安装openclaw时候已经安装好Node.js

说明你的系统还没有安装 Node.js,请按照以下步骤操作:

  1. 访问 Node.js 安装教程

  2. 根据教程完成 Node.js 的安装

  3. 安装完成后,重新执行上述检查命令

  4. 如果不再提示错误,说明安装成功

二、安装 Claude Code

2.1 执行安装命令

在终端中运行以下命令:

npm install --global @anthropic-ai/claude-code@latest

2.2 处理权限问题

如果遇到 "permission denied" 权限错误,请使用管理员权限安装:

sudo npm i -g @anthropic-ai/claude-code@latest

安装好之后,输入claude ,如果出来版本号、Welcome,说明安装成功。

三、配置Claude code

4.1 打开配置目录

操作步骤:

  1. 在 Finder(访达)中按下快捷键:Command + Shift + G

  2. 在弹出的对话框中输入以下路径:

4.2 创建配置文件

如果目录中不存在 settings.json 文件,请手动创建一个。(可以下载工具)也可以用命令行

用 TextEdit(文本编辑)创建txt文件

  1. 打开 TextEdit(应用程序 → TextEdit,或用 Spotlight 搜索)。

  2. 在菜单栏选择 格式 → 转换为纯文本 (或快捷键 Shift + Command + T)。

  3. 输入内容(可以为空)。

  4. 点击 文件 → 存储 ,在"文件格式"选择 纯文本 (.txt),命名并保存。

提示 :如果你经常需要 .txt,可以在 TextEdit 偏好设置中将默认格式改为"纯文本"

📝 说明: settings.json 是 Claude Code 的主要配置文件,用于设置 API 中转地址、密钥以及其他高级选项(如 hooks、plugins 等)。

我用的命令行

4.3 编辑配置内容

将以下内容复制并粘贴到 settings.json 文件中:

复制代码

{ "env": { "ANTHROPIC_AUTH_TOKEN": "你的令牌", "ANTHROPIC_BASE_URL": "https://api.anyrouter.top/v1", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-5-20250929", "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-sonnet-4-5-20250929", "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5-20250929", "ANTHROPIC_MODEL": "claude-sonnet-4-5-20250929" }, "includeCoAuthoredBy": false }

这里我在终端用了vi文本,

  1. 终端输入命令vi setting.json

  2. 粘贴。输入冒号:,进入选择模型,然后输入wq, (写入后退出)

4.4 获取 API 令牌

操作步骤:

  1. 官方token需要有国外的visa卡、大陆暂时不支持

  2. 访问国内知名 API 中转站Any Router,支持 Claude、OpenAI 等接口聚合。注册后(https://anyrouter.top/),

  3. 创建一个新的令牌

  4. 复制生成的令牌

需编辑刚才的setting.json文件,将 API 调用地址改为 https://api.anyrouter.top/v1,密钥替换为平台生成的中转 Key

官方正规申请anthropic-token

三、国内获取的特殊方案与避坑指南

(一)网络与支付难题解决

1.合规网络访问:

国内直接访问 Anthropic 官网可能受限,建议使用合规的企业级代理服务(如 AWS 中国区合规代理、阿里云国际站加速节点),避免使用免费翻墙工具(存在账号封禁风险)。配置代理后,需在终端执行以下命令验证连通性:

复制代码

curl https://api.anthropic.com/v1/version

若返回含 "version" 字段的 JSON 数据,说明网络通畅。

2.无国际信用卡的替代支付:

  • 选择「虚拟信用卡」:通过 Wise、Depay 等平台申请虚拟卡,绑定国内银行卡充值后完成支付(注意选择支持国际支付的卡种)。

  • 第三方代充服务:选择口碑良好的科技服务商(如「AI 云服务」等),提供 Anthropic 账号邮箱后由其代充(需确认服务商资质,避免泄露账号信息)。

(二)第三方合规中转服务

部分国内平台与 Anthropic 达成合作,提供 API 中转服务,适合对网络稳定性要求高的开发者:

1.AnyRouter

国内知名 API 中转站,支持 Claude、OpenAI 等接口聚合。注册后(https://anyrouter.top/),完成实名认证即可获取中转 API Key,其优势在于:

  • 支持支付宝、微信支付充值;

  • 提供国内节点加速,降低网络延迟;

  • 新人注册赠送 100 美元体验额度(需关注官方活动)。

使用时需将 API 调用地址改为 https://api.anyrouter.top/v1,密钥替换为平台生成的中转 Key。

五、测试配置

5.1 启动 Claude Code

在终端中输入以下命令:

复制代码

claude

红色就是聊天框,就可以聊天,并使用模型啦。

但是在这里我旁边有个not logged in ,说明我没登录,不用理会,我们只需要配置环境就行

Invalid API Key · Please run /login 怎么解决?

这表明 Claude Code 没有检测到 ANTHROPIC_AUTH_TOKENANTHROPIC_BASE_URL 环境变量。不用 /login,只需设置环境变量即可。

5.2 验证功能

配置成功的标志:

  • 出现对话界面

  • 能够正常与 Claude 进行对话

  • 收到 Claude 的正常回复

Claude code 常见命令

6.1 基础命令

1.启动 Claude Code

  • claude

启动交互式对话界面,与 Claude 进行实时对话。

2.使用特定模型

  • claude --model claude-sonnet-4-5-20250929 "你的问题"

指定使用特定的 Claude 模型进行对话。

3.读取文件内容

  • claude --file /path/to/file.txt "分析这个文件"

  • claude -f /path/to/file.txt "分析这个文件"

将文件内容发送给 Claude 进行分析或处理。

4.处理多个文件

claude -f file1.py -f file2.py "帮我优化这些代码"

同时处理多个文件。

5.开始新会话

claude --new

claude -n

创建一个全新的对话会话,清除之前的上下文。

6.查看会话历史

claude --history

查看所有保存的对话会话记录。

删除会话历史

claude --clear-history

清除所有保存的会话历史记录 。

6.2 实用快捷命令

1.代码审查

claude -f main.py "帮我审查这段代码,找出潜在问题"

2.代码重构

claude -f old_code.js "帮我重构这段代码,提高可读性"

3.生成文档

claude -f app.py "为这个文件生成详细的API文档"

4.调试协助

claude -f buggy_code.py "这段代码报错了,帮我找出问题"

5.单元测试 生成

claude -f function.py "为这个函数生成完整的单元测试"

6.3 交互模式快捷键

当进入 claude 交互模式后,可以使用以下快捷键:

快捷键 功能

Ctrl + C 中断当前响应

Ctrl + D 退出 Claude Code

↑ / ↓ 浏览命令历史

Tab 自动补全(如果支持)

6.4 命令组合示例

1.分析项目代码

claude -f src/*.py "分析这个项目的代码结构并给出优化建议"

2.生成并执行代码

claude --code-execution "写一个计算斐波那契数列的Python脚本并运行"

3.多文件对比

claude -f version1.js -f version2.js "对比这两个版本的差异"

4.日常开发工作流

复制代码

1. 启动新会话 claude --new 2. 分析需求 claude "我需要实现一个用户登录功能,请帮我规划代码结构" 3. 生成代码 claude "根据刚才的规划,帮我生成Python Flask的登录代码"


上述内容是参考博主➕个人实际操作.

原文链接:https://blog.csdn.net/weixin_46211269/article/details/157588283

相关推荐
零涂毕业设计1 小时前
毕业设计模块开发-OLED显示屏(IIC协议0.96寸)STM32 ESP32 FPGA Linux驱动免费分享
linux·stm32·单片机·嵌入式·esp32·fpga·oled
tedcloud1231 小时前
OmniRoute怎么部署?开源AI模型路由平台Linux部署教程
linux·服务器·人工智能·开源·音视频
SakitamaX2 小时前
LVS(Linux Virtual Server)概念详解
linux·运维·lvs
小张同学a.2 小时前
Linux系统管理
linux·运维
阿龙的工作记录2 小时前
深入理解Linux设备驱动模型
linux·嵌入式硬件·工作记录
代码村新手3 小时前
Linux的基本指令
linux·运维·服务器
撩得Android一次心动5 小时前
Linux编程笔记3【个人用】
linux·笔记
OpenPomeloxCommunity5 小时前
3. Linux 同步机制之 spinlock 设计与实现(一):通用层
linux
●VON5 小时前
鸿蒙 PC Markdown 编辑器原生右键弹层兼容
安全·华为·编辑器·harmonyos·鸿蒙
念恒123065 小时前
网络基础
linux·网络·c++