跳到主要内容

Claude Code Mac 使用指南

推荐

建议使用 CC-Switch 可视化管理工具进行配置，无需手动编辑配置文件，一键完成 ByteCatCode 接入。

前置准备

请先完成 Node.js 环境安装，再继续以下步骤。

一、安装 Claude Code​

方法一（推荐）：curl 一键安装​

打开 Terminal，运行以下命令：

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

方法二：npm 安装​

打开 Terminal，运行以下命令：

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

如果遇到权限问题，可以使用 sudo：

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

验证 Claude Code 安装​

安装完成后，输入以下命令检查是否安装成功：

claude --version

如果显示版本号，恭喜你！Claude Code 已经成功安装了。

二、配置 Claude Code​

方法一（推荐）：通过文件设置​

编辑文件 ~/.claude/settings.json 文件添加以下内容（如果没有 settings.json 文件，请自行创建，不需要时可随意删除，不影响 claude 使用）：

macOS 系统中通常位于： ~/.claude

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://bytecat.lamclod.cn",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}
备选地址

如首选地址不可用，可替换为以下备选地址：

  • https://www.bytecatcode.org（优选CF，可直连，也可挂代理）
  • https://codecdn.bytecatcode.org（国内可直连）
  • https://code.bytecatcode.org（需挂代理访问）
备注

记得将 "你的API密钥" 替换为你的实际密钥。

方法二：通过环境变量设置​

临时设置（当前会话）

在 Terminal 中运行以下命令：

export ANTHROPIC_BASE_URL="https://bytecat.lamclod.cn"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

永久设置

编辑你的 shell 配置文件（根据你使用的 shell）：

对于 zsh（默认）：

echo 'export ANTHROPIC_BASE_URL="https://bytecat.lamclod.cn"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

对于 bash：

echo 'export ANTHROPIC_BASE_URL="https://bytecat.lamclod.cn"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bash_profile
source ~/.bash_profile

三、开始使用 Claude Code​

现在你可以开始使用 Claude Code 了！

启动 Claude Code：

claude

在特定项目中使用：

cd /path/to/your/project
claude

常见问题​

安装时提示权限错误​

尝试以下解决方法：

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

npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

macOS 安全设置阻止运行​

如果系统阻止运行 Claude Code：

  • 打开 "系统偏好设置" → "安全性与隐私"
  • 点击 "仍要打开" 或 "允许"
  • 或者在 Terminal 中运行：sudo spctl --master-disable

环境变量不生效​

检查以下几点：

  • 确认修改了正确的配置文件（.zshrc 或 .bash_profile）
  • 重新启动 Terminal
  • 验证设置：echo $ANTHROPIC_BASE_URL

🎉 恭喜你！

你已经成功安装并配置了 Claude Code，现在可以开始享受 AI 编程助手带来的便利了。

如果在使用过程中遇到任何问题，可以查看官方文档或社区讨论获取帮助。