Claude Code的安装及配置

Claude Code 介绍

Claude Code 是Anthropic (主打安全对齐大模型、Claude 系列模型研发公司)推出的终端式 AI 编程智能体(Coding Agent) ,正式发布于 2025 年 3 月,后续持续迭代,2026 年新增 Computer Use 图形界面操控、MCP 工具协议等核心能力。

它区别于传统 IDE 代码补全插件,核心形态是运行在本地终端 的交互式智能助手,主打自主规划、多文件操作、工程全流程自动化,对标业界顶级编程 Agent,依托 Claude 大模型超强长文本理解能力打造。在 IT圈早已声名远扬,其核心能力如下

全代码库理解

  • 一次性读懂整个项目结构、依赖、跨文件关系。
  • 新人接手百万行项目,几分钟理清脉络Anthropic。

多文件协同修改

  • 一个需求同时改路由、控制器、模型、配置、测试、文档。
  • 大规模重构:Vue2→3、JS→TS、全局重命名函数等。

自主工程化执行

  • 终端命令:npm run devpytestgit checkout -b feat/xxx
  • Git 全流程:建分支、提交、推远程、生成 PR。
  • 测试与调试:自动跑用例、抓报错、定位根因、修复并验证。

Computer Use(2026 年 3 月重磅)

  • 直接操控电脑 GUI**(macOS 预览):启动 App、点击按钮、填表单、截图、调试布局。
  • 端到端闭环:写代码→编译→运行→测试→修复,全程自动化。

MCP 协议集成

  • 连 GitHub、Jira、Linear、数据库、浏览器等外部工具。
  • 可扩展插件生态。

Claude Code安装配置

Claude Coded的安装也是很方便,直接用可以命令行安装

Windows用户

bash 复制代码
npm install -g @anthropic-ai/claude-code

Mac用户:

arduino 复制代码
sudo npm install -g https://gaccode.com/claudecode/install

验证安装

关闭旧终端,新开 PowerShell

css 复制代码
claude --version

进入Claude Code界面

bash 复制代码
cd path/to/your_project
claude

出现如上界面就说明已经进入了Claude Code,可以去探索了

常见命令

命令 作用
/init 在项目根目录生成 CLAUDE.md 文件,用于定义项目级指令、上下文、规则、规范
/ask 向 Claude 提问(支持选中代码提问)
/edit 让 Claude 直接编辑、修改当前选中代码
/cmd 让 Claude 生成并执行终端命令
/clear 清空当前对话上下文
/new 开启全新对话会话
/diff 查看代码修改前后的对比差异
/help 查看 Claude 命令帮助文档
/model 切换使用的模型
/cancel 取消当前正在生成的回答

认证配置

OAuth 登录(适合有海外网络 + Claude 订阅)

国内通常超时 / 失败,不推荐

bash 复制代码
# 交互式登录
claude auth login

# 查看认证状态
claude auth status

# 退出登录
claude auth logout

# 控制台认证(v2.1.41+)
claude auth login --console

API Key 认证(推荐)

全局配置文件(永久生效,推荐)

bash 复制代码
mkdir -p ~/.claude 
cat > ~/.claude/settings.json << 'EOF' 
{ 
    "env": { 
        "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", 
        "ANTHROPIC_BASE_URL": "https://api.anthropic.com"
        ANTHROPIC_MODEL: "大模型名字"
     } 
}

因公司内部提供了一个模型平台,大家有一定的额度可以接入市面上的各种模型,也在公司实践过了,我在公司是通过配置环境变量来接入模型的,体验了各种模型,还是不错的。

阿里云百炼

目前国内很多大模型都是要收费的,但是他们也提供了免费的试用额度,比如阿里云百炼平台中有100万token免费三个月额度的活动,可以薅一薅羊毛

可以将右侧的 免费额度用完即停 开关批量开启,不开启的话,等用完对应的额度,就要付费了。

配置好自己的API Key

在配置模型的时候修改相关配置就可以了

先创建 / 打开配置目录:

bash 复制代码
mkdir -p ~/.claude 
nano ~/.claude/settings.json

写入以下内容

json 复制代码
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "your-api-key",
    "ANTHROPIC_MODEL": "大模型名"
  }
}

保存退出即可,重启 Claude Code 就会自动读取这个配置

因为Claude Code只支持Anthropic 协议,所以ANTHROPIC_BASE_URL 需要换成图中的链接,这个需要注意下,详情可看

CC-Switch

CC-Switch是一个开源的、跨平台的桌面工具,用来统一管理各种AI编程CLI(Claude Code、Codex、Gemini CLI等)的API配置与模型切换,一键搞定,不用手动改JSON/环境变量,有了这个工具,为我们切换模型提供了很多的便利,下载地址

根据需要下载对应的安装包

安装完后启动,界面如下

CC Switch 内置了很多主流模型供应商配置,可以进行添加

下面的只需要配置API KeyANTHROPIC_BASE_URL ,我用的是阿里云百炼 上面的信息,其他的配置项保持默认即可

想使用哪个模型,直接启用他即可

当我们切换模型后,要退出 Claude 再重新启动,就可以看到生效的是切换后的模型了

这样就使用了我刚才配置好的模型,有同事分享了他在Claude Code客户端用CC-Switch配置模型的方法,需要进行路由的配置

阿里云百炼这里也提供了接入的文档,感兴趣的可以去尝试下

最后

AI编程工具越来越多,功能也越来越丰富,大家可以多探索,多尝试

相关推荐
chuilab5 小时前
CodeGraph:让代码理解进入「索引时代」
ai编程
清水寺小和尚5 小时前
MCP 完整指南:从协议理解到自建 Server 再到 Agent 集成
agent·mcp
元思未来5 小时前
Hermes Agent 源码探秘 (9):实战案例 — 我是怎么用 Hermes 的
agent·源码阅读
Shirley~~5 小时前
figma Mcp
前端·ai编程
Zeeland6 小时前
我做了一个 Agent Team 协作平台——Rudder:让 Agent Team 在实践中成长
人工智能·ai·agent
ftpeak6 小时前
深入浅出 LoongSuite Python Agent:让你的 AI 应用「透明化」(下篇)
开发语言·人工智能·ai·ai编程·ai开发
蔡俊锋6 小时前
为Agent重新设计云:Vibe Coding背后的新基建
人工智能·ai编程
麦哲思科技任甲林6 小时前
从OSSP 到Harness:AI 时代的软件过程演进之路
ai编程·harness·skills设计·ossp·pdp