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

Claude Code 安装指南:终端 AI 编程助手配置与使用

Anthropic 推出的终端 AI 编程工具 Claude Code 的安装流程。涵盖环境要求(Node.js 18+)、系统兼容性(macOS/Linux/Windows WSL),以及通过 npm 全局安装的步骤。详细说明了环境变量配置方法(ANTHROPIC_AUTH_TOKEN 等)及首次启动设置。包含常见问题排查指南,如 API Key 错误、离线状态及网络请求失败的处理方案。旨在帮助用户在本地终端高效集成 AI 辅助编程能力。

樱花落尽发布于 2026/4/6更新于 2026/9/1176 浏览

Claude Code 安装指南:终端 AI 编程助手配置与使用

Claude Code 是 Anthropic 推出的终端 AI 编程工具,支持在命令行中与 AI 结对编程。不同于传统的代码补全工具,它能理解整个项目上下文,协助编写功能、修复 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
node --version

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
claude --version
第三步:配置 API

Claude Code 需要配置以下环境变量:

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

Linux / macOS 设置:

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

Windows PowerShell:

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

Windows CMD:

cd 你的项目目录
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' 状态
工具会检测网络连接,若无法连接 Google 服务可能显示 offline,不影响核心功能使用。

请求一直 'fetch failed'
通常为网络问题,检查代理设置。尝试退出(Ctrl+C)后重新运行。

API 报错
可能是服务端不稳定,建议稍后重试。

使用体验

Claude Code 能理解整个项目上下文,可执行模块重构、文件修改等操作。作为终端工具,它与 Git 配合良好,可直接生成 commit message 或提交代码。

相关链接

  • Claude Code 官方文档
  • Node.js 官网

目录

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

更多推荐文章

查看全部
  • Unity 开发:VS Code 集成 AI 编程插件配置指南
  • Python 编程学习的 11 个实用技巧
  • 2026 年主流 AI Agent 产品完整梳理与选型指南
  • llama.cpp 性能基准库:参数调优与多场景测试指南
  • 用 Rokid 灵珠平台做一个 AI Glasses 作业助手
  • 算法设计与分析:贪心算法
  • Ubuntu 20.04 NVIDIA Tesla P40 驱动安装指南:核显与计算卡分离方案
  • 浙江省人民医院基于 KingbaseES 的多院区异构多活容灾架构实践
  • FastGPT 结合 MCP 协议构建工具增强型 AI Agent
  • ALEPython 机器学习模型解释与特征分析指南
  • C++中 memcpy 和赋值拷贝的核心区别
  • dbswitch 异构数据库迁移与同步工具
  • 基于 AI 辅助开发的在线图书借阅平台设计与实现
  • 基于 ClaudeCode 与 Figma-MCP 的 UI 设计前端还原方案
  • OpenClaw 与 Ollama 本地部署指南
  • RoboBrain2.0 具身大脑模型复现指南:统一感知推理与规划
  • MiniMax 海螺 AI 视频:图片与文本生成高质量视频
  • Spring Boot 优雅停机演进:原理与最佳实践
  • Seedance 2.0 提示词完全指南:从入门到精通
  • Spring Cloud Gateway 核心机制与高性能原理实战

相关免费在线工具

  • 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