作为一个初学者的 Claude Code 配置踩坑记录

Ayeonnx
52 阅读3分钟

折腾了两天，踩了三个坑，在 AI 辅助下终于把 Claude Code 跑通了。这篇记录了我的完整配置过程和避坑方法，希望能帮到和我一样的初学者。

一、我为什么折腾这个

我是一名建筑室内设计专业的大专生，对电脑数码很感兴趣。最近在学习用 AI 辅助设计，听说 Claude Code 能让 AI 直接改代码、分析文件，就想试试。虽然全程有 AI 辅助，但中间也踩了不少坑，所以写篇文章记录一下，也希望能够帮到和我一样的人。

二、我的环境

  • Windows 10/11
  • 已安装 Node.js 和 Python
  • API 来源：DeepSeek 官方

三、踩坑记录与避坑方法

坑1：官方安装脚本报错

  • 现象：用官方的 irm ... | iex 命令安装，出现一堆看不懂的报错

  • 在这里插入图片描述

  • 原因：国内网络环境导致下载到了错误的内容

  • 解决办法：改用 npm 安装 npm install -g @anthropic-ai/claude-code

坑2：启动后连不上 Anthropic 服务

  • 现象：安装成功，但运行 claude 后提示 ERR_BAD_REQUEST

  • 在这里插入图片描述

  • 原因：需要配置第三方 API 中转

  • 解决办法：在 ~/.claude/settings.json 里配置 DeepSeek 的 API 信息

坑3：用 /v1 地址不兼容

  • 现象：模型报错“不存在或没有权限”

  • 在这里插入图片描述

  • 原因：/v1 地址只兼容 OpenAI 协议，Claude Code 说的是 Anthropic 语言

  • 解决办法：把地址改成 https://api.deepseek.com/anthropic

四、我的最终配置文件

{
  "env": {
      "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
      "ANTHROPIC_AUTH_TOKEN": "你的API-Key",
      "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
      "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
      "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash"
  }
}

|注意|:把你的API-Key 替换成你自己的，千万别把真实 Key 发出来！

五、总结与杂谈

大体看下来配置过程其实并不复杂(我在ai的辅助下)，主要是地址要写对，之所以用DeepSeek主要有两点,第一价格很便宜，第二我是学生党嘛>嗯....怎么说呢，作为一个非计算机专业的学生，能在 AI 辅助下完成这件事，挺有成就感的,配了两天，在终于跑通的那一刻我才真正体会到ai的强大之处.之前我只是在对话框里对ai进行询问,让他帮我提资料修改的意见等等

但这只是个开始，跑通之后，我才真正开始思考一个问题：怎么让 AI 记住我？

于是就诞生了一整套“AI 协作记忆系统”——包含项目规则书、工作日志、人性化协作启动指南。我把这套方案整理成了开源仓库，在后续文章我会专门写这套系统是怎么建出来的。

(本文同步自 CSDN，首次发布于一个初学者的 Claude Code 配置踩坑记录-CSDN博客

2026年5月12日补： 基于这次配置经验我后续整理了一整套"AI 协作记忆系统"，从规则书、工作日志到启动指南已全部开源在 GitHub：github.com/AYe1116/Cla…

后记:作为初学者,这篇文章有很多不足之处,在后面的写作与实践中我会不断的去学习和改善,也望各位对我进行指导与批评,我写文章的最大出发点是记录,如果有幸能够帮到您,我会非常开心

avatar
文章
阅读
粉丝