跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
编程语言Node.jsAI

Claude Code 安装指南:终端 AI 编程助手

介绍 Claude Code 的安装步骤与环境要求。需 Node.js 18+,支持 macOS、Linux、Windows(WSL)。通过 npm 全局安装后配置环境变量(API Token 与 Base URL)。文章涵盖首次启动配置、常见问题排查及与 Git 配合的使用体验。

RefactorPro发布于 2026/4/6更新于 2026/10/21106 浏览

Claude Code 安装指南:终端 AI 编程助手

最近在终端里使用 Claude Code 进行结对编程。与 GitHub Copilot 不同,它不仅能补全代码,还能理解整个项目上下文,帮助编写功能、修复 Bug 或重构。

环境要求

  • Node.js 18.0 以上(推荐最新 LTS)
  • 系统:macOS、Linux、Windows(需要 WSL)

安装步骤

第一步:安装 Node.js

Ubuntu / Debian:

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs

macOS:

brew install node
node --version

未安装 Homebrew 请先安装:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
第二步:安装 Claude Code
npm install -g @anthropic-ai/claude-code
第三步:配置 API

Claude Code 需要配置两个环境变量:

配置项说明
ANTHROPIC_AUTH_TOKENAPI 密钥,sk- 开头
ANTHROPIC_BASE_URLAPI 地址

Linux / macOS 设置:

export ANTHROPIC_AUTH_TOKEN=sk-你的 token
export ANTHROPIC_BASE_URL=https://api.anthropic.com/v1
export API_TIMEOUT_MS=300000
claude

Windows PowerShell:

$env:ANTHROPIC_BASE_URL = "https://api.anthropic.com/v1"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的 token"
$env:API_TIMEOUT_MS = "300000"
claude

Windows CMD:

set ANTHROPIC_BASE_URL=https://api.anthropic.com/v1
set ANTHROPIC_AUTH_TOKEN=sk-你的 token
set API_TIMEOUT_MS=300000
claude
第四步:首次启动配置

启动后会有几个配置步骤:

  1. 选主题 → 选你喜欢的,回车
  2. 安全提示 → 确认,回车
  3. 终端配置 → 默认就行,回车
  4. 信任工作目录 → 确认,回车

常见问题

报错 'Invalid API Key · Please run /login' → 环境变量没设对,检查 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL → 如果是写在配置文件里的,重启终端再试

显示 'offline' 状态 → Claude Code 会检测 Google 连通性,连不上就显示 offline → 不影响正常使用,忽略就行

请求一直 'fetch failed' → 网络问题,检查代理设置 → 退出(Ctrl+C)重新运行 claude

API 报错 → 可能是转发服务不稳定,退出重试 → 持续报错的话等一会再试

使用体验

跟 Copilot 最大的区别是,Claude Code 能理解整个项目上下文。你可以跟它说'帮我把这个模块重构成 TypeScript',它会读完所有相关文件然后一次性改好。

而且因为是终端工具,跟 git 配合特别好。改完代码直接让它帮你写 commit message,甚至可以让它自己 commit。

相关链接

  • Claude Code 官方文档:https://docs.anthropic.com
  • Node.js 官网:https://nodejs.org

目录

  1. Claude Code 安装指南:终端 AI 编程助手
  2. 环境要求
  3. 安装步骤
  4. 第一步:安装 Node.js
  5. 第二步:安装 Claude Code
  6. 第三步:配置 API
  7. 第四步:首次启动配置
  8. 常见问题
  9. 使用体验
  10. 相关链接

更多推荐文章

查看全部
  • AI 进化四部曲:Agent、MCP、Skill 与 CLI 代表作品及里程碑
  • GitHub Copilot 在 VS Code 中无法使用的关键解决步骤
  • Python 开发者如何利用心理洞察突破 AI 需求预测局限
  • Meta-Llama-3-8B-Instruct 本地部署与对话全流程解析
  • 大厂 HR 揭秘:为什么年底才是找工作的黄金期
  • 高空长航时无人机热管理系统中抗辐照 MCU 的可靠性研究
  • SD-XL 1.0 Refiner 图像优化工具使用指南
  • 银河麒麟系统 Nginx Web 服务部署实战
  • 利用 AI 辅助开发 imToken 生态智能合约交互与监控脚本
  • 鸿蒙 NEXT WebView 套壳方案:解决文件上传与相机调用问题
  • 程序员为何需要了解 GPT 并掌握 AI 大模型构建技术
  • OpenClaw 中 web_search 与 web_fetch 最佳实践速查
  • Web3 学习:从 Bitcoin 到 Ethereum 智能合约
  • 绿联云 NAS 配置 WebDAV 实现公网访问
  • Qwen3-ASR-1.7B 实战案例:新闻发布会实时语音转写与关键人物发言提取
  • Java 大数据在智能家居环境监测与智能调节中的应用
  • openclaw-termux:将 OpenClaw AI Gateway 部署至 Android(含 App 与终端)
  • Python 文件操作详解:读写、序列化与路径管理
  • 2026 年机器人系统架构与核心技术路线解析
  • 华为防火墙 Web 配置 SSL 实现外网访问内网资源

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online