{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"redocly_category":"Treasure Code","product_name":"Treasure Code","type":"markdown"},"seo":{"title":"tdx claude - Claude Code Integration | Treasure Data","description":"Launch Claude Code with TD LLM Proxy. Use AI Suite credits for AI-powered development with TD Skills.","siteUrl":"https://docs.treasuredata.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"image":"/assets/og-image.ba836864a30434f560a4f7720f8a09019ad30ff828b20c5052ae933ba7121524.d7ef4821.png"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"claude-code-integration","__idx":0},"children":["Claude Code Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Launch ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.anthropic.com/en/docs/claude-code"},"children":["Claude Code"]}," with Treasure AI's ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.treasuredata.com/products/customer-data-platform/ai-agent-foundry"},"children":["TD LLM Proxy"]}," as the backend."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure AI customers can use Claude Code with their existing ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.treasuredata.com/terms/ai-suite-credits-definition/"},"children":["AI Suite credits"]}," — no separate Claude subscription required."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"features","__idx":1},"children":["Features"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use Your Own TD Subscription"]}," - Run Claude Code using ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.treasuredata.com/terms/ai-suite-credits-definition/"},"children":["AI Suite credits"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Full Claude Code Features"]}," - Extended thinking, plan mode, subagents, and Opus model support"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["TD Documentation Search"]}," - AI-powered search across ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.treasuredata.com/getting-started"},"children":["Treasure AI documentation"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["TD Skills Integration"]}," - Enhanced with ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/treasure-code/guide/td-skills"},"children":["td-skills"]}," for writing SQL queries, workflows, and building user segments on CDP"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"architecture","__idx":2},"children":["Architecture"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart LR\n subgraph TDX[\"tdx claude\"]\n CC[\"Claude Code
• td-skills • td-docs MCP\"]\n Proxy[\"Local Proxy\"]\n end\n\n subgraph TD[Treasure AI]\n LLM[TD LLM Proxy]\n end\n\n CC <-->|/v1/messages| Proxy\n Proxy <-->|Anthropic API| LLM\n\n style TDX fill:transparent,stroke:#888\n style CC padding:10px\n","diagramHtml":"

Treasure AI

tdx claude

/v1/messages

Anthropic API

Claude Code
• td-skills • td-docs MCP

Local Proxy

TD LLM Proxy

","diagramHtmlDark":"

Treasure AI

tdx claude

/v1/messages

Anthropic API

Claude Code
• td-skills • td-docs MCP

Local Proxy

TD LLM Proxy

"},"children":["flowchart LR\n subgraph TDX[\"tdx claude\"]\n CC[\"Claude Code
• td-skills • td-docs MCP\"]\n Proxy[\"Local Proxy\"]\n end\n\n subgraph TD[Treasure AI]\n LLM[TD LLM Proxy]\n end\n\n CC <-->|/v1/messages| Proxy\n Proxy <-->|Anthropic API| LLM\n\n style TDX fill:transparent,stroke:#888\n style CC padding:10px\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you run ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx claude"]},":"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Starts a local pass-through proxy for TD LLM Proxy"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Launches Claude Code with ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/treasure-code/guide/td-skills"},"children":["td-skills"]}," and td-docs MCP pre-configured"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The proxy forwards Claude Code API requests (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/messages"]},") to TD's ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.treasuredata.com/products/customer-data-platform/ai-agent-foundry"},"children":["LLM Proxy"]},", which provides Anthropic-compatible API access to Claude models"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"usage","__idx":3},"children":["Usage"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx claude [options] [-- claude-options]\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"options","__idx":4},"children":["Options"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-c, --continue"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Continue most recent conversation"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-r, --resume"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Resume a conversation (shows selector)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--no-proxy"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use your own Claude Code account (Anthropic/AWS Bedrock/Vertex AI, etc.)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"examples","__idx":5},"children":["Examples"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Launch Claude Code with TD LLM Proxy\ntdx claude\n\n# Continue most recent conversation\ntdx claude -c\n\n# Resume a conversation (shows selector)\ntdx claude -r\n\n# Start with an initial prompt\ntdx claude -- \"Explain this code\"\n\n# Use your own Claude Code account with TD skills\ntdx claude --no-proxy\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-conversations","__idx":6},"children":["Example Conversations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once inside Claude Code, you can ask questions like:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"> How to set up data ingestion to TD from Snowflake?\n\n> How to add web access log collector in my web page?\n\n> Analyze mydb.user_events data\n\n> Write a workflow to periodically import data from S3\n\n> Create a SQL query to find top customers by revenue\n\n> Build a user segment for customers who purchased in the last 30 days\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":7},"children":["Requirements"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"install-claude-code","__idx":8},"children":["Install Claude Code"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://code.claude.com/docs/en/quickstart"},"children":["Claude Code Quick Start"]}," for installation instructions."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -fsSL https://claude.ai/install.sh | bash\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Minimum Version"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Claude Code ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["2.0.20 or later"]}," is required for td-skills support. Update with:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"claude update\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"other-requirements","__idx":9},"children":["Other Requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Valid TD API key with LLM access"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"subcommands","__idx":10},"children":["Subcommands"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"usage-1","__idx":11},"children":["usage"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Show AI Suite credit consumption statistics by profile."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx claude usage [options]\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--json"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Output as JSON"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--jsonl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Output as JSON Lines"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Display credit usage by profile\ntdx claude usage\n\n# JSON output for programmatic access\ntdx claude usage --json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"AI Suite Credit Usage Summary\n──────────────────────────────────────────────────\n Today: 0.24 credits\n Month: 2.15 credits\n Total: 10.45 credits\n\nUsage by Profile\n────────────────────────────────────────────────────────────\n Profile Credits Requests Last Used\n (default) 8.23 245 today 10:30 AM\n production 2.22 30 yesterday\n\nNote: Credit values are estimates based on token usage.\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"statusline","__idx":12},"children":["statusline"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Output credit usage for Claude Code's status bar. This is automatically configured when running ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx claude"]},". See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://code.claude.com/docs/en/statusline"},"children":["Claude Code Statusline Documentation"]}," for more details."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx claude statusline\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reads session info from stdin (JSON with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["session_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["model"]},") and outputs a formatted statusline."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--profile"]},", the statusline shows profile-specific today/month credits:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx --profile myprofile claude\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"🤖 tdx - Sonnet 4.5 | 🪙 credit: 0.12 session / 1.23 today / 10.45 month | 🧠 22,396 (11%)\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The statusline shows:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Current model name"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Session / Today / Month credits (estimates, filtered by profile when specified)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Context memory usage"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"learn-more","__idx":13},"children":["Learn More"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For generic Claude Code usage, refer to the official documentation:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://code.claude.com/docs"},"children":["Claude Code Documentation"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://anthropic.skilljar.com/claude-code-in-action"},"children":["Claude Code in Action (Tutorial)"]}]}]}]},"headings":[{"value":"Claude Code Integration","id":"claude-code-integration","depth":1},{"value":"Features","id":"features","depth":2},{"value":"Architecture","id":"architecture","depth":2},{"value":"Usage","id":"usage","depth":2},{"value":"Options","id":"options","depth":2},{"value":"Examples","id":"examples","depth":2},{"value":"Example Conversations","id":"example-conversations","depth":2},{"value":"Requirements","id":"requirements","depth":2},{"value":"Install Claude Code","id":"install-claude-code","depth":3},{"value":"Other Requirements","id":"other-requirements","depth":3},{"value":"Subcommands","id":"subcommands","depth":2},{"value":"usage","id":"usage-1","depth":3},{"value":"statusline","id":"statusline","depth":3},{"value":"Learn More","id":"learn-more","depth":2}],"frontmatter":{"seo":{"title":"tdx claude - Claude Code Integration | Treasure Data","description":"Launch Claude Code with TD LLM Proxy. Use AI Suite credits for AI-powered development with TD Skills.","image":"/assets/og-image.ba836864a30434f560a4f7720f8a09019ad30ff828b20c5052ae933ba7121524.d7ef4821.png"}},"lastModified":"2026-05-18T01:25:54.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/treasure-code/commands/claude","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}