Claude Code 是由 Anthropic 公司推出的一款终端内置的 AI 编码智能体（Agentic Coding Tool），主要运行于终端环境，也可通过安装插件在 VS Code 等 IDE 中调用。其首个版本发布于 2025 年 5 月，而笔者直至 2026 年 2 月才在个人电脑上尝试使用，目的是处理一项此前从未接触过的云服务集成任务。实际使用体验令人惊叹——只需提供问题背景与目标要求，便可交由它自主探索，断断续续两天内便找到线索并完成集成代码的开发。本文将分享其安装与配置过程。

01. 安装

1.1 macOS 安装

在 macOS 上建议使用 Homebrew 安装，可利用 Homebrew 国内源，无需额外配置网络。直接在终端执行以下命令即可：

brew install --cask claude-code

1.2 Linux 安装

需在终端中开启代理，否则可能出现下载失败或不支持区域的错误。终端代理开启方式如下：

export http_proxy="http://<ip:port>"
export https_proxy="http://<ip:port>"
export all_proxy="socks5://<ip:port>"

可用以下命令测试出口是否为代理地址：

curl ifconfig.me

代理正常后，即可使用官方脚本进行安装：

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

安装完成后可在终端看到“✅ Installation complete!”提示。

1.3 Windows 安装

同样需要配置代理，然后在 cmd 窗口执行以下命令（因手头暂无个人 PC，未做安装测试）：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

02. 启动与配置

2.1 跳过登录配置

安装完成后，若直接在终端中运行 claude 命令，会出现登录页面，但其提供的三种登录方式在国内或被禁用或不易购买。因此，需先修改配置文件跳过登录配置。找到用户主目录下的 .claude.json 文件，具体路径如下：

• macOS / Linux: ~/.claude.json

• Windows: C:\Users\%USERNAME%\.claude.json

在 JSON 文件中增加一行：

{
  "hasCompletedOnboarding": true
}

2.2 配置国内模型

可使用新注册账号的免费额度，或购买最低档的 Code Plan 获取 api 地址和密钥，然后按以下格式在终端中配置环境变量（以阿里云 Code Plan 为例，近期有首月 7.9 元优惠，适合尝鲜）：

export ANTHROPIC_BASE_URL=https://coding.dashscope.aliyuncs.com/apps/anthropic
export ANTHROPIC_AUTH_TOKEN=API....
export ANTHROPIC_MODEL=glm-5

配置完成后，创建一个独立文件夹，在新创建的目录下执行 claude 命令即可。在提示符输入 /model 可查看当前使用的模型，确认已切换为自己配置的 glm-5 模型。

若在 macOS 或 Windows 上使用，可安装 CC Switch 工具进行图形化配置。
在 Linux 服务器上，则可使用 CC Router 通过命令行方式进行 API 管理。

03. 总结

至此，Claude Code 的安装与国产模型配置便已完成。接下来即可让 Claude Code 协助实现需求。相较于传统的聊天窗口，Agent 的作用在于：对话结束后，它能对结果进行验证、测试判断，直至得到最终成果。

本文内容仅供个人学习、研究或参考使用，不构成任何形式的决策建议、专业指导或法律依据。未经授权，禁止任何单位或个人以商业售卖、虚假宣传、侵权传播等非学习研究目的使用本文内容。如需分享或转载，请保留原文来源信息，不得篡改、删减内容或侵犯相关权益。感谢您的理解与支持！

链接: https://fly63.com/article/detial/13464