Claude Code国内最新最全使用教程:Windows保姆级安装指南

AgenticCoding·十二月创作之星挑战赛 10w+人浏览 295人参与

本篇教程为希望在国内使用 AI 编程神器 Claude Code 的开发者提供了终极解决方案。我们为您准备了覆盖 Windows操作系统的完整图文安装与配置指南,通过使用本网站,彻底解决了网络访问和API密钥获取难题。教程内容从环境准备、Node.js 安装,到详细的环境变量配置,再到启动使用、常用命令和高级技巧,手把手教您完成所有步骤,让您无需复杂操作即可免费、稳定地体验 Claude Code 强大的代码生成、审查和自动化能力,助您大幅提升开发效率。

📋 通用要求

  • Node.js 18+ (所有系统必需)
  • 网络连接 (访问 API站点)
  • 终端/命令行工具

🔑 Claude Code API 站点选择与配置详细说明

前往API站点注册账号,获取 Auth Token为例子,访问 API站点:注册账号后进行以下操作:

1.点击控制台 -> API令牌页面

2.点击"添加令牌"

3.令牌分组请选择:claudecode官转分组(务必选择此分组,否则无法使用)

4.复制令牌密钥,进行下一步操作


🪟 Windows 安装教程

系统要求

  • Windows 10 或 Windows 11
  • Node.js 18+
  • 网络连接

安装步骤

在正式安装前,您需要先安装 Git Bash:访问 Git 官网下载页面,选择适合您 Windows 系统的安装包,然后按照提示完成安装。Git Bash 将为您提供类似 Linux 的命令行环境,便于后续操作。

1. 安装 Node.js

访问 Node.js 官网 下载并安装最新 LTS 版本。

2. 安装 Claude Code

打开命令提示符(CMD)或 PowerShell,运行:

npm install -g @anthropic-ai/claude-code

3. 验证安装

claude --version

Windows 环境变量配置

重要提示:请将下方的 sk-xxx 替换为您在 本网站 生成的实际 API 密钥!

方法一:图形化配置(推荐,永久生效)

右键点击"此电脑" → 选择"属性"

点击"高级系统设置"

在"系统属性"窗口中点击"环境变量"

重要:在"系统变量"部分点击"新建"

  • 添加以下两个变量:
  • 变量名ANTHROPIC_AUTH_TOKEN变量值sk-xxx
  • 变量名ANTHROPIC_BASE_URL变量值:https://api.aigc.bar
  • 点击"确定"保存

重启终端

⭐设置完成后务必重启终端!!!

方法二:CMD临时设置

set ANTHROPIC_AUTH_TOKEN=sk-xxx
set ANTHROPIC_BASE_URL=https://api.aigc.bar

 启动和使用

基本启动

# 进入项目目录
cd your-project-folder

# 启动 Claude Code
claude

首次启动配置:

选择喜欢的主题(回车)

确认安全须知(回车)

使用默认 Terminal 配置(回车)

信任工作目录(回车)

开始编程!🚀

测试连接
$ 你是谁


📝 常用命令参考

基础命令

命令

功能

示例

claude

启动交互模式

claude

claude "task"

运行一次性任务

claude "fix the build error"

claude -p "query"

运行查询后退出

claude -p "explain this function"

claude -c

继续最近的对话

claude -c

claude -r

继续上一个对话

claude -r

claude commit

创建 Git 提交

claude commit

交互模式命令

命令

功能

/clear

清除对话历史记录

/help

显示可用命令

exitCtrl+C

退出 Claude Code

内置斜杠命令

命令

用途

/add-dir

添加额外的工作目录

/bug

报告错误

/clear

清除对话历史

/config

查看/修改配置

/cost

显示令牌使用统计

/doctor

检查安装健康状况

/help

获取使用帮助

/init

使用 CLAUDE.md 初始化项目

/login

切换 Anthropic 账户

/logout

登出账户

/mcp

管理 MCP 服务器连接

/memory

编辑 CLAUDE.md 内存文件

/model

选择或更改 AI 模型

/permissions

查看或更新权限

/review

请求代码审查

/status

查看账户和系统状态

/vim

进入 vim 模式


实战场景

1. 基础代码生成

# 启动交互模式
claude

# 在交互模式中输入需求
> 请帮我写一个 Python 函数,用于计算斐波那契数列

2. 代码审查和修复

# 一次性任务:修复构建错误
claude "fix the build error"

# 代码审查
claude -p "review this code for potential bugs and improvements"

3. 自动化 Git 操作

# 自动创建提交
claude commit

# 自动翻译并提交 PR
claude -p "If there are new text strings, translate them into French and raise a PR for @lang-fr-team to review"

4. 批量处理文件

# 处理单个文件
cat mycode.py | claude -p "Review this code for bugs"

# 批量处理多个文件
for file in *.js; do
    echo "Processing $file..."
    claude -p "Add JSDoc comments to this file:" < "$file" > "${file}.documented"
done

常见问题解决

问题排查指南

遇到问题时,请按照以下步骤进行排查:

API密钥配置:确保创建的密钥选择了无限额度,不限制模型,并选择了claudecode分组

登录冲突处理:如果之前登录过官方Claude Code,请输入/logout命令退出后重新登录。

环境变量检查:确认BASE_URL设置为api.aigc.bar,并验证环境变量配置成功(Windows用户需要重启终端)。

技术支持:如果按照上述步骤仍无法解决问题,请私信我获取技术支持帮助

模型切换:输入/model 可选择Claude最新模型 sonnet与opus。

上下文管理:遇到API返回400错误或reading 'filter'错误时,请使用/compact命令压缩上下文或开启新对话,这通常是因为上下文超过了Claude允许的最大上下文200K。

会话恢复:如果退出了Claude Code终端需要继续上次对话,请输入/resume命令。

📚 其他功能

CI/CD 集成示例

# .github/workflows/claude-review.yml
name: Claude Code Review
on: [pull_request]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Setup Node.js
        uses: actions/setup-node@v2
        with:
          node-version: '18'
      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code
      - name: Run Claude Review
        run: claude -p "Review this PR for potential issues"
        env:
          ANTHROPIC_AUTH_TOKEN: $ secrets.ANTHROPIC_AUTH_TOKEN 

SDK 集成示例

import anyio
from claude_code_sdk import query, ClaudeCodeOptions, Message

async def main():
    messages: list[Message] = []
    
    async for message in query(
        prompt="Write a haiku about foo.py",
        options=ClaudeCodeOptions(max_turns=3)
    ):
        messages.append(message)
    
    print(messages)

anyio.run(main)

🎉 恭喜! 您已完成 Claude Code 的完整安装配置。现在可以在任何操作系统上享受 AI 编程助手的强大功能!

💡 提示:建议将文件拖拽到对话框来上传文件或图片,让 Claude Code 更好地理解您的项目。

点我注册即可,不会的地方可以关注我并私信!

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

智算菩萨

欢迎阅读最新融合AI编程内容

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值