Claude Code 介绍

Claude Code 是由Anthropic推出的终端式 AI 编程智能体。首次发布于2024年1月随后持续迭代，Computer Use 图形界面操控与等主要能力已在2025年6月加入。

它区别于传统 IDE 代码补全插件：主要形态是运行在本地终端的交互式智能助手。主打自主规划、多文件操作、工程全流程自动化，依托 Claude 大模型的长文本理解能力建立。按理说，

主要功能一览

• 全代码库理解: 一次性读懂整个项目结构、依赖与跨文件关系。新人接手百万行项目，仅需几分钟理清脉络。
• 多文件协同修改: 同时改路由、控制器、模型、配置、测试与文档；支持大规模重构如 Vue2→Vue3、JS→TS 等。
• 自主工程化执行: 支持终端命令（如 npm run dev。pytest,git checkout -b feat/xxx)，Git 全流程管理，还有自动跑用例、抓报错并修复。
• Computer Use: 在 macOS 上可直接启动 App、点击按钮、填表单并截图，实现端到端闭环自动化。
• MCP 协议集成: 与 GitHub、Jira、Linear、数据库及浏览器等外部工具无缝连接，可 插件环境。

Claude Code 安装配置

Windows 使用者快速安装

npm install -g @anthropic-ai/claude-code
# 若网络不佳，请使用国内镜像或代理
# npm config set registry https://registry.npmmirror.com
# 或者使用 cnpm / yarn 安装

Mac 使用者快速安装

sudo npm install -g https://gaccode.com/claudecode/install

验证安装成功

关闭所有旧终端窗口。开启新的 PowerShell / Terminal，接下来执行：

claude --version

如果返回“command not found”，请检查环境变量是否已刷新，或重新打开终端。

进入项目目录启动 Claude Code

cd /path/to/your_project
claude # 自动进入 Claude Code 界面

成功后会看到类似“欢迎使用 Claude Code”的提示；若没有，请确认当前目录包含有效代码库。不过，

常用命令速查

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

认证配置

OAuth 登录

claude auth login

claude auth status

claude auth login --console

国内环境下此流程往往因超时或失败而中断。建议跳过此步骤，直接使用 API Key 配置。

API Key 认证 – 永久生效方案

# 创建全局配置文件

mkdir -p ~/.claude && \
cat> ~/.claude/settings.json <'EOF'
{
    "env": {
        "ANTHROPICAUTHTOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"。"ANTHROPICBASEURL": "https://api.anthropic.com","ANTHROPIC_MODEL": "claude-v1"
}
}
EOF

将上述内容替换为你自己的 API Key 与模型名称即可。若公司提供了内部模型网站，只需将 URL 和 token 替换为对应值即可。

阿里云百炼

# 免费额度说明 阿里云百炼网站提供100万 token 免费三个月额度，可通过批量开启 “免费额度用完即停” 开关来避免误付费。按理说，再看设置方法，

mkdir -p ~/.claude && \
nano ~/.claude/settings.json # 打开编辑器

{ 再看"env"。{ "ANTHROPICBASEURL": "https://dashscope.aliyuncs.com/apps/anthropic","ANTHROPICAUTHTOKEN": "","ANTHROPIC_MODEL": "" } }

保存退出后重启 Claude Code，即可自动读取新配置。注意 Anthropic 协议要求 Base URL 必须为上述链接格式，否则会报错 “Invalid URL”。

CC‑Switch – 一键管理多模型

C‑Switch 是一款跨网站桌面工具，用来统一管理各种 AI 编程 CLI 的 API 配置与模型切换。一键完成，无需手动编辑 JSON 或环境变量。让你随时切换不同供应商与模型。

• Select 下载对应程序版本：Windows/Mac/Linux.
• 启动后界面示例：

• C‑Switch 内置多家主流供应商，你只需填写API Key 和 ANTHROPIC_BASE_URL 即可。其他默认保持即可，

更改完毕后重新打开 Claude Code 即可生效；若仍出现 “Invalid API key” 错误。请确认 key 是否已过期或被泄露，并在 C‑Switch 中切回其他模型再尝试。

& 接下来建议

• Your first hurdle is often network: Windows may hit slower installs while macOS may require elevated permissions.
• The biggest frustration comes from auntication failures – always use API Key over OAuth in China.
• A single global configuration file or a tool like C‑Switch can eliminate repetitive manual edits.
• The built‑in Computer Use feature unlocks end‑to‑end automation that saves hours of manual debugging.
• If you encounter any error messages。double‑check your PATH and Base URL settings.
• Tune your model choice based on your project size and budget—free trials on Alibaba Cloud or or providers can help you test before committing.
• Please keep an eye on updates from Anthropic: new MCP protocols or GUI features might arrive soon.

再看Tip，

Always open a fresh terminal after changing environment variables or config files—cached sessions will keep old values active until restarted.

---

©2026 Anthropic | 本页面仅供技术参考。

---