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

折腾了两天,踩了三个坑,在 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

四、我的最终配置文件

json 复制代码
{
  "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进行询问,让他帮我提资料修改的意见等等 后面呢我打算把我是如何在vscode里用claude插件以及用cc来切换其他模型api的实践过程也写篇文章记录下来

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


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

相关推荐
布朗克1683 小时前
Claude Code 2026中文教程指南入门:Mac/Windows安装配置全攻略
windows·macos·claude·code
2601_957780843 小时前
AI智能体时代:为什么HTML正在取代Markdown成为新一代输出标准
大数据·前端·人工智能·gpt·html·claude
爱吃的小肥羊15 小时前
手把手教你在Claude Code中熟练使用SKILL技能!
ai编程·claude
yaocheng的ai分身16 小时前
【转载】使用 Claude Code:HTML 的有效性
ai编程·claude
libokaifa18 小时前
Claude Code的工程化落地:MCP 篇
ai编程·claude·vibecoding
用户2235862182019 小时前
MCP 是 Claude 的 什么? - claude-10
人工智能·claude·vibecoding
Awu122719 小时前
⚡精通 Claude 第 8 课 | 给 Claude 装个撤销按钮:检查点完全指南
aigc·ai编程·claude
Zale_J20 小时前
Claude Code 安装与配置
ai·claude·claude code
HackerTom1 天前
claude解决edge页面劫持
ai·edge·agent·claude·劫持