Claude Code 安装与配置

Claude Code 是 Anthropic 提供的终端编程代理。本页介绍如何在 macOS 和 Windows 上安装，并通过 Anthropic 官方登录或 Ya Code 的 Anthropic 兼容接口完成认证。

一、准备工作

• macOS 10.15 或更高版本；或 Windows 10 1809 / Windows Server 2019 或更高版本。
• Windows 原生运行需要安装 Git for Windows。也可以在 WSL 中按 Linux 方式安装。
• 使用 Anthropic 服务时准备可登录的 Claude 账户；使用 Ya Code 时先创建访问密钥。两种认证方式不要混用。
• 安装命令和系统要求可能更新，执行前请查看 Claude Code 官方安装文档。

二、安装（macOS、Windows）

macOS

使用 Anthropic 推荐的原生安装器：

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

也可以使用 Homebrew：

brew install --cask claude-code

Windows

在 PowerShell 中运行官方安装器：

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

安装后若找不到 claude，请关闭并重新打开终端。企业设备如限制脚本执行，应让管理员审核安装脚本，而不是直接降低全局安全策略。

三、配置目录（macOS、Windows）

macOS

• 用户设置：~/.claude/settings.json
• 用户本地状态：~/.claude.json，由 Claude Code 管理，不应当作网关配置文件手工维护。
• 项目共享设置：<项目目录>/.claude/settings.json
• 项目本地设置：<项目目录>/.claude/settings.local.json

Windows

• 用户设置：%USERPROFILE%\.claude\settings.json
• 用户本地状态：%USERPROFILE%\.claude.json，由 Claude Code 管理。
• 项目共享设置：<项目目录>\.claude\settings.json
• 项目本地设置：<项目目录>\.claude\settings.local.json

用户目录不存在时可以手动创建。设置的作用域和优先级以 Claude Code 设置文档 为准；通过 CLAUDE_CONFIG_DIR 改过目录的用户应使用自定义位置。

四、配置文件示例

下面是连接 Ya Code 的用户级 settings.json 示例。请把占位值替换成自己的密钥，不要提交到 Git：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://yacode.xyz",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-yacode-key"
  }
}

如不希望密钥以明文写入 JSON，可只保留 ANTHROPIC_BASE_URL，并在启动前设置当前终端会话的令牌：

export ANTHROPIC_AUTH_TOKEN="sk-your-yacode-key"
claude

$env:ANTHROPIC_AUTH_TOKEN="sk-your-yacode-key"
claude

五、配置说明

• ANTHROPIC_BASE_URL 指向 Ya Code 根地址；Claude Code 会调用 Anthropic Messages 兼容接口。
• ANTHROPIC_AUTH_TOKEN 以 Bearer Token 方式发送 Ya Code 密钥。不要同时设置 ANTHROPIC_API_KEY，避免认证头冲突。
• 直接使用 Anthropic 官方服务时，不要设置上述 Ya Code 变量；运行 claude 并按提示登录。认证方式详见 Claude Code 认证文档。
• settings.json 是 JSON；项目共享文件适合团队通用设置，但密钥只能放在用户设置、环境变量或受控的密钥管理器中。

六、注意事项

• 示例中的 sk-your-yacode-key 只是占位符，不能直接使用，也不要在截图、日志或仓库中暴露真实密钥。
• 原生安装会自动更新。若命令或配置项随版本变化，以 Claude Code 官方文档 为准。
• 自定义网关是否可用取决于 Claude Code 版本及网关对 Anthropic Messages API 的兼容程度；遇到认证或模型错误时先运行 claude --version，再核对 Ya Code 当前支持的模型。
• Claude Code 能读取和修改当前项目文件。首次在陌生仓库运行前，请检查项目指令并确认授权范围。