Claude Code macOS/Linux 安装指南

详细的 macOS/Linux 系统安装步骤,让您快速开始使用 Claude Code

8分钟
官方源安装
此过程使用 100% 官方源服务进行安装,确保您的技术设置与官方版本完全一致

系统要求

  • macOS/Linux: 无特定要求
  • Node.js: 20+ 版本

安装步骤

1

打开终端

使用 Cmd+Space 搜索 "Terminal" 或在应用程序 → 实用工具中找到终端

2

验证 Node.js 安装

检查是否已安装 Node.js。如果没有,请从 https://nodejs.org/en/download 下载

$ node -v
$ npm -v
3

卸载现有 Claude Code(如未安装可跳过)

$ npm uninstall -g @anthropic-ai/claude-code

安装官方版本

$ npm install -g @anthropic-ai/claude-code@1.0.80
5

配置 API 设置

创建 settings.json 文件来配置 API 端点:

$ vim ~/.claude/settings.json

添加以下内容:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "paste your API key here",
    "ANTHROPIC_BASE_URL": "https://api.aicodeditor.com",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "600000",
    "BASH_DEFAULT_TIMEOUT_MS": "600000",
    "BASH_MAX_TIMEOUT_MS": "600000",
    "MCP_TIMEOUT": "30000",
    "MCP_TOOL_TIMEOUT": "600000",
    "CLAUDE_API_TIMEOUT": "600000"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

验证安装

运行以下命令确认安装成功:

$ claude -v

如果显示版本号,则安装成功。

开始使用

安装完成后,您可以在任何项目目录中开始使用 Claude Code:

# 进入项目目录
$ cd your-project-folder
# 启动 Claude Code
$ claude

重要说明

使用 Opus 模型: 设置 CLAUDE_CODE_MAX_OUTPUT_TOKENS 为 32000 以获得最佳性能。

重启 Claude Code: 修改配置后,请重启 Claude Code 使更改生效。

进阶技巧

使用别名简化命令

在 ~/.bashrc 或 ~/.zshrc 中添加:

alias cc="claude"

项目特定配置

在项目根目录创建 .claude/settings.json

mkdir .claude && touch .claude/settings.json

故障排除

权限问题: 如果安装时遇到权限错误,可能需要使用 sudo 或配置 npm 全局目录。

Node.js 版本: 确保使用 Node.js 20+ 版本,可使用 nvm 管理多个 Node.js 版本。

环境变量: 如果命令不可用,检查 PATH 环境变量是否包含 npm 全局安装目录。

开始体验 Claude Code

使用我们的平台,轻松配置您的 Claude Code API 密钥