claude-code

Claude Code 使用 ¶

篇幅有限，安装部分只放 macOS 的安装方法，其余请到官网查看

macOS 安装「推荐」¶

系统要求 • macOS 10.15 (Catalina) 或更高版本 • Node.js 18+ • 网络连接

安装 Homebrew (可选)

如果尚未安装 Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装 Node.js
1
brew install node
或从 Node.js 官网下载安装包
安装 Claude Code
1
npm install -g @claude-ai/claude-code
验证安装
1
claude --version
配置 API

注意：永久设置后需要重启终端才能生效。

方法一：使用 Bash（推荐）

echo 'export ANTHROPIC_AUTH_TOKEN="粘贴API-KEY"' >> ~/.bash_profile
echo 'export ANTHROPIC_BASE_URL="粘贴API网址"' >> ~/.bash_profile
source ~/.bash_profile

方法二：使用 Zsh（如果使用 Oh My Zsh）

echo 'export ANTHROPIC_AUTH_TOKEN="粘贴API-KEY"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="粘贴API网址"' >> ~/.zshrc
source ~/.zshrc

方法三：使用 setting.json 配置

配置文件位置：

Mac: ~/.claude/settings.json 或 .claude/settings.json
Windows: %USERPROFILE%\.claude\settings.json
Linux: ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "粘贴API-KEY",
    "ANTHROPIC_BASE_URL": "粘贴API网址",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  },
  "apiKeyHelper": "echo '粘贴API-KEY'"
}

启动 Claude Code

在当前目录打开终端

claude

Notice

首次启动后需要先进行主题的选择等操作：

选择喜欢的主题（回车）

确认安全须知（回车）

使用默认 Terminal 配置（回车）

信任工作目录（回车）

开始编程！🚀

常见问题 ¶

Q：显示 offline 是什么原因？

Claude Code 会通过检查是否能连接到 Google 来判断网络状态。显示 offline 并不影响正常使用，只是表明无法访问 Google（可能是网络环境限制）。

Q：Invalid API Key · Please run /login 怎么解决？

这表明 Claude Code 没有检测到环境变量。不要使用 /login 命令，只需参考上面的安装配置部分正确设置环境变量或 settings.json 文件即可。

Q：为什么浏览网页的 Fetch 会失败？

这是因为 Claude Code 在访问网页前会调用 Claude 官方服务来判断网页是否可访问。建议检查网络连接，必要时使用稳定的国际网络环境。

Q：如何退出 Claude Code？

按两次 Ctrl-C 或者两次 Ctrl-D 即可退出。

Q：如何更新 Claude Code？

输入命令更新： claude update

Q：出现 529、549 报错怎么解决？

建议：

稍等几分钟后重试
尝试切换到 Sonnet 模型（使用 /model 命令）

Q：API Error: Cannot read properties of undefined (reading 'filter') 报错？

这是网络连接不稳定导致的临时错误。建议：

检查网络连接稳定性
重新启动 Claude Code

Q：推荐使用哪个模型？

推荐使用 Sonnet 模型便宜且精准

claude-code

Claude Code 使用¶

macOS 安装「推荐」¶

常见问题¶

Claude Code 使用 ¶

常见问题 ¶