(最新版)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

相关推荐
落羽的落羽2 小时前
【Linux系统】信号机制拆解,透过内核三张表深入本质
android·java·linux·服务器·c++·spring·机器学习
ONLYOFFICE2 小时前
ONLYOFFICE 全新 PDF 编辑器 API 上线,自动化处理 PDF 内容
前端·人工智能·pdf·编辑器·onlyoffice
徐小夕@趣谈前端2 小时前
借助AI,1周,0后端成本,我们开源了一款Office预览SDK
前端·人工智能·开源·node.js·编辑器·github·格式工厂
十年编程老舅2 小时前
Linux 内存爆满?分清泄漏与正常占用
linux·c++·内存·内存管理·内存泄漏·内存溢出
艾莉丝努力练剑2 小时前
【Linux:文件 + 进程】进程间通信进阶(2)
linux·运维·服务器·开发语言·网络·c++·ubuntu
Wizard7972 小时前
linux字符设备
linux
炘爚2 小时前
Linux 系统基础:体系、命令与 Vim 编辑器
linux·运维·服务器
墨染天姬3 小时前
【AI】linux-windows即将消亡,未来模型即系统
linux·人工智能·windows
我不听你讲话4 小时前
关系型与非关系型数据库视角下的 MySQL:特性解析与 Linux 部署实践
linux·mysql·nosql